Plan-driven development toolkit

pk is a CLI for Claude Code that encodes the discipline AI-assisted development needs. Plans commit to an approach before code is written. Rules guide the AI away from common pitfalls. Tests protect what works. Guards block git mutations on protected branches before damage happens.

Designed for small teams and independent developers. Single Go binary, zero dependencies, MIT licensed.

Install

Download the binary for your platform from the releases page, put it on your PATH, and run:

pk setup

Or, if you have Go installed:

go install github.com/markwharton/plankit/cmd/pk@latest
pk setup

Requirements: git and Claude Code. The pk binary has no runtime dependencies — Go is only needed if you install from source. Setup refuses to install outside a git working tree by default; see setup docs for non-git use cases.

What it does

• Rules and guidelines CLAUDE.md with critical rules, plus detailed .claude/rules/ for model behavior, development standards, and git discipline.
• Claude Code skills /init, /changelog, /release, /preserve — slash commands for common workflows.
• Plan preservation Approved plans saved as timestamped docs in docs/plans/, committed to git, protected from accidental edits.
• Branch protection Git mutations blocked via hooks, locally, before damage happens.

Commands

• pk setupConfigure project hooks, skills, and CLAUDE.md
• pk statusShow plankit setup state in this project
• pk teardownRemove plankit from a project (preview by default)
• pk changelogGenerate CHANGELOG.md from conventional commits
• pk releaseTag, merge to release branch, validate, push
• pk versionPrint version and check for updates

Hook commands (pk guard, pk pin, pk preserve, pk protect) run automatically — triggered by Claude Code or by other pk commands. You don’t invoke them directly.

Setup modes

pk setup                       # default: block guard, manual preserve
pk setup --guard ask           # prompt instead of blocking
pk setup --preserve auto       # preserve plans on ExitPlanMode

Docs

• Getting started Install, setup, first run.
• Methodology Plan-driven development, guidelines, testing loop.
• Source github.com/markwharton/plankit — MIT licensed.

pk is the toolkit behind plankit. We use it to build everything. Free for you to use too.