Project Bootstrap

Ensure a project has CI, pre-commit hooks, and framework best practices configured. Detect what exists, add what's missing.

Workflow

1. Detect Project State

Read package.json to determine:

• •Package manager (check for pnpm-lock.yaml, yarn.lock, bun.lockb/bun.lock, package-lock.json)
• •Existing scripts (lint, test, build, typecheck, format)
• •Existing devDependencies (husky, lint-staged, eslint, prettier, vitest, jest)
• •Framework (next, react, vue, svelte)

Check for existing config:

• •.github/workflows/ci.yml — CI already configured?
• •.husky/ — Husky already initialized?
• •Vercel skills already installed?

Report findings to user before making changes.

2. GitHub CI Workflow

Ensure .github/workflows/ci.yml exists with jobs for lint, typecheck, test with coverage, and build.

Read references/ci-workflow.md for the template and adaptation guide.

If a CI workflow already exists, diff it against requirements and only add missing steps. Do not overwrite existing workflows — merge into them.

Configure coverage thresholds in the test runner config (e.g., vitest.config.ts, jest.config.ts). LLM coding agents generate tests alongside code, so enforce high thresholds:

CI must fail if coverage drops below these thresholds. See references/ci-workflow.md for configuration examples.

3. Husky Pre-commit

Ensure husky and lint-staged are installed and configured with checks for lint, format, and typecheck.

Read references/husky-precommit.md for setup instructions.

Key decisions:

• •Include tests in pre-commit only if they run in <30s; otherwise CI-only
• •Typecheck runs as a separate hook step (not inside lint-staged)
• •lint-staged handles per-file lint + format

4. Vercel Best Practices

Install Vercel's agent skills for framework-specific guidance.

Read references/vercel-best-practices.md for details.

Skip if the project doesn't use Vercel or a Vercel-supported framework.

5. Verify

After setup, verify everything works:

# Pre-commit hook fires correctly
git add -A && git commit --dry-run

# CI workflow is valid YAML
cat .github/workflows/ci.yml | python3 -c "import sys, yaml; yaml.safe_load(sys.stdin)"

# Scripts exist and run
<run-command> lint
<run-command> test
<run-command> build

Report results to user.

Missing Tooling

If the project lacks lint/format/test tooling, suggest and install sensible defaults:

Ask the user before installing new tooling — do not assume.