Merge pull request #123 from nanotaboada/docs/adr-0009-0011

docs(adr): add themed versioning, AI workflow and SDD records

Author: nanotaboada

.claude/commands/pre-commit.md

@@ -10,12 +10,13 @@ Run the pre-commit checklist for this project:
 2. Run `cargo fmt` — formats code in place.
 3. Run `cargo clippy --all-targets --all-features -- -D warnings` — must pass clean.
 4. Run `cargo test` — all tests must pass.
-5. Run `cargo build` — must succeed.
-6. If Docker is running, run `docker compose build` — must succeed with no
+5. Run `cargo tarpaulin --fail-under 80` — coverage must be ≥80%.
+6. Run `cargo build` — must succeed.
+7. If Docker is running, run `docker compose build` — must succeed with no
    errors. Skip this step with a note if Docker Desktop is not running.
-7. If `coderabbit` CLI is installed, run `coderabbit review --type uncommitted --prompt-only`:
+8. If `coderabbit` CLI is installed, run `coderabbit review --type uncommitted --prompt-only`:
    - If actionable/serious findings are reported, stop and address them before proposing the commit.
    - If only nitpick-level findings, report them and continue to the commit proposal.
    - If `coderabbit` is not installed, skip this step with a note.
 
-Run steps 2–5, run step 6 (docker build), then run step 7 (CodeRabbit review) if available, report the results clearly, then propose a branch name and commit message for my approval using the format `type(scope): description (#issue)` (max 80 chars; types: `feat` `fix` `chore` `docs` `test` `refactor` `ci` `perf`) followed by a co-author line `Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>`. Do not create the branch or commit until I explicitly confirm.
+Run steps 2–6, run step 7 (docker build), then run step 8 (CodeRabbit review) if available, report the results clearly, then propose a branch name and commit message for my approval using the format `type(scope): description (#issue)` (max 80 chars; types: `feat` `fix` `chore` `docs` `test` `refactor` `ci` `perf`) followed by a co-author line `Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>`. Do not create the branch or commit until I explicitly confirm.

CHANGELOG.md

@@ -44,13 +44,14 @@ Release codenames follow an A-Z sequence using Ballon d'Or award nominees surnam
 
 ### Added
 
-- Architecture Decision Records in `adr/`: 8 ADRs (0001–0008) documenting framework selection, four-layer architecture, Diesel/r2d2/SQLite persistence stack, dual-key strategy, PUT semantics, embedded migrations, integration-only testing, and Docker/Compose strategy (`#113`)
+- Architecture Decision Records in `docs/adr/`: 11 ADRs (0001–0011) documenting framework selection, four-layer architecture, Diesel/r2d2/SQLite persistence stack, dual-key strategy, PUT semantics, embedded migrations, integration-only testing, Docker/Compose strategy, Ballon d'Or-themed versioning, AI-assisted development workflow, and Spec-Driven Development (`#113`)
 
 ### Changed
 
 - Replace `cargo install cargo-tarpaulin` with `taiki-e/install-action@v2.81.8` in CI to use a pre-built binary and reduce coverage job runtime
 - Consolidated agent instructions from `.github/copilot-instructions.md` into `CLAUDE.md`; deleted the legacy split-file layout (`#112`)
 - Rewrote all stale `.coderabbit.yaml` path instructions to reflect the current Diesel/r2d2/SQLite architecture; removed all references to the old `Mutex<Vec<Player>>` in-memory design (`#112`)
+- Added `cargo tarpaulin --fail-under 80` to the `/pre-commit` checklist to enforce 80% coverage locally
 
 ### Fixed
 

CLAUDE.md

@@ -70,7 +70,7 @@ cargo test -- --nocapture               # with output
 3. `cargo build` — must succeed
 4. `cargo test` — all tests must pass
 5. Commit message follows Conventional Commits format (enforced by commitlint)
-6. If this commit introduces or changes an architectural decision, update `CLAUDE.md` and create or amend the relevant ADR in `adr/`.
+6. If this commit introduces or changes an architectural decision, update `CLAUDE.md` and create or amend the relevant ADR in `docs/adr/`.
 7. If this commit adds, removes, or changes an endpoint, a dependency, or how the project is run, update `README.md` and the relevant path instructions in `.coderabbit.yaml`.
 
 ### Commits
@@ -148,20 +148,23 @@ Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
 
 ## Architecture Decision Records
 
-Architectural decisions are documented in `adr/`. When proposing structural
+Architectural decisions are documented in [`docs/adr/`](docs/adr/README.md). When proposing structural
 changes, check the ADR index first. When a decision changes, mark the existing
 ADR as `Deprecated` or `Superseded by ADR-XXXX` and write a new one.
 
 Current ADRs:
 
-- [ADR-0001](adr/0001-adopt-rocket-as-rest-api-framework.md) — Rocket 0.5 as HTTP framework
-- [ADR-0002](adr/0002-four-layer-architecture.md) — Routes → Services → Repositories → State
-- [ADR-0003](adr/0003-diesel-r2d2-bundled-sqlite.md) — Diesel + r2d2 + bundled libsqlite3
-- [ADR-0004](adr/0004-uuid-surrogate-squad-number-natural-key.md) — UUID surrogate key + squad number natural key
-- [ADR-0005](adr/0005-full-replace-put-no-patch.md) — Full-replace PUT, no PATCH
-- [ADR-0006](adr/0006-embed-migrations-startup-schema.md) — `embed_migrations!()` at startup
-- [ADR-0007](adr/0007-integration-only-test-strategy.md) — Integration-only tests with in-memory SQLite
-- [ADR-0008](adr/0008-docker-compose-strategy.md) — Multi-stage Dockerfile + Compose
+- [ADR-0001](docs/adr/0001-adopt-rocket-as-rest-api-framework.md) — Rocket 0.5 as HTTP framework
+- [ADR-0002](docs/adr/0002-four-layer-architecture.md) — Routes → Services → Repositories → State
+- [ADR-0003](docs/adr/0003-diesel-r2d2-bundled-sqlite.md) — Diesel + r2d2 + bundled libsqlite3
+- [ADR-0004](docs/adr/0004-uuid-surrogate-squad-number-natural-key.md) — UUID surrogate key + squad number natural key
+- [ADR-0005](docs/adr/0005-full-replace-put-no-patch.md) — Full-replace PUT, no PATCH
+- [ADR-0006](docs/adr/0006-embed-migrations-startup-schema.md) — `embed_migrations!()` at startup
+- [ADR-0007](docs/adr/0007-integration-only-test-strategy.md) — Integration-only tests with in-memory SQLite
+- [ADR-0008](docs/adr/0008-docker-compose-strategy.md) — Multi-stage Dockerfile + Compose
+- [ADR-0009](docs/adr/0009-ballon-dor-themed-versioning.md) — Ballon d'Or-themed release codenames
+- [ADR-0010](docs/adr/0010-ai-assisted-development-workflow.md) — Claude Code as primary workflow tool
+- [ADR-0011](docs/adr/0011-spec-driven-development.md) — Spec-Driven Development (SDD)
 
 ## Claude Code