# Project Rules (auto-loaded)

## What matters most
- Keep changes small and safe.
- Prefer incremental improvements over rewrites.
- Add/adjust tests when behavior changes.
- Keep commits atomic and descriptive.

## GSD workflow
- Use GSD as the source of truth generator:
  - /gsd:new-project creates PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, and .planning/research/
  - /gsd:discuss-phase -> /gsd:plan-phase -> /gsd:execute-phase -> /gsd:verify-work

## Repo quick commands
- Bootstrap:
  - Windows: powershell -ExecutionPolicy Bypass -File scripts/bootstrap.ps1
  - Linux/WSL: bash scripts/bootstrap.sh

- Run checks:
  - Windows: powershell -ExecutionPolicy Bypass -File scripts/check.ps1
  - Linux/WSL: bash scripts/check.sh

- Generate LLM context snapshot:
  - python scripts/contextpack.py
  - output: .planning/CONTEXTPACK.md

## Definition of done
- ruff check .
- ruff format --check .
- pytest
- Update STATE.md if progress changed