octo

Claude Octopus

Every model has blind spots. Claude Octopus fills them by orchestrating Codex, Gemini, and Claude together — three perspectives, adversarial review, and consensus gathering so no single model's gaps slip through.

---

Quickstart

Install — inside Claude Code or from your terminal:

/plugin marketplace add https://github.com/nyldn/claude-octopus.git
/plugin install claude-octopus@nyldn-plugins

Then run setup:

/octo:setup

Setup detects installed providers, shows what's missing, and walks you through configuration. You need zero external providers to start — Claude is built in. Add Codex or Gemini for multi-AI features.

Try it now:

/octo:research OAuth 2.1 patterns          # Multi-source synthesis
/octo:review                                # Code review with security analysis
/octo:debate monorepo vs microservices      # Three-way AI debate

---

What It Does

Five commands that show the full range:

/octo:embrace build stripe integration     # Full lifecycle: research -> PRD -> code -> review
/octo:research htmx vs react in 2026       # Triple-perspective synthesis from 3 providers
/octo:tdd create user auth                 # Disciplined red-green-refactor orchestration
/octo:debate monorepo vs microservices     # Formal adversarial debate between AI providers
/octo:deck q3 product strategy             # Brief -> research -> outline gate -> PPTX export

Each command orchestrates up to three AI providers, applies quality gates, and produces a deliverable. Here's the full set:

Core Commands

Command	What it does
/octo:embrace	Full 4-phase workflow: discover, define, develop, deliver
/octo:research	Deep multi-source research with synthesis
/octo:review	Multi-perspective code review
/octo:tdd	Test-driven development with red-green-refactor
/octo:debug	Systematic 4-phase debugging
/octo:security	OWASP vulnerability scan
/octo:debate	Structured three-way AI debate
/octo:prd	AI-optimized PRD with 100-point scoring
/octo:extract	Reverse-engineer design systems from code or URLs
/octo:deck	Slide deck generation with outline approval gate
/octo:docs	Export to PPTX, DOCX, PDF
/octo:schedule	Scheduled workflow runner with cron, budget gates, kill switches
/octo:brainstorm	Creative thought partner session
doctor	Environment diagnostics — 8 check categories with filtering and JSON output

Don't remember the command name? Just describe what you need:

/octo research microservices patterns    -> routes to discover phase
/octo build user authentication          -> routes to develop phase
/octo compare Redis vs DynamoDB          -> routes to debate

The smart router parses your intent and selects the right workflow.

Full command reference (39 commands)

---

How It Works

Three Providers, One Workflow

Claude Octopus coordinates Codex (OpenAI), Gemini (Google), and Claude (Anthropic) across every workflow. Each provider has a distinct role:

Provider	Role
Codex	Implementation depth — code patterns, technical analysis, architecture
Gemini	Ecosystem breadth — alternatives, security review, research synthesis
Claude	Orchestration — quality gates, consensus building, final synthesis

Providers run in parallel for research, sequentially for problem scoping, and adversarially for review. A 75% consensus quality gate prevents questionable work from shipping.

Double Diamond Phases

Four structured phases adapted from the UK Design Council's methodology:

Phase	Command	What happens
Discover	/octo:discover	Multi-AI research and broad exploration
Define	/octo:define	Requirements clarification with consensus
Develop	/octo:develop	Implementation with quality gates
Deliver	/octo:deliver	Adversarial review and go/no-go scoring

Run phases individually or all four with /octo:embrace. Configure autonomy: supervised (approve each phase), semi-autonomous (intervene on failures), or autonomous (run all four).

29 Personas

Specialized agents that activate automatically based on your request. When you say "audit my API for vulnerabilities," security-auditor activates. When you say "write a research paper," academic-writer takes over.