Make the reading order explicit
This repository chooses AGENTS.md as the stable first file for coding agents to read before they touch code. The filename is part of this repository's operating contract, not a GNU Make convention or a claim that every repository uses the same entry point.
The entry file names the root, language, and area convention layers so instructions can scale without one giant document.
That pattern supports the core course: Make, shell, and toolchain rules can live beside the code they govern while still sharing root prose and version-control rules.
AGENTS.md:1-16
11 focused lines
Keep each convention about one concept
The guide also defines how to compose convention files: one concept per file, singular names, and sections for facets of that concept.
That gives documentation the same modular shape as the Make graph. A later lesson can add a language layer without rewriting the root contract.
AGENTS.md:18-32
11 focused lines
docs/conventions/comment.md:1-14
9 focused lines