Windsurf rules

1---
2name: hook-commits
3model: haiku
4description: "Set up pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing."
5---
6 
7# Hook Commits
8> **HARD GATE** — **HARD GATE** — Pre-commit and commit-msg hooks must run before any commit lands. Skipping hooks (`--no-verify`) is forbidden unless explicitly authorized for a specific commit and documented.
9 
10 
11## What This Sets Up
12 
13- **Husky** pre-commit hook
14- **lint-staged** running Prettier on all staged files
15- **Prettier** config (if missing)
16- **typecheck** and **test** scripts in the pre-commit hook
17 
18## Steps
19 
20### 1. Detect package manager
21 
22Check for `package-lock.json` (npm), `pnpm-lock.yaml` (pnpm), `yarn.lock` (yarn), `bun.lockb` (bun). Use whichever is present. Default to npm if unclear.
23 
24### 2. Install dependencies
25 
26Install as devDependencies:
27 
28```
29husky lint-staged prettier
30```
31 
32### 3. Initialize Husky
33 
34```bash
35npx husky init
36```
37 
38This creates `.husky/` dir and adds `prepare: "husky"` to package.json.
39 
40### 4. Create `.husky/pre-commit`
41 
42Write this file (no shebang needed for Husky v9+):
43 
44```
45npx lint-staged
46npm run typecheck
47npm run test
48```
49 
50**Adapt**: Replace `npm` with detected package manager. If repo has no `typecheck` or `test` script in package.json, omit those lines and tell the user.
51 
52### 5. Create `.lintstagedrc`
53 
54```json
55{
56  "*": "prettier --ignore-unknown --write"
57}
58```
59 
60### 6. Create `.prettierrc` (if missing)
61 
62Only create if no Prettier config exists. Use these defaults:
63 
64```json
65{
66  "useTabs": false,
67  "tabWidth": 2,
68  "printWidth": 80,
69  "singleQuote": false,
70  "trailingComma": "es5",
71  "semi": true,
72  "arrowParens": "always"
73}
74```
75 
76### 7. Verify
77 
78- [ ] `.husky/pre-commit` exists and is executable
79- [ ] `.lintstagedrc` exists
80- [ ] `prepare` script in package.json is `"husky"`
81- [ ] `prettier` config exists
82- [ ] Run `npx lint-staged` to verify it works
83 
84### 8. Commit
85 
86Stage all changed/created files and commit with message: `chore: add pre-commit hooks (husky + lint-staged + prettier)`
87 
88This will run through the new pre-commit hooks — a good smoke test that everything works.
89 
90## Notes
91 
92- Husky v9+ doesn't need shebangs in hook files
93- `prettier --ignore-unknown` skips files Prettier can't parse (images, etc.)
94- The pre-commit runs lint-staged first (fast, staged-only), then full typecheck and tests
95