| name | pre-commit |
| description | Run code hygiene checks before committing. Use before git commits or when asked to check code quality. |
Pre-Commit Checks
Run hygiene checks before committing code.
Quick Check Commands
# Type check (don't use pnpm typecheck)
pnpm build
# Lint
pnpm lint
# Tests
pnpm test
Manual Checklist
Before Every Commit
-
pnpm buildpasses -
pnpm lintpasses - No
console.logstatements (except in CLI apps) - No commented-out code blocks
- No
// TODOwithout issue reference
For Effect-TS Code
- No
async/await- useEffect.gen - No type casts - use
satisfies - Errors extend
Data.TaggedError - Services have proper Layer
For Portal Components
- Pages are minimal
- Loading states have skeletons
-
"use client"only where needed - Barrel exports updated
For New Files
- Added to barrel exports
- Types are exported if public API
- CLAUDE.md updated if new pattern
Auto-Fix Common Issues
Unused imports
pnpm lint --fix
Sort imports/objects
ESLint perfectionist plugin handles this automatically.
Instructions
- Run
pnpm buildto check types - Run
pnpm lintto check style - Review staged changes with
git diff --staged - Flag any issues from checklist above
- Suggest fixes for problems found