by kv0906
AI-augmented PM workspace for Coding Agents — daily standups, decisions, blockers, docs, and sprint reviews as markdown skills
# Add to your Claude Code skills
git clone https://github.com/kv0906/pm-kit
Turn your AI coding tool into a PM workspace, knowledge hub, and execution engine.
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.
# 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
# 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
/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
/push
# 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
No comments yet. Be the first to share your thoughts!
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/.
| 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 |
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.
| 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 |
| 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.
| 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 |
Contributions are welcome.
CONTRIBUTING.md## Changelog Entry in each PREvery merged PR to main is automatically recorded in CHANGELOG.md.
MIT
Think clearly. Build simply. Let systems carry the weight.