git:20260930.3d48af3 to git:20261001.e894751

7 added, 7 removed. Audit A to A.

# CLAUDE.md

- The contract is [AGENTS.md](AGENTS.md); read it before writing code, starting

- with its "Recurring defect shapes". Claude Code does not load AGENTS.md

- automatically, so this file carries only what a Claude session needs before

- that read, plus the Claude-specific assets.

+ 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.

- `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`; `.claude/agents/` holds the Claude

- agent definitions for those roles, and `.claude/skills/` the retro

- procedure; the merge policy is `docs/pi-lens-merge-policy.md`.

+ - 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.