git:20261001.e894751 to git:20261014.668c1b6

2 added, 1 removed. Audit A to A.

# CLAUDE.md

Read the engineering principles (in your global instructions; vendored at

`docs/engineering-principles.md`), then the contract, [AGENTS.md](AGENTS.md),

starting with its "Recurring defect shapes". Claude Code does not load

AGENTS.md automatically; this file carries only what precedes that read.

- - `npm run build` before any test run; tests execute the compiled twins.

+ - `npm run build` before any test run; tests execute the compiled twins

+ (`npm run build:dist` too for the census files that read `dist/`).

- `scripts/hooks/guard-bash.mjs` (`PreToolUse`) denies `git stash`, hook

bypasses, and the rest of AGENTS.md "Contributing". Fix the command; never

route around it.

- Role contracts are `docs/pi-lens-*.md`, the only home of role rules;

`.claude/agents/` holds thin Claude wrappers, `.claude/skills/` the retro

procedure, and `docs/pi-lens-merge-policy.md` the merge policy.