Claude Code Kit

Make Claude Code behave like a staff engineer.

Drop-in starter templates that turn the agent from an eager intern into a disciplined collaborator. Plan. Confirm. Implement. Verify. Every single time.

60 seconds · macOS, Linux, Windows · Node 18+

I.The Four Disciplines

A loop, not a checklist.

Every kit-managed session walks the same four-step loop. The agent can't skip steps; the rules are read at session boot, the hooks enforce the non-negotiable parts.

  1. I

    Plan first.

    For any task touching three or more files, the agent writes a plan to tasks/todo.md before touching code. No silent assumptions, no leap-before-look.

    agent_docs/workflow.md

  2. II

    Confirm with you.

    Plans pause on protected changes — new dependencies, schema migrations, auth logic, build system edits. Two approaches with tradeoffs, then your call.

    CLAUDE.md → Protected Changes

  3. III

    Implement in scope.

    Touch only files directly required. No opportunistic refactors. Unrelated issues logged under tasks/todo.md → Not Now. Discipline as a deletion test.

    agent_docs/conventions.md

  4. IV

    Verify before signing off.

    Mandatory order: typecheck, lint, tests, smoke test. The agent asks itself — would a staff engineer approve this? — and answers with evidence.

    CLAUDE.md → Verification

“Would a staff engineer approve this?” — the question every task ends with.

II.Before / After

Same prompt. Different agent.

The prompt: “Add a search feature to the users page.”

Without the kit

Default behavior

The agent immediately starts coding…

  • Installs three new packages without asking
  • Refactors the entire users module “while it’s here”
  • Breaks the build because it didn’t typecheck
  • Doesn’t test anything
  • You spend 30 minutes reverting unrelated changes

With the kit

Disciplined

The agent restates, plans, asks, and verifies…

  • Restates the task in one sentence before touching code
  • Reads CODEBASE_MAP.md, then writes a plan
  • Asks before installing dependencies
  • Touches only the three files in scope
  • Runs typecheck, lint, tests, smoke test — in that order

Same model · same prompt · different rules

III.The Numbers

Kit, by the digits.

Every piece is in plain markdown or shell. Read every line in a sitting. Audit before you trust.

23
Skills
audit · workflow · meta · wiki
12
Hooks
deterministic, exit-2 blocks
6
Agents
reviewer · planner · QA · more
7
Recipes
concrete how-to guides
3
Templates
Next.js · Node · FastAPI
0
Lock-in
MIT · plain markdown
Stack Templates

Pre-mapped to your stack.

Each template ships a CLAUDE.md tuned for the framework and a CODEBASE_MAP.md scaffolded with the right sections.

  • Next.js

    16 + App Router

    Server Component rules, build verification, Prisma + Tailwind ready.

  • Node API

    Express + TypeScript

    Layered architecture, API design conventions, Knex.js patterns baked in.

  • FastAPI

    SQLAlchemy 2.0 + Pydantic v2

    Async patterns, dependency injection, Alembic-aware migration playbook.

V.Versus the Alternatives

Why not just use .cursorrules?

That works fine until your rules file passes 200 lines and you can't reason about it anymore. The kit wins on tiered context loading, deterministic hooks, project overlay separation, and multi-tool export. It loses on learning curve and bash dependency. Honest comparison →

“Versus raw Claude Code, .cursorrules, AGENTS.md, and Aider config — the comparison covers twelve dimensions including tiered context, deterministic enforcement, project overlay, and cross-tool export.”

Read the full comparison

One source. Seven outputs.

Claude CodeCursorAiderGitHub CopilotOpenAI CodexGoogle JulesWindsurf

Edit one CLAUDE.md, run ./scripts/convert.sh all, ship to every tool your team uses.

Live from the Repo
StarsLatest versionnpm downloadsLicenseLast commit

Get started.

One command. Sixty seconds. The next session your agent runs is shaped by the kit.

works on macOS, Linux, Windows · node 18+