CLAUDE.md git:20260930.23947e6A

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

# 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.
- `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 for those roles, and
  `.claude/skills/` the merge-train and retro procedures.