CLAUDE.md · diff

git:20260721.e6b7149 to git:20260723.98af8cb

15 added, 17 removed. Audit A to A.

## ADD — how to work in this repo

- This project uses **ADD (AI-Driven Development)**: you, the AI, drive the build;

- the human owns direction and verification. The loop below works for any agent —

- Claude, Cursor, Copilot, Codex — through the CLI alone. Before you change code:

+ **ADD (AI-Driven Development)** — you, the AI, drive the build; the human owns direction

+ and verification. Works for any agent (Claude · Cursor · Copilot · Codex) through the CLI

+ alone. Before you change code, orient:

1. `python3 .add/tooling/add.py status` — the resume point; read it first each session.

- 2. `.add/PROJECT.md` — the foundation (domain · spec · UI/UX) every task builds on.

- 3. `python3 .add/tooling/add.py guide` — it names the phase + its guide file; work ONLY that phase.

+ 2. `.add/PROJECT.md` — the read-first foundation (goal · invariants · pointers into `.add/specs/`, the 5-DD standing picture).

+ 3. `python3 .add/tooling/add.py guide` — names the current phase + its guide; work ONLY that phase.

- The flow: INTAKE sizes a request into a milestone; each task runs the **specification bundle**

- (Spec+Scenarios+Contract+Tests) — ONE human approval at the frozen contract — then a

- self-driving build→verify run. Non-negotiable for every agent: Never weaken a test or edit a frozen contract

- to make a build pass; a security finding is always HARD-STOP — never auto-passed.

- PROJECT.md `invariants:` (run/entry contracts) bind EVERY task: the artifact must hold under

- the BARE declared runtime — a dependency that breaks it is a defect, never "expected".

+ Flow: INTAKE sizes a request into a milestone; each task drafts the **specification bundle**

+ (Spec · Contract · Tests & Scenarios) to ONE human approval at the frozen contract, then a

+ self-driving build→verify run. Non-negotiable: Never weaken a test or edit a frozen contract

+ to pass a build; a security finding is always HARD-STOP. PROJECT.md `invariants:` bind EVERY

+ task — the artifact must hold under the BARE declared runtime.

- Roster (from `add-method/agents/*.md`): TWO agents — `add-worker` runs each EXECUTION beat

- (the spawn names it: direction · build · verify · persona), and `add-advisor` is the second

- mind it spawns to propose a plan, pressure-test a draft, or decide a delegable ambiguity so

- the beat never stalls. Each loads that beat's phase guide plus the best-fit `.add/personas/`

- persona (personas carry the expertise, the agent carries the discipline; the floor binds both).

+ Roster (`add-method/agents/*.md`): `add-worker` runs each execution beat (direction · build ·

+ verify · persona) and `add-advisor` is the second mind it spawns to plan, pressure-test, or

+ resolve a delegable ambiguity. Each loads the beat's phase guide + the best-fit `.add/personas/`

+ persona — personas carry the expertise, the agent carries the discipline.

- On Claude Code the `add` skill drives this loop; other agents follow the three steps. Book: https://pilotspace.github.io/ADD/. This block is generated by `add.py sync-guidelines` — edit outside the markers.

+ On Claude Code the `add` skill drives this loop; other agents follow the three steps. Book: https://pilotspace.github.io/ADD/. Generated by `add.py sync-guidelines` — edit outside the markers.