BOOK v0.2 CONTRACTS v0.1.0 PROFILE-JWM v0.6 SNAPSHOT 2026-07-18

AI-Driven. Physics-Based. Trusted.
A living reference architecture.

jBOK is the organization-neutral blueprint for decision ecosystems where AI and simulation carry real consequences — built on one conviction: trust is earned.

§1

Why it exists

High-consequence decisions increasingly run through AI models and physics simulation. What's missing isn't capability — it's an architecture of trust: shared contracts that let independent organizations build interoperable capabilities, prove claims with evidence, and replace any component without unwinding the whole. jBOK is that architecture, kept deliberately free of every vendor, product, and use case so it can serve all of them.

§2

The structure

Trusted Decision EcosystemsTHE PUBLIC NARRATIVE
AI-DrivenAgents and learned models as first-class, contract-bounded participants
Physics-BasedGoverning equations and simulation as the grounding of claims about the world
TrustedVVUQ, accreditation by identified authority, evidence packages, human authority boundaries
Computational & Mathematical FoundationsApplied math · numerical methods · optimization · UQ · control · information theory · scientific ML · formal verification — the bedrock beneath all three pillars, never a fourth pillar
FIG. 1 — THREE PILLARS ON BEDROCK (ADR-0001)
§3

What it protects against

Vendor lock-in

Every capability sits behind six versioned interface-contract families (ADR-0005), each with a versioned JSON Schema and executed conformance tests. Adaptable by Design: replaceability behind stable interfaces is the testable floor; governed adaptation within validity envelopes is the goal.

Silent assumptions

Model contracts classify every parameter's origin — down to hand tuning without an external anchor and undischarged assumption. Disclosure is legitimate; disguise is a contract violation. Absence of a declaration never reads as confidence (ADR-0006).

Unaccountable automation

Accreditation is a use-specific decision by an identified authority, with recorded basis, conditions, and revocation triggers. Runtime assurance means monitoring plus an assured intervention path. Human authority boundaries stay explicit.

Decay and drift

An RFC-style living document: versioned chapters, appendices, and specs; seven ADRs guarding narrative and taxonomy; five review gates; 30 executed conformance tests in CI. External research is incorporated fully attributed and severable — replaceable as the field moves.

§4

The one-way rule

use case ─→ jBOK   jBOK ─→ use case

Use cases, products, and organizations reference the architecture. The architecture references none of them back. One implementation profile — JWM — is documented as evidence, and the book can never depend on it.

§5

The living loop

jBOK doesn't just describe architecture — it metabolizes implementation experience.

BuildAn implementation realizes the architecture in the world
ProfileFindings land in a versioned implementation profile — evidence, deviations, gaps
ClassifyEach lesson is profile evidence — or a candidate pattern that genuinely generalizes
GeneralizePatterns that survive review enter the contracts through an ADR, implementation-neutral
└─ stronger contracts flow back to every future implementation ─┘
LOOP CLOSED: ONCE

ADR-0006 (parameter provenance & completeness) was generalized from JWM's PROV-0 register — the profile is the origin of, and first conformance data point for, that contract language.

§6

The book, by the numbers

8Chapters
11Appendices A–K
7ADRs
5Contract specs
30Conformance tests
1Impl. profile (v0.6)
5Review gates
15PRs merged
§7

Design philosophy

Principle evolution is governed by ADR-0007. Terminal values are durable, not frozen — mechanisms adapt continuously under evidence; the values themselves are revised only by human insight, deliberately, through an ADR.