Development record
An intent can declare its mechanism claim and its scope conditions
Context
An intent's press release commits to an outcome, and its acceptance criteria commit to a verifiable bar — but nothing in the shape asks why the authors expect the mechanism to work, or under what conditions the claim holds. The gap shows up downstream: when a shipped intent underdelivers, the audit can compare promise to delivery but not expectation to mechanism, because the expectation was never written; and when a capability is reused outside the conditions its design assumed, nothing recorded says the assumption existed. The brief-creation interview design surfaced both: an elicited claim arrives with grounds ("we expect this to work because…") and with boundaries ("this holds while…"), and the intent shape had nowhere to put either.
Decision
The intent shape gains two optional sections, documented in the
/abcd:intent surface page:
## Mechanism— the mechanism claim: why the authors expect this to work, stated as a falsifiable expectation ("we expect X because Y"), not a restatement of the outcome.## Scope Conditions— the conditions under which the intent's claim holds: the population, platform, scale, or assumptions the design leans on, so a reuse outside them is a visible re-decision rather than a silent stretch.
Both sections are optional and unenforced. Whether either is ever
required — for every intent, for severity: major intents, at the planning
gate — is a discipline question, explicitly deferred; if enforcement comes,
it arrives as its own record on the itd-84/itd-1 pattern (a rule with a
staged gate), not as a side effect of this ADR.
Alternatives Considered
- Fold mechanism into "Why This Matters". Rejected: that section argues value, not mechanism; blending them lets an intent argue importance while staying silent on why the approach should work.
- Require the sections immediately. Rejected: a required section with no calibrated reviewer becomes boilerplate; itd-84's promotion ladder shows the order that works — shape first, discipline after evidence.
- A separate record family for mechanism claims. Rejected: the claim is the intent's own, and adr-30's information architecture routes a feature-scoped statement to the feature's record, not a parallel store.
Consequences
- The surface page's template gains both sections with their one-line contracts; existing intents are untouched (optional means absent is valid).
- The intent audit (promise vs delivered) gains material when the sections are present: a delivered-but-mechanism-refuted outcome becomes expressible.
- The interview (itd-142) gets a committed destination for elicited grounds and boundaries at intent capture.
- Enforcement, if it ever comes, is a later, separate decision with its own evidence.
Frontmatter
| id | adr-51 |
|---|---|
| type | adr |
| status | accepted |
| date | 2026-08-22 |
.abcd/development/decisions/adrs/0051-intents-declare-mechanism-and-scope.md
open on GitHub ↗ · commit history ↗
References3
- adr-2Three intent kinds (standalone / bundle-member / discipline)related
- adr-30Design-record information architecture — flat artefact-type foldersrelated
- itd-142The brief-creation interview: abcd elicits a repository's brief in a staged conversation — narrative first, then frontier rounds that ask only what the record cannot yet settle, options at conjectural questions (at most three candidate construals, a ceiling not a target, with a null answer always available), and a per-item confirmation — distilling committed products into the brief and a ledger while the transcript is discarded. Entry is one door for both modes: a brownfield repository arrives pre-populated from embark probe coverage, provenance-stamped and still requiring confirmation; a greenfield repository is the same interview run from the all-blank coverage state. Command-shaped, because it mutates state — abcd ships zero skillsrelated
Referenced by1
- adr-55The construal stands in the record; its history does notrelated
mentions5
- dcn-26082200000000072026-08-22 — Interview-workstream records filed (the 2026-08-22 handover's
- itd-1Every Intent Has Acceptance Criteria; Every Audit Verifies Them
- itd-84An Intent Is Decomposed Before It Is Filed, And A Reversal Is Only Ever Flagged
- itd-177An intent's claims are typed and its scope conditions keep their identity across edits — the readiness gate refuses an intent that leaves a context claim unrecorded
- spc-55Claim typing and scope-condition identity