Cursor rule

1---
2description: "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."
3alwaysApply: false
4---
5 
6# Setup Environment
7> **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.
8 
9 
10Idempotent prep so BUILD phase commands succeed on first run.
11 
12## Checklist
13 
141. Read `CLAUDE.md` / `CONVENTIONS.md` for required runtimes and commands.
152. Verify runtime versions (`node -v`, `swift --version`, etc.).
163. Install dependencies (`npm ci`, `bundle install`, etc.) — prefer lockfile installs.
174. Copy `.env.example` → `.env` if documented; never commit secrets.
185. Run smoke: lint + one fast test or `--version` on key tools.
196. Record versions in `specs/state.yaml` under Environment.
20 
21## BCP Plus Counter (optional)
22 
23The `big-counter` tool is an optional dependency for BCP Plus 13-dimension story sizing:
24 
25```bash
26# Install from PyPI (recommended)
27pip install big-counter
28 
29# Or from npm
30npm install -g big-counter
31```
32 
33Verify the install: `big-counter --version`
34Skip if BCP Plus sizing is not needed for this project.
35 
36## Verify
37 
38→ verify: `test -f CLAUDE.md && grep -q Test CLAUDE.md`
39