deepest-plan

deepest-plan

A self-contained Claude Code + OpenCode plugin for producing bulletproof implementation plans.

Generates consensus-validated, research-grounded, gate-hardened, phase-structured execution plans. Optional multi-plan tournament synthesis selects the best of N competing plans. Every plan ships with blocking validation gates that enforce real-system proof — no mocks, no stubs, no test files.

---

What you get

• One slash command: /deepest <task> — runs the full 6-phase pipeline
• Six execution commands: /deepest:setup, /deepest:validate-plan, /deepest:validate, /deepest:validate-fix, /deepest:validate-audit, /deepest:validate-ci
• 19 bundled skills — all validation infrastructure is vendored. No external plugin dependencies required.
• Two output shapes: multi-file .planning/ tree OR single monolith XML OR both
• Optional Phase 7 tournament: N generators + meta-judge + M judges + adaptive synthesis
• Validators: plugin structure + generated-artifact XML

---

Install

Different runtime, different install path.

Claude Code (spec-compliant via /plugin marketplace)

The simplest path — install directly from GitHub:

/plugin marketplace add krzemienski/deepest-plan-plugin
/plugin install deepest-plan@deepest-plan-dev

Or clone locally first (useful for development / offline use):

git clone https://github.com/krzemienski/deepest-plan-plugin.git ~/Desktop/deepest-plan
cd ~/Desktop/deepest-plan
./scripts/install.sh claude     # prints the two /plugin commands to run

Then inside a Claude Code session:

/plugin marketplace add ~/Desktop/deepest-plan
/plugin install deepest-plan@deepest-plan-dev

The repo doubles as its own marketplace — .claude-plugin/marketplace.json lists the plugin under the deepest-plan-dev marketplace name. Restart Claude Code to pick up commands and skills.

OpenCode (skills + commands via symlink)

OpenCode plugins are code modules (JS/TS), not declarative manifests. But OpenCode ALSO autoloads skills and slash commands from ~/.config/opencode/{skills,commands}/. The installer symlinks the plugin's skills and commands into those dirs so every /deepest:* command and bundled skill is available in OpenCode sessions.

./scripts/install.sh opencode

Override target via OPENCODE_CONFIG_DIR env var.

Both

./scripts/install.sh both

Verify

python3 scripts/validate-plugin.py

Expected: VALIDATION PASSED.

Inside a fresh session:

• Claude Code: /help should list the /deepest commands
• OpenCode: /deepest:setup should autocomplete

Uninstall

./scripts/uninstall.sh both

For Claude Code you still need /plugin uninstall deepest-plan@deepest-plan-dev inside a session; the script prints the command.

---

Quick start

# In any project
/deepest Add a /account/preferences page where users toggle email preferences

The plugin will:

1. Classify complexity (refuses trivial tasks)
2. Discover your installed skills + detect in-scope libraries + pull relevant docs via context7
3. Run parallel researchers for consensus
4. Score every section for confidence gaps
5. Rewrite weak sections with research-backed evidence
6. Inject blocking validation gates + phase hierarchy
7. Audit and write the final plan

Output: .planning/ tree with BRIEF.md, ROADMAP.md, and per-phase PLAN.md files, plus e2e-evidence/ scaffolded for execution.

Then to execute:

/deepest:setup              # one-time init
/deepest:validate-plan      # generate validation-plan.md
/deepest:validate           # run the full pipeline

More: docs/QUICKSTART.md.

---

Output modes

Mode	When to use	Flag
tree (default)	Multi-phase projects, team review, PR-oriented	--tree
monolith	Single XML mega-prompt for autonomous one-shot execution	--monolith
both	Humans read the tree, agents consume the monolith	--both

---

Phase 7 tournament (opt-in)

Competitive plan generation. Launches N parallel plan generators, a tailored meta-judge eval spec, M parallel judges, then routes adaptively:

• Unanimous winner → SELECT_AND_POLISH (preserve winner, patch from runners-up)
• Split decision → FULL_SYNTHESIS (combine best sections from each)
• All < 3.0/5 → REDESIGN (back to Phase 1 with lessons learned)

Invoke:

/deepest --synthesis 5  "Refactor auth"                  # tournament of 5
/deepest --synthesis 5 --debate  "Migrate payments"      # debate judges

Detail: skills/deepest-plan/references/synthesis-workflow.md and synthesis-config.md.

---

Self-contained skill graph

Every skill this plugin references is bundled inside this plugin. Nothing external required.