Slash-command-driven product thinking toolkit for Claude Code.
Product Kit gives PMs a structured workflow for validating product ideas — user personas, problem statements, assumptions mapping — all through guided AI conversations.
- Node.js 18 or later
- Claude Code installed and available in your PATH
Verify Claude Code is ready:
claude --versionnpm install -g productkitgit clone https://github.com/iamquechua/product-kit.git
cd product-kit
npm install
npm link # makes `productkit` available globallyproductkit init my-project
cd my-projectThis scaffolds a project with slash commands, a CLAUDE.md context file, and a .productkit/ config directory.
For existing projects:
cd my-existing-project
productkit init --existingTo keep artifacts out of the project root (recommended for busy codebases):
productkit init --existing --artifact-dir docs/productclaudeEach command starts a guided conversation. Claude asks questions, pushes back on vague answers, and writes a markdown artifact when done.
| Step | Command | What it does | Output |
|---|---|---|---|
| 1 | /productkit.constitution |
Define product principles and values | constitution.md |
| 2 | /productkit.users |
Define target user personas through dialogue | users.md |
| 3 | /productkit.problem |
Frame the problem statement grounded in user research | problem.md |
| 4 | /productkit.assumptions |
Extract and prioritize hidden assumptions | assumptions.md |
| 5 | /productkit.validate |
Validate assumptions with interviews and surveys | validation.md |
| 6 | /productkit.solution |
Brainstorm and evaluate solution ideas | solution.md |
| 7 | /productkit.prioritize |
Score and rank features for v1 | priorities.md |
| 8 | /productkit.spec |
Generate a complete product spec | spec.md |
| — | /productkit.clarify |
Resolve ambiguities and contradictions across artifacts | Updates existing files |
| — | /productkit.analyze |
Run a consistency and completeness check | Analysis in chat |
| — | /productkit.bootstrap |
Auto-draft all artifacts from existing codebase | All missing artifacts |
| — | /productkit.audit |
Compare spec against codebase, surface gaps | audit.md |
Commands build on each other — /productkit.problem reads your users.md, /productkit.solution reads your problem and users, and /productkit.spec synthesizes everything into a single document. You can run /productkit.clarify and /productkit.analyze at any stage to check your work.
After running the commands, your project contains:
my-project/
├── constitution.md # Product principles
├── users.md # User personas
├── problem.md # Problem statement
├── assumptions.md # Prioritized assumptions
├── validation.md # Validation results & scripts
├── solution.md # Chosen solution
├── priorities.md # Ranked feature list
├── spec.md # Complete product spec
├── audit.md # Spec vs codebase audit (on demand)
├── .productkit/config.json
├── .claude/commands/ # Slash command prompts
├── CLAUDE.md
├── README.md
└── .gitignore
If you used --artifact-dir docs/product, artifacts live in docs/product/ instead of the project root.
These markdown files are your product foundation — share them with your team, commit them to git, or hand spec.md to engineering.
| Command | Description |
|---|---|
productkit init <name> |
Scaffold a new project |
productkit init --existing |
Add Product Kit to the current directory |
productkit init --minimal |
Skip constitution, start with users/problem |
productkit init --artifact-dir <dir> |
Store artifacts in a custom directory |
productkit status |
Show progress — which artifacts exist and what's next |
productkit export |
Export all artifacts as a single combined markdown file |
productkit export --output <file> |
Export to a custom filename |
productkit diff |
Show what changed in artifacts since last commit |
productkit diff --staged |
Show staged artifact changes |
productkit doctor |
Check project health (missing files, outdated commands) |
productkit update |
Refresh slash commands to the latest version |
productkit reset |
Remove all artifacts and start over |
productkit list |
Show available slash commands with descriptions |
productkit completion |
Output shell completion script (bash/zsh) |
productkit check |
Verify Claude Code is installed |
If you prefer Claude Cowork over the command line, Product Kit is also available as a Cowork plugin. Same guided workflows, no terminal needed.
- Download
product-kit-plugin.zipfrom GitHub Releases - In Cowork, go to Plugins → + → Upload plugin
- Select the zip file
Once installed, type /product-kit:users, /product-kit:problem, etc. in Cowork's chat. See plugin/README.md for details.
Product Kit is a thin scaffolding tool. The real work happens in slash commands — markdown prompt files that live in .claude/commands/. When you type /productkit.users in Claude Code, it reads the prompt file and starts a guided conversation.
Each prompt tells Claude:
- What role to play (PM coach, research specialist, etc.)
- What artifacts to read first (enforces workflow ordering)
- How to guide the conversation (questions to ask, what to push back on)
- What file to write and in what format
You can customize any slash command by editing the files in .claude/commands/.
MIT