Pre-Commit Checks
Run hygiene checks before committing code.
Quick Check Commands
bash
# 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
bash
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