This is the record of an abcd-managed repository

abcdBetav0.16.2 · 2026-11-06

Development record

plan

corestableplan

Unqualified, plan is the verb: abcd intent plan <itd-N>. The invocation is the product thinker's sign-off on an intent's acceptance criteria — never run unattended, never inferred from consent. It mints the spec stub, links intent and spec, stamps an identity onto every unmarked scope condition, and moves the record drafts/ → planned/. The surface page is commands/intent.md; the rule it serves is that no implementation begins without a planned, specced intent.

Senses

Three live senses share the word. The glossary fixes the bare form for the verb and requires a qualifier on the other two (iss-2609012245352480). A fourth, the build plan, retired with the phase (adr-2609212115255771): the order of work is dependencies plus the lifecycle shelves, and the row below is kept so the phase documents still read.

Sense The one spelling Where it lives
The sign-off act that mints a spec and moves an intent to planned/ plan, bare, or abcd intent plan commands/intent.md, 04-surfaces/05-intent.md
Retired: the ordered sequence of phases the project built in the build plan (history) roadmap/README.md, which calls the phase docs "the ordered build plan"
One dated design or implementation document, YYYY-MM-DD-*.md a design plan (the plans/ family) development/plans/
The per-intent summary a host session writes before the planning interview a planning brief .abcd/.work.local/scratch/planning-briefs/, described in commands/intent.md

The state and the act carry the same word, deliberately. An intent in planned/ is one the verb has moved there, so "planned" as a lifecycle bucket and "plan" as the act are one sense, not two.

Where the record disagrees. The draft intent itd-41 uses "plan" for a proposed ordering — "presents it as a proposal to edit or reject — not as a committed plan" — which is the build-plan sense used of something not yet committed to. The glossary reads that as the build-plan sense, qualified; it is not a fifth meaning.

When to use

Use bare "plan" only for the intent verb and its sign-off. Qualify every other use: "the build plan", "a design plan", "a planning brief".

When NOT to use

Do not use "plan" for a spec — the spec is what plan mints, and it is the design record the build works against. Do not use it for the order of work, which is dependencies plus the lifecycle shelves (record families), and do not use it as a synonym for a schedule or an estimate: abcd's records carry no dates for future work.

Examples

  • "abcd intent ready itd-N exits 1, so the intent cannot be implemented; offer the planning interview and let the human run plan."
  • "The host wrote a planning brief before the planning interview, and the product thinker ran plan after it."
  • "The design plan for the Go rebuild is a dated document under development/plans/."
  • record families — the one page that maps the record families and how they relate
  • intent — what plan acts on
  • spec — what plan mints
  • phase: the retired sequencing unit the build plan ordered
  • roadmap: the retired folder name the build plan lived under

Frontmatter

termplan
bounded_contextcore
statusstable
aliasesintent plan, planning sign-off
definitionThe product thinker's sign-off act `abcd intent plan <itd-N>`, which mints a spec, links both sides and moves a draft intent to planned/. Two further senses share the word, a dated design plan under development/plans/ and a session's planning brief, and each is qualified where it appears.