Development record
docs-lint roots are docs/ and README.md only, so .abcd/** — the largest public surface — is scanned by no name gate; retire-the-name's banned_tokens cannot reach CONTRIBUTING.md, AGENTS.md, or scripts/ either
issueresolvedminoriss-279
docs-lint roots are docs/ and README.md only, so .abcd/** — the largest public surface — is scanned by no name gate; retire-the-name's banned_tokens cannot reach CONTRIBUTING.md, AGENTS.md, or scripts/ either
Grounds
- pursued: a names/ ban placed in AGENTS.md, a script, or a record under .abcd is reported by docs lint while non-name tokens stay confined to the roots; a name ban passing in one of those trees would show it wrong
Frontmatter
| id | iss-279 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | minor |
.abcd/work/issues/resolved/iss-279-docs-lint-roots-are-docs-and-readme-md.md
open on GitHub ↗ · commit history ↗
mentions2
- iss-2608211146222734The retired pre-adr-30 path literal 'roadmap/intents' — a record-lint blocker token (moved-intents-path: 'intents live at intents/') — survived in AGENTS.md and .abcd/README.md, the two canonical where-things-live maps, both outside record-lint's roots (.abcd/development) so the armed token is structurally blind to them. Read in context beside the real nested path decisions/adrs, the slash reads as a path separator, i.e. the banned pre-adr-30 layout. A 2026-07-06 review already adjudicated both sites stale (fix #6). CLAUDE.md is a symlink to AGENTS.md, so the line is injected into every agent session and risks an agent propagating the banned path into development/ where it is a live blocker. Live instance of open iss-279's detector gap (banned_tokens cannot reach AGENTS.md/CONTRIBUTING.md).
- iss-2608271804494611everything under .abcd/work/ sits under no lint root: record-lint's root is .abcd/development and docs-lint's roots are docs and README.md, so the issue ledger, the reviews charter, rulesets/, DECISIONS.md, the .abcd root config files, the plugin trees, and every root prose file except README.md are gated by nothing — which means structural fixes in those areas can silently regress. iss-279 and iss-2608230752354928 capture two slices (docs-lint roots; relative links under work/); this record is the umbrella: decide the lint-root coverage for the working tier and root prose, or record why they stay ungated.