deep-plan

deep-plan — Claude Code + Codex Plugin

Bridges GSD strategic planning with Compound Engineering implementation planning. Catches build-breaking issues before execution starts.

Quick Install

Full Bootstrap (Claude Code + Codex)

For a fresh machine, use the deploy bootstrap. It configures the public Claude Code and Codex plugin paths for Deep Plan, Compound Engineering, and Caveman, bridges an existing GSD install into Codex, initializes RTK when available, and prints manual steps for anything that is private or credential-gated.

curl -fsSL https://raw.githubusercontent.com/schylerchase/deep-plan-plugin/main/deploy.sh | bash -s -- --yes

From a cloned checkout:

./deploy.sh --yes

Useful variants:

./deploy.sh --claude-only
./deploy.sh --codex-only
./deploy.sh --dry-run
./deploy.sh --upgrade --yes

GSD is still distributed through its own community channel. The deploy script verifies it and links ~/.claude/get-shit-done into ~/.codex/get-shit-done when present, but it does not fetch private/community-gated assets.

Claude Code Only

If you already have GSD and Compound Engineering installed:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/schylerchase/deep-plan-plugin/main/setup.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/schylerchase/deep-plan-plugin/main/setup.ps1 | iex

Or manually (all platforms):

claude plugin marketplace add https://github.com/schylerchase/deep-plan-plugin.git
claude plugin install deep-plan@deep-plan-plugin

Codex Only

The deploy script is the easiest Codex path because Codex currently registers marketplaces separately from enabled plugin blocks:

./deploy.sh --codex-only --yes

Manual Codex install:

codex plugin marketplace add https://github.com/schylerchase/deep-plan-plugin
printf '\n[plugins."deep-plan@deep-plan-plugin"]\nenabled = true\n' >> ~/.codex/config.toml

Restart Codex after changing plugin configuration.

Troubleshooting

Windows — No ED25519 host key is known for github.com

Fresh Windows installs often hit this because SSH has never connected to GitHub before. Two fixes:

Option A — Use explicit HTTPS URLs (works for both plugins):

For Compound Engineering:

claude plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin.git
claude plugin install compound-engineering@compound-engineering-plugin

For deep-plan:

claude plugin marketplace add https://github.com/schylerchase/deep-plan-plugin
claude plugin install deep-plan@deep-plan-plugin

Option B — Trust GitHub's SSH host key (PowerShell):

ssh-keyscan -t ed25519,rsa github.com >> "$env:USERPROFILE\.ssh\known_hosts"

Then re-run the install.

Windows — Resetting a broken install (manual cleanup)

If a previous install attempt failed partway through and you're seeing stale marketplace errors, zombie marketplace cache directories, or SSH host-key failures from earlier attempts, run these steps in a regular (non-admin) PowerShell window. They're safe to re-run — "not installed" and "not found" errors during cleanup are expected and harmless.

1. Close Claude Code completely. All windows. Check Task Manager for leftover claude processes and kill any survivors — marketplace cache directories can be locked by a running instance.

2. Uninstall any stale CE and deep-plan plugins:

claude plugin uninstall compound-engineering
claude plugin uninstall deep-plan

3. Remove stale marketplace registrations:

claude plugin marketplace remove compound-engineering-plugin
claude plugin marketplace remove compound-engineering-claude-code-plugin
claude plugin marketplace remove deep-plan-plugin

4. Delete leftover marketplace cache directories from previous failed clones:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\marketplaces\compound-engineering-claude-code-plugin" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\marketplaces\compound-engineering-plugin" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\marketplaces\deep-plan-plugin" -ErrorAction SilentlyContinue

5. Reinstall Compound Engineering from the canonical HTTPS URL:

claude plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin.git
claude plugin install compound-engineering@compound-engineering-plugin

6. Reinstall deep-plan from the canonical HTTPS URL:

claude plugin marketplace add https://github.com/schylerchase/deep-plan-plugin.git
claude plugin install deep-plan@deep-plan-plugin

7. Verify both are registered:

claude plugin list