68 lines
3.4 KiB
Markdown
68 lines
3.4 KiB
Markdown
# ultraplan-local
|
|
|
|
Deep implementation planning with interview, specialized agent swarms, external research, adversarial review, session decomposition, disciplined execution, and headless support. A local alternative to Anthropic's Ultraplan.
|
|
|
|
## Commands
|
|
|
|
| Command | Description | Model |
|
|
|---------|-------------|-------|
|
|
| `/ultraplan-local` | Plan — interview, explore, plan, review | opus |
|
|
| `/ultraexecute-local` | Execute — disciplined plan/session-spec executor with failure recovery | opus |
|
|
|
|
### /ultraplan-local modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Interview + background planning (non-blocking) |
|
|
| `--spec <path>` | Skip interview, use provided spec |
|
|
| `--fg` | All phases in foreground (blocking) |
|
|
| `--quick` | Interview + plan directly (no agent swarm) |
|
|
| `--export <pr\|issue\|markdown\|headless> <plan>` | Generate shareable output from existing plan |
|
|
| `--decompose <plan>` | Split plan into self-contained headless sessions |
|
|
|
|
### /ultraexecute-local modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Execute plan — auto-detects Execution Strategy for multi-session |
|
|
| `--resume` | Resume from last progress checkpoint |
|
|
| `--dry-run` | Validate plan structure without executing |
|
|
| `--step N` | Execute only step N |
|
|
| `--fg` | Force foreground — run all steps sequentially, ignore Execution Strategy |
|
|
| `--session N` | Execute only session N from plan's Execution Strategy |
|
|
|
|
## Agents
|
|
|
|
| Agent | Model | Role |
|
|
|-------|-------|------|
|
|
| planning-orchestrator | opus | Runs full pipeline as background task |
|
|
| architecture-mapper | sonnet | Codebase structure, tech stack, patterns |
|
|
| dependency-tracer | sonnet | Import chains, data flow, side effects |
|
|
| task-finder | sonnet | Task-relevant files, functions, reuse candidates |
|
|
| risk-assessor | sonnet | Risks, edge cases, failure modes |
|
|
| test-strategist | sonnet | Test patterns, coverage gaps, strategy |
|
|
| git-historian | sonnet | Recent changes, ownership, hot files |
|
|
| research-scout | sonnet | External docs for unfamiliar tech (conditional) |
|
|
| spec-reviewer | sonnet | Spec quality check before exploration |
|
|
| plan-critic | sonnet | Adversarial plan review (9 dimensions) |
|
|
| scope-guardian | sonnet | Scope alignment (creep + gaps) |
|
|
| session-decomposer | sonnet | Splits plans into headless sessions with dependency graph |
|
|
| convention-scanner | sonnet | Coding conventions: naming, style, error handling, test patterns |
|
|
|
|
## Architecture
|
|
|
|
**Plan:** 12-phase workflow: Parse mode -> Interview -> Background transition -> Codebase sizing -> Spec review -> Parallel exploration (6-8 agents) -> Deep-dives -> Synthesis -> Planning -> Adversarial review -> Present/refine -> Handoff.
|
|
|
|
**Decompose:** Parse plan -> Analyze step dependencies -> Group into sessions -> Identify parallel waves -> Generate session specs + dependency graph + launch script.
|
|
|
|
**Execute:** Parse plan -> Detect Execution Strategy -> Single-session (step loop) or multi-session (parallel waves via `claude -p`) -> Verification -> Report.
|
|
|
|
## State
|
|
|
|
- Specs: `.claude/ultraplan-spec-{date}-{slug}.md`
|
|
- Plans: `.claude/plans/ultraplan-{date}-{slug}.md`
|
|
- Sessions: `.claude/ultraplan-sessions/{slug}/session-*.md`
|
|
- Launch scripts: `.claude/ultraplan-sessions/{slug}/launch.sh`
|
|
- Progress: `{plan-dir}/.ultraexecute-progress-{slug}.json`
|
|
- Plan stats: `${CLAUDE_PLUGIN_DATA}/ultraplan-stats.jsonl`
|
|
- Exec stats: `${CLAUDE_PLUGIN_DATA}/ultraexecute-stats.jsonl`
|