2026-10-27 — The product thinker ruled on 2026-10-27 that each abcd command's behaviour is written once, in its command page, which agents follow when they run it. The brief's chapter for the command keeps why the command exists, its trade-offs and why it refuses what it does, with its sub-verb table and generated appendix, and points to the command page for behaviour. The documentation-fidelity check moves to the command pages. This reverses the behaviour half of adr-2609231028044006 and invariant 18, so a superseding ADR is owed.

Frontmatter

.abcd/work/decisions/dcn-2610271112339516-the-product-thinker-ruled-on-2026-10-27.md
open on GitHub ↗ · commit history ↗

mentions48

• adr-2609231028044006Shape claims in the brief's surface chapters are derived, never hand-authored
• adr-2610290238168123The brief states the design and why; each command's page states what abcd does, once, and is the copy checked against the code
• iss-2610262030262031The press release says disembark pack runs three agent passes; the disembark chapter says pack is one deterministic run with no model passes
• iss-2610262030276998The press release's embark criterion promises an interview, a brief README and memory/docs/terminology; the embark chapter has no interview and writes only record families and the marker block
• iss-2610262030422370The mental model's default discipline route is plan or reclassify from drafts/; the intent chapter's reclassify refuses any move into disciplines/
• iss-261026203118863704-scope defines what has shipped by the intents in shipped/ and the derived release, phases being history; 03-out-of-scope still frames the brief around eight planned phases and defines what has shipped by which phases are complete.
• iss-2610262031419126The naming register reserves `/abcd:audit` for itd-16's formal-verification surface, but itd-85 takes `abcd audit` for a repo-conformance check.
• iss-2610262031429165The mental model retires the phase and the milestone, but itd-41 builds a negotiator that proposes phases and their Phase Acceptance under adr-9.
• iss-2610262031532231itd-7 has disembark's pre-pack step write .abcd/rp/workspace.json into the repository being read; invariant 6 says disembark never writes to the source.
• iss-2610262032223832Ahoy's preparation reads the brief, principles, ADRs and intents from the plugin root; launch says the plugin payload never ships the .abcd/ record
• iss-2610262032437661ahoy says the user-scope ~/.abcd.noindex/memory/ resolves nothing today; 07-memory has the prompt hook querying the index of both the repo and the user memory scope
• iss-2610262032556158itd-106 has abcd switch on auto-deletion of merged branches; ahoy says abcd only mirrors the repository's merge-hygiene settings and never sets them
• iss-2610262033075573itd-7 relies on disembark running dev-sync before the pack and writing a workspace file into the repo; the disembark chapter has no such step and never writes to the source
• iss-261026203322851105-intent's cut rewrites every passed target_release to next, so 09-reflect's list of a cut release's unshipped targeted intents is always empty.
• iss-2610262033299542The record page names closing the spec as a READY planned intent's next move; the build chapter makes READY the state from which an intent is built.
• iss-2610262033418681The intent chapter says itd-to-spc link drift warns and never blocks; the verification matrix says the same disagreement is a blocker that refuses to lint.
• iss-2610262033567089itd-1 says plan's acceptance-criteria refusal is a record-lint hard block; the intent surface says it is the intent package's own check, not internal/core/lint
• iss-2610262033578037itd-190 makes a present-but-empty Mechanism section a readiness-gate fault; the intent template says a blank section passes the readiness gate with the nullity recorded
• iss-2610262033588599itd-81 requires judge agents, intent-auditor named first, to emit binary verdicts; the intent surface has intent-auditor emit four-valued per-criterion verdicts
• iss-2610262034151413itd-85 names `abcd audit` as the repository-conformance check; the intent chapter says the conformance check is `abcd lint` and reserves `/abcd:audit` for hash-chain checks.
• iss-2610262034220886itd-41 proposes ordered phases with Milestone and Phase Acceptance sections; the intent chapter says phases are retired.
• iss-2610262034333292The intent chapter keeps an UNACHIEVABLE intent in shipped/ and calls a drafts/ move a lifecycle break; itd-50 rules that unachievable reopens the intent to drafts.
• iss-2610262034360121itd-7 builds its workspace pull on dev-sync, a pre-pack step it says is already in the brief; the board chapter says no dev-sync verb or code exists anywhere.
• iss-2610262035195318The docs chapter has the spec close refuse without a saved docs review for HEAD, but the build chapter's unattended landing runs that close with no stage that records one
• iss-2610262035265656The docs chapter ships the itd-60 doc-fidelity gate, saving receipts keyed by commit; universal patterns calls the itd-60 pass a draft that is not yet built, keyed by input fingerprint.
• iss-2610262036113224The history chapter puts the transcript corpus under ~/.abcd.noindex/transcripts/ and keeps ~/.abcd.noindex/history/ for ahoy's registry, holding no transcripts; itd-59 places the corpus at ~/.abcd.noindex/history/< root_sha>/.
• iss-2610262036142715The lint chapter reserves /abcd:audit for itd-16's hash-chain fidelity surface and calls the conformance check abcd lint; itd-85, the intent the chapter cites, ships that same check as abcd audit.
• iss-2610262036146367itd-86 defines the cold reading as one target document read against its own constraints; the reading chapter's detection position reads the shipped tree against the claim record, assembled at a commit from an include table.
• iss-2610262036171679itd-44 has capture write an ADR as adr-< next-free>-< slug>.md; the decide chapter mints ADR ids from a timestamp that reads no maximum, and names the file < stamp>-< slug>.md.
• iss-2610262037016704The memory internals chapter homes keyword-recalled personal and project memory in ~/.abcd.noindex/memory/ and .abcd/memory/; the memory verb homes the same in two memory.json layers.
• iss-2610262037018200The loop glossary says abcd never owns the run loop; the build chapter ships abcd's own implement loop.
• iss-2610262038299872The glossary makes "memory" an alias of memory note; the configuration chapter says unqualified "memory" means the repo-scope `.abcd/memory/` page store.
• iss-2610262038415713itd-5 keeps the candidate on a tie and says length is no tiebreak; 05-prompt-quality accepts a rewrite that ties and is more than 10% shorter
• iss-2610262038495354itd-37 says Role 1 boilerplate detection runs at plan-review and ship time; 01-agents says the auditor's modification-grammar output is deferred and in no prompt or lint
• iss-2610262039253719The oracle-routing intent sends a step to a configured provider that can serve its tier, but the adapters page says a tier alone never reaches a provider
• iss-2610262039297157The configuration chapter stages itd-50's audit loop as a per-intent frontmatter mode, while itd-50 rules that the loop is build's last stage for every intent, not a per-intent mode
• iss-2610262040221402The memory chapter makes the in-tree repository store memory's primary home; the glossary says a memory note stays on the person's machine until it is promoted.
• iss-2610262040575327The glossary says signing off a dependency is never the technical facilitator's; the Terminal-interview intent records the technical facilitator signing one off.
• iss-2610262042222565itd-94 has the agent run `abcd intent plan` as the person's sign-off; the plan entry has the human run it and says it is never inferred from consent.
• iss-2610262042244924The audit verb is the hash-chain umbrella in itd-16 and a repo-conformance check in itd-85
• iss-2610262042332488itd-1 puts Acceptance Criteria in the discipline template; itd-190 says the discipline template carries no claim sections
• iss-2610262043106501The brief-realisation draft treats the brief as the target design in the present tense; itd-147 sequences the brief as the shipped state.
• iss-2610262043520946The dashboard intent limits the record site to abcd's own record; the record-pages intent builds a record site for every project that opts in
• iss-2610262043535279The build loop arms auto-merge whenever the ruleset gates through a queue; the facilitator-mode intent says that by default abcd never arms or queues a pull request
• iss-2610262044170732The design-fiction draft adds a format flag to intent new, which the verb consolidation removed
• iss-2610262044347395Two records build and publish a managed project's record site at each release by different routes: the shipped provider adapter, and the planned GitHub Pages route
• iss-2610262044454212itd-57 holds a spec back through a native spec dependency that the selector already honours; the native spec store shipped by itd-80 has no dependencies between specs
• itd-2610290239150589The brief reads as the design and why, and each command's behaviour is written once, in the page agents follow