CLAUDE.md · git:20260930.ae2c87d · 2026-09-30 · sha256 32aad4c1d3727621

CLAUDE.md git:20260930.ae2c87dA

Immutable. This exact content never changes and is served at /api/v1/blob/32aad4c1d3727621.

<!-- ADD:BEGIN — managed by the ADD installer; do not edit inside -->
## ADD — how to work in this repo

This project uses **ADD (AI-Driven Development)**: the AI plans, builds and verifies; the human
owns direction and reviews the result. There is no CLI. The method is one skill file
(`.claude/skills/add/SKILL.md`), run with files, git and the project's own test command.

**Orient first, every session:** read `.add/PROJECT.md` (`goal:`, `invariants:`, `test_cmd:`),
then the open task and milestone files under `.add/tasks/` and `.add/milestones/` (any `status:`
that is not `done` or `dropped`), and the last few commits. Resume an open task; otherwise size
the work.

**Size the work. You route and go; the human reviews after.**

| the request | lane | what persists |
|---|---|---|
| mechanical, or a small behavior: ≤3 adjacent files, one sitting, no unknowns | Quick | a red→green test + one commit |
| one behavior worth a written contract | Task | `.add/tasks/<slug>.md` + its commits |
| the answer IS the deliverable: investigate · evaluate · research | Explore | the task's `## FINDINGS` |
| a theme, or more than one task | Milestone | `.add/milestones/<slug>.md` + its tasks |

Floor: anything touching security · data · architecture, or a surface other code consumes, is at
least a Task. When in doubt, size up.

Then follow the skill: Direction (rules · assumptions · failing checks, sealed by a
`freeze(<slug>)` commit) → Build (to green, sealed files untouched) → Verify (seal intact · fresh
green run · residue review · verdict in `## EVIDENCE`, committed as `verify(<slug>): <verdict>`).

Rules that bind: the `invariants:` in PROJECT.md hold for every change, Quick included. Never
weaken a sealed check or edit the contract to get green; changed intent is a visible
`refreeze(<slug>)` commit. A security finding is a HARD-STOP verdict, flagged at the top of the
report.

Book: https://pilotspace.github.io/ADD/. Edit outside the markers.
<!-- ADD:END -->