PM-Kit

Turn your AI coding tool into a PM workspace, knowledge hub, and execution engine.

Disclaimer

This is not gospel. This is not the holy grail.

PM-Kit is one system that works. It is a guideline and mindset shift, not a rigid rulebook.

The principles in _core/MANIFESTO.md may resonate with you, or they may not. That is fine. Take what works. Ignore what does not. Make it yours.

You will get better results through repetition. The framework should adapt to your workflow, not the other way around.

Quick Start

Option A: CLI Install (Recommended)

# 1. Install the CLI
curl -fsSL https://raw.githubusercontent.com/kv0906/pm-kit/main/cli/install.sh | bash

# 2. Create your vault
pm-kit init ~/Documents/my-vault
cd ~/Documents/my-vault

# 3. Open the folder in Obsidian, then run Claude Code
claude
/onboard

Option B: GitHub Template

# 1. Use this template on GitHub (or clone)
git clone <your-repo-url>
cd pm-kit

# 2. Open the folder in Obsidian

# 3. Run Claude Code
claude
/onboard

/onboard sets up your project, learns your preferences, and loads context. Full walkthrough: START_HERE.md

Daily Routine

/today                # Guided workflow: standup → sync → review → focus → wrap-up
/today wrap           # Jump to end-of-day summary

Or for quick atomic updates:

/daily my-project: shipped X, wip Y, blocked on Z
/push

Weekly Routine

/weekly
/push

Updating

# CLI users
pm-kit update            # Update framework files from latest release
pm-kit self-update       # Update the CLI itself

# Template users
./scripts/update.sh      # Update framework files from latest release

Or from within Claude: /update

Updates only touch framework files (skills, templates, scripts, docs). Your notes, config, and content are never modified. Backups are saved to _archive/_updates/.

All Commands

| Command | Purpose | |---------|---------| | /today | Guided daily workflow orchestrator | | /daily | Multi-project standup logging | | /progress | Cross-project status synthesis | | /block | Structured blocker capture | | /decide | Decision records with alternatives | | /doc | PRD/spec drafting | | /meet | Meeting extraction into actions/decisions | | /inbox | Fast capture for later processing | | /ask | Vault Q&A (QMD-powered when available) | | /health | Link + vault integrity checks | | /weekly | Sprint retro and planning loop | | /push | Commit and sync | | /onboard | Interactive setup + context loading | | /update | Check for and apply framework updates |

Smarter /ask with QMD (Optional)

Install QMD for hybrid search (BM25 + vector + rerank) that dramatically improves /ask accuracy. Requires bun and technical comfort with CLI tools. Without QMD, /ask still works using vault grep.

# 1. Install bun (if not installed)
curl -fsSL https://bun.sh/install | bash

# 2. Install QMD and set up your vault
bun install -g github:tobi/qmd
qmd collection add . --name pm-kit

# 3. Build the search index
qmd embed

After setup, /ask automatically uses QMD when available. No command changes needed.

Having trouble? See handbook/QMD_INTEGRATION.md or open an issue.

Who Uses PM-Kit

| Role | How They Use It | |------|------------------| | Product Managers / Product Owners | Run dailies, write PRDs, track blockers, align cross-functional work | | Engineering Leads | Capture decisions, drive sprint clarity, maintain technical context | | Engineers (Junior -> Senior) | Document context, ship specs, keep decisions traceable | | Founders / Solo Builders | Turn scattered thoughts into an execution system | | Analysts / Operators | Log research, synthesize findings, build durable knowledge |

Works With

| Tool | Status | How | |------|--------|-----| | Claude Code | Native | Reads CLAUDE.md, .claude/ skills, agents, hooks | | Cursor | Compatible | .cursorrules + .cursor/rules/ symlinked to source | | GitHub Copilot | Compatible | .github/copilot-instructions.md symlinked to source | | Windsurf | Compatible | .windsurfrules symlinked to source | | Cline | Compatible | .clinerules symlinked to source | | OpenAI Codex | Compatible | AGENTS.md with project context |

All compatibility files are symlinks to CLAUDE.md (single source of truth). Rules in .claude/rules/ are shared via symlinks where the tool supports directory-based rules.

Documentation

| Doc | What It Covers | |-----|----------------| | START_HERE.md | 10-step beginner guide | | handbook/ARCHITECTURE.md | How PM-Kit works, project structure, principles | | handbook/QMD_INTEGRATION.md | QMD setup, troubleshooting, architecture | | handbook/SETUP_GUIDE.md | Installation and first run | | handbook/CUSTOMIZATION.md | Projects, templates, and overrides | | handbook/WORKFLOW_EXAMPLES.md | Example operating flows | | handbook/TROUBLESHOOTING.md | Common issues and fixes | | handbook/maintainer-runbook.md | Release, changelog governance, and maintainer workflow |

Contributing

Contributions are welcome.

• Read CONTRIBUTING.md
• Use the PR template
• Include a ## Changelog Entry in each PR

Every merged PR to main is automatically recorded in CHANGELOG.md.

License

MIT

Star History

Think clearly. Build simply. Let systems carry the weight.