bobmatnyc /mpm-init
Initialize or intelligently update project for Claude Code and Claude MPM.
Usage
/mpm-init [update|context|resume|catchup] [options]
Core Modes
Project Setup
/mpm-init # Auto-detect: offer update or create
/mpm-init update # Quick update (30-day git activity)
/mpm-init --update # Full documentation refresh
/mpm-init --force # Force recreate from scratch
Delegates to Agentic Coder Optimizer agent for:
- CLAUDE.md creation/update (with priority rankings 🔴🟡🟢⚪)
- AST analysis and code structure docs
- Single-path workflows (ONE way to do ANYTHING)
- Tool configuration, memory system, gitignore management
Smart Update Mode: Auto-detects existing CLAUDE.md and offers update vs recreate.
Context Analysis
/mpm-init context [--days N] # Intelligent git history analysis (default: 7 days)
/mpm-init catchup # Quick commit history (last 25 commits, no analysis)
context: Delegates to Research agent for deep analysis of:
- Active work streams (from commit patterns)
- Intent and motivation (from messages)
- Risks and blockers
- Recommended next actions
catchup: Direct CLI execution, instant output.
Resume from Logs
/mpm-init resume [--list] [--session-id ID]
Reads stop event logs from .claude-mpm/resume-logs/ and .claude-mpm/responses/ showing:
- What was being worked on
- Tasks completed, files modified
- Next steps, stop reason, token usage
- Git context (branch, status)
Key Options
Configuration:
--project-type TYPE: web, api, cli, library--framework NAME: react, django, fastapi, etc.--ast-analysis/--no-ast-analysis: Enable/disable code analysis--comprehensive/--minimal: Full setup vs CLAUDE.md only
Organization:
--organize: Organize misplaced files--preserve-custom: Keep custom sections (default)--review: Review without changes
What Gets Created
New Projects:
- ✅ CLAUDE.md (priority-ranked instructions)
- ✅ Single-path workflows (make build/test/deploy)
- ✅ Tool configs (linting, formatting, testing)
- ✅ Memory system (.claude-mpm/memories/)
- ✅ DEVELOPER.md, CODE_STRUCTURE.md (with AST)
- ✅ .gitignore updates (auto-adds .claude-mpm/)
Updates:
- ✅ Smart merging (preserves custom sections)
- ✅ Automatic archival (docs/_archive/)
- ✅ Change tracking
Examples
# Quick start
/mpm-init # Auto-detect mode
# Quick update (lightweight)
/mpm-init update # 30-day activity report
# Resume work
/mpm-init context --days 14 # Analyze last 2 weeks
/mpm-init resume # Show latest session from logs
/mpm-init catchup # Quick commit history
# Full configuration
/mpm-init --project-type web --framework react --comprehensive
Implementation Notes
Delegation patterns:
- Project init/update: → Agentic Coder Optimizer agent
- context: → PM → Research agent (structured analysis)
- catchup: → Direct CLI (git log wrapper)
- resume: → PM (reads logs, no delegation)
Token budgets:
- context analysis: 10-30s processing time
- resume display: ~10-20k tokens
- catchup: instant, minimal tokens
See docs/commands/init.md for comprehensive documentation.