Windsurf rules

1---
2name: setup-environment
3model: haiku
4description: "Pre-install dependencies and configure tools before development work begins. Use at session start on a fresh clone, before kickoff-branch, or when user says setup environment or install deps."
5---
6 
7# Setup Environment
8> **HARD GATE** — **HARD GATE** — Environment setup must be idempotent and reproducible. If setup fails, provide clear error messages and remediation steps. Do NOT assume prior state.
9 
10 
11Idempotent prep so BUILD phase commands succeed on first run.
12 
13## Checklist
14 
151. Read `CLAUDE.md` / `CONVENTIONS.md` for required runtimes and commands.
162. Verify runtime versions (`node -v`, `swift --version`, etc.).
173. Install dependencies (`npm ci`, `bundle install`, etc.) — prefer lockfile installs.
184. Copy `.env.example` → `.env` if documented; never commit secrets.
195. Run smoke: lint + one fast test or `--version` on key tools.
206. Record versions in `specs/state.yaml` under Environment.
21 
22## BCP Plus Counter (optional)
23 
24The `big-counter` tool is an optional dependency for BCP Plus 13-dimension story sizing:
25 
26```bash
27# Install from PyPI (recommended)
28pip install big-counter
29 
30# Or from npm
31npm install -g big-counter
32```
33 
34Verify the install: `big-counter --version`
35Skip if BCP Plus sizing is not needed for this project.
36 
37## Verify
38 
39→ verify: `test -f CLAUDE.md && grep -q Test CLAUDE.md`
40