Architecture
Documentation & Metadata
Code Map
A generated CODEMAP.md that says what each area of the repository is for and which local README to open next — a navigation guide, not a reference.
CODEMAP.md
2Trait
Self-documenting
Its documentation is derived from the thing itself, so the two cannot drift.
Convention
Documentation & Metadata
Decision Records
Architecture decision records are a last resort, written only when the repository’s structure, code, tests, and owner documentation cannot make a choice clear.
docs/pdlc/decisions/
2Convention
Documentation & Metadata
Owner Documentation
Conventions are described beside the thing that owns them — a directory’s layout in its own README, a command’s behaviour in its module or script.
<area>/README.md
4Convention
Environment & Tooling
Self-Documenting Help
make help is generated from ## comments on the targets themselves, so the list of commands cannot drift from the real ones.
scripts/build/
1No specification matches every filter.