.cursorrules

# SDP Project Rules

This project uses **Spec-Driven Protocol (SDP)** v0.6.0.

## Beads (SDP Development)

**This repo develops SDP.** Beads is ENABLED and MANDATORY here:

- Before `@build`: `bd update {beads_id} --status in_progress`
- After `@build`: `bd sync` before commit
- After `@design`: `sdp beads migrate docs/workstreams/backlog/ --real`

For other projects using SDP: Beads is optional (skills check `bd` + `.beads/`).

## Commands

Use skills for all work:
- `@idea` — Gather requirements
- `@design` — Plan workstreams
- `@build` — Execute workstream (guard enforced)
- `@review` — Quality review
- `@deploy` — Production deployment

## Guard Enforcement

All edits require active workstream:

```bash
sdp guard activate {WS-ID}  # Before editing
sdp guard check {file}      # Verify allowed
```

## Critical Rules

**Forbidden:**
- ❌ `except: pass`
- ❌ Files > 200 LOC
- ❌ TODO without WS
- ❌ Edit without active WS

**Required:**
- ✅ TDD (Red → Green → Refactor)
- ✅ Coverage ≥80%
- ✅ Type hints (mypy --strict)
- ✅ Conventional commits

## Documentation

- [PROTOCOL.md](docs/PROTOCOL.md) — Full specification
- [Skills](.claude/skills/) — Command details
- [Quality Gates](docs/reference/quality-gates.md)

---

**Version:** 0.6.0