# Project Rules
Generated by @hivehub/rulebook (lean). Regenerated by `rulebook update` — put project
overrides in `AGENTS.override.md` (user-owned, wins on conflict). Detail lives in
`/.rulebook/specs/`; read a spec when — and only when — the work touches its area.
## Rules
1. **Quality gates**: per commit, type-check + lint + tests covering the change;
per push/PR/archive, the full suite — all green. Never bypass hooks; the
project's pre-commit/pre-push wiring is the floor.
2. **Complete implementations only** — no stubs, no TODO/FIXME markers, no partial
work. Finish, or explain concretely why you can't.
3. **Destructive git ops require explicit user authorization**: `reset --hard`,
`checkout -- .` / `restore .`, `clean -f`, `push --force`, `rebase`, `stash`,
`branch -D`, branch switching. Always fine: status, diff, log, blame, add, commit.
4. **No deletion without authorization** — never `rm`/`del` without an explicit user
"yes, delete it".
5. **Root causes, not workarounds** — research before implementing; never guess at bug
causes or API behavior.
6. **Surgical, simple diffs** — touch only what the task needs; the least code that
solves the problem; match existing style; state assumptions instead of picking
silently.
7. **Multi-session work is tracked as Rulebook tasks** (`.rulebook/tasks/`, managed via
the `rulebook` MCP/CLI). Checklist order expresses dependencies — independent items
may run in parallel. Small fixes need no task ceremony.
8. **Docs in English.** Root allows only README/CHANGELOG/AGENTS/LICENSE/CONTRIBUTING/
SECURITY — everything else in `/docs`. Analyses: `docs/analysis/<slug>/`, numbered
files, one theme per file.
9. **Orchestration is the model's choice** — subagents, parallelism, and teams are
never blocked and never mandated.
## Task format (full spec: `/.rulebook/specs/rulebook.md`)
`.rulebook/tasks/<task-id>/` → `proposal.md` (Why + What Changes), `tasks.md`
(checklist only), optional `design.md`, `specs/<module>/spec.md` (SHALL/MUST +
Given/When/Then, `####` scenarios).
## Language & Framework Rules
- **RUST**: `.claude/rules/rust.md`
## Specs index (on demand)
- `/.rulebook/specs/rulebook.md` — task management
- `/.rulebook/specs/quality.md` — quality gates
- `/.rulebook/specs/prohibitions.md` — absolute prohibitions
- `/.rulebook/specs/git.md` — git workflow