coderkit

CoderKit

CoderKit is an optional engineering toolbox for coding agents. Workflows run only when explicitly requested and are never started automatically. Each tool finishes by naming the natural next step for the user to invoke — a suggestion only, never an automatic handoff, and never offered outside an explicitly requested workflow.

Tool	Purpose
explore	Understand the code and choose a direction — read-only.
plan	Turn the direction into an implementation plan.
implement	Implement with proportionate verification.
debug	Reproduce and isolate a root cause.
verify	Run real checks and review the change for correctness and risk.
commit	Perform explicitly authorized Git and publication actions.

The common path is explore → plan → implement → verify → commit, with debug available when needed. It is not mandatory: every tool works independently, and the user drives the sequencing.

Work products persist in the target project under docs/work/NNN-short-name/: plan writes plan.md, and implement maintains tasks.md (main tasks, subtasks, and subagent assignments) as the build loop progresses. Exploration stays conversational and leaves no artifact.

Install

Codex

codex plugin marketplace add sbusso/coderkit --ref v0.6.0
codex plugin add coderkit@coderkit

Invoke a workflow in plain language, for example: Use CoderKit to explore this feature.

Claude Code

claude plugin marketplace add sbusso/[email protected] --scope user
claude plugin install coderkit@coderkit --scope user

Invoke a workflow with /coderkit:explore, /coderkit:plan, /coderkit:implement, /coderkit:debug, /coderkit:verify, or /coderkit:commit.

Development

bun run check
claude plugin validate packages/claude-code --strict
uv run --with pyyaml -- python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py packages/codex

Canonical workflows live in core/; bun run build generates both native packages. Generated files are committed for direct installation.

CoderKit contains no hooks, telemetry, background services, MCP servers, remote branding, or automatic publication behavior.

Credits

CoderKit is an independent MIT-licensed project inspired by Superpowers, Compound Engineering, and OpenAI's outcome-first prompting guidance.