Research-mind mpm-init

Initialize or update project for Claude Code and MPM

install

source · Clone the upstream repo

git clone https://github.com/MacPhobos/research-mind

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/MacPhobos/research-mind "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/mpm-init" ~/.claude/skills/macphobos-research-mind-mpm-init && rm -rf "$T"

manifest: .claude/skills/mpm-init/SKILL.md

/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.