Pre-commit Quality Gate

Set up a fast, parallel pre-commit pipeline for full-stack projects.

Tool choices: Lefthook (not Husky), Ruff (not Black/Flake8), Biome (not ESLint/Prettier). Why: speed, simplicity, one tool per job.

Process

1. Detect project structure

Scan the repo to determine:

• Has Python backend? — look for pyproject.toml, requirements.txt, or backend/ dir
• Has JS/TS frontend? — look for package.json, frontend/, or src/ with .ts/.tsx files
• Has existing hooks? — check for .husky/, lefthook.yml, .pre-commit-config.yaml

If existing hooks are found, ask the user before overwriting.