Agent docs

ADR index

Every recorded decision, one line each.

Decisions with their alternatives, so they are not relitigated by the next reader. Same shape as versable-builder/docs/adr/. Numbering is this tree's own; where a decision here depends on a versable-builder ADR, it says so.

ADRDecisionStatus
001-standalone-modules.mdone runner implementation, many module deployments; not one runner with every capability registeredaccepted 2026-08-17
002-machine-identity-issuer.mdapp-to-module identity is verified via a JWKS or a per-module key table behind one verifier port; who mints is multi-contender (A validate, B plan, C under contract, D rejected, E later)accepted 2026-08-17, amended 2026-08-18
003-composability-supported-not-built.mdmanifest, requires/provides, variants in the contract now; the composer is not built until a second workflow shape needs it; standalone always worksaccepted 2026-08-17
004-confidence-source-is-open.mdoutcomes carry confidence + judged_by; self-report is the default, never the lock-in; judges are capabilities that can run in the module, standalone, or in the appaccepted 2026-08-17
005-mvps-are-evidence.mdspeedway and walmart-mvp are witnesses, not migration targetsaccepted 2026-08-17
006-module-is-one-capability-and-input-on-the-wire.mda module is one capability by default (variants and judges included); the per-item wire field is inputaccepted 2026-08-18
@versable-git/ui · reference, canon, and method, read in place