Development record
one-page-in-the-glossary-maps-abcd-s-record-families-and-how
specclosedspc-2609212131112235
Summary
The design record for itd-2609211913453478: the record-families page, the three retirements and the lint, from the vocabulary rulings of 2026-09-21 (adr-2609212115255771).
Scope
- The page
glossary/core/record-families.md, a table with the seven families and a prose paragraph per axis (lifecycle; position);glossary/core/README.mdindexes it first (criterion 1). - Superseded entries:
phase.md,roadmap.mdsetstatus: superseded,superseded_bynaming the page and the successor; amilestone.mdentry is added in the superseded state, since the word had only lived as a forbidden synonym;roadmap/README.mdandroadmap/phases/README.mdopen with the retirement line (criterion 2). - New entries
bundle.md,step.mdfrom the template,status: stable; the page's batch row (criterion 3). - The lint:
glossary_termsgains the two checks beside the existing entry-shape check (criterion 4). - The brief:
01-product/03-mental-model.mdrewritten to the three layers plus steps, bundle and release; the surface chapters that say "phase" repointed (criterion 5).
Out of scope
- Renames; itd-78; the release press release.
Approach
Prose and one lint rule; the lint reads the page's table as the closed set of families. The retirement lines are one sentence each pointing at the decision record.
Footprint
- packages: internal/core/lint (glossary_terms), .abcd/development/brief/glossary, .abcd/development/brief/01-product
- tests: the two lint checks over fixtures; the page's table parsed; the superseded entries' status
How the criteria are satisfied
| Criterion | Where |
|---|---|
| 1 the page | scope 1 |
| 2 superseded with successors | scope 2 |
| 3 bundle, step, batch | scope 3 |
| 4 the lint | scope 4 |
| 5 the brief and adr-9 | scope 5 |
Frontmatter
| id | spc-2609212131112235 |
|---|---|
| type | spec |
| lifecycle | closed |
.abcd/development/specs/closed/spc-2609212131112235-one-page-in-the-glossary-maps-abcd-s.md
open on GitHub ↗ · commit history ↗
References1
- itd-2609211913453478One page maps the record families, and phase, milestone and roadmap are retiredimplements
mentions4
- adr-9Phase as a product-reflection layer between brief and intent
- adr-2609212115255771Phases and milestones are retired: sequencing is dependencies rendered as status, the checkpoint is the derived release
- itd-78abcd Knows What to Build First — Even When It's Something Small
- spc-2609230613206890Glossary pointers, the family lint and the mental model