Context: #10 added collision-safe file-scoped requirement IDs, but the generated AGENTS_MD_SECTION in src/init.ts still instructs agents only in the legacy ### REQ-NNN.M grammar.
Source: deferred item in the final dual-review triage: #10 (comment)
Why deferred: The PR was scoped to the specified parser, annotation, migration, and README behavior; changing generated repository instructions was identified during adversarial review and left for a focused follow-up.
Implementation outline:
- Update
AGENTS_MD_SECTION to document both grammars and recommend file-scoped IDs where concurrent authorship is plausible.
- Refresh this repository's generated
AGENTS.md content.
- Add or update tests that pin the generated guidance.
Context: #10 added collision-safe file-scoped requirement IDs, but the generated
AGENTS_MD_SECTIONinsrc/init.tsstill instructs agents only in the legacy### REQ-NNN.Mgrammar.Source: deferred item in the final dual-review triage: #10 (comment)
Why deferred: The PR was scoped to the specified parser, annotation, migration, and README behavior; changing generated repository instructions was identified during adversarial review and left for a focused follow-up.
Implementation outline:
AGENTS_MD_SECTIONto document both grammars and recommend file-scoped IDs where concurrent authorship is plausible.AGENTS.mdcontent.