Cursor rule

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