A repository template for agent-driven projects. It ships four things:
AGENTS.md(symlinked asCLAUDE.md) — the operative rules agents load every session: global rules and act-time triggers, each backed by a decision record.docs/decisions/— the decision log (ADRs) behind those rules: the founding0000-record-decisions-as-adrs.md, plus prepackaged defaults grouped by topic:project-organization/,ai-behavior/,code/,version-control/. The folder'sREADME.mdis its contract.Makefile—make format,make lint, andmake testas the canonical task entry points, with one shipped check (expiredTEMP(YYYY-MM-DD)markers failmake lint) and its tests..github/workflows/ci.yml— CI that runs the samemake lintandmake testentry points on every pull request and push tomain, so "passes locally" and "passes in CI" cannot diverge.
- Clone it (or "Use this template" on GitHub).
- Wire your stack into the Makefile targets as it takes shape; keep the TEMP-marker check.
- Record your project's first decision as
docs/decisions/0001-<short-slug>.mdand surface its rule inAGENTS.md.