vibe_projects/CLAUDE.md

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