octo-discover

Discover - Discovery Phase 🔍

🤖 INSTRUCTIONS FOR CLAUDE

MANDATORY COMPLIANCE — DO NOT SKIP

When the user explicitly invokes /octo:discover, you MUST execute the structured workflow below. You are PROHIBITED from doing the task directly, skipping the multi-provider research phase, or deciding the task is "too simple" for this workflow. The user chose this command deliberately — respect that choice.

EXECUTION MECHANISM — NON-NEGOTIABLE

You MUST execute this command by running the discovery workflow through orchestrate.sh. You are PROHIBITED from:

• ❌ Using the Agent tool to research/implement yourself instead of invoking the workflow
• ❌ Using WebFetch/Read/Grep as a substitute for multi-provider dispatch
• ❌ Skipping orchestrate.sh calls because "I can do this faster directly"
• ❌ Implementing the task using only Claude-native tools (Agent, Write, Edit)

Multi-LLM orchestration is the purpose of this command. If you execute using only Claude, you've violated the command's contract.

---

When the user invokes this command (e.g., /octo:discover <arguments>):

✓ CORRECT - Run the orchestrated probe workflow:

bash "${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh" probe <user's arguments>

Run this from the user's project directory — never cd into the plugin first. Dispatched providers sandbox file access to the invoking directory, so a plugin cwd makes the user's project files unreadable to every provider.

✗ INCORRECT:

Skill(skill: "octo:discover", ...)  ❌ Wrong here; recursive Skill dispatch can reload this command
Task(subagent_type: "octo:discover", ...)  ❌ Wrong! This is a command workflow, not an agent type

Step 1: Ask Clarifying Questions

CRITICAL: Before starting discovery, use the AskUserQuestion tool to gather context:

Ask 3 clarifying questions to ensure focused research:

AskUserQuestion({
  questions: [
    {
      question: "How thorough should the research be?",
      header: "Research Intensity",
      multiSelect: false,
      options: [
        {label: "Quick (1-2 min)", description: "2 agents — fast problem space scan"},
        {label: "Standard (2-4 min)", description: "4-5 agents — balanced multi-perspective coverage (recommended)"},
        {label: "Deep (3-6 min)", description: "6-7 agents — exhaustive analysis with web search"}
      ]
    },
    {
      question: "What's your primary focus area?",
      header: "Focus",
      multiSelect: false,
      options: [
        {label: "Technical implementation (Recommended)", description: "Code patterns, APIs, architecture"},
        {label: "Best practices", description: "Industry standards and conventions"},
        {label: "Ecosystem & tools", description: "Libraries, frameworks, community"},
        {label: "Trade-offs & comparisons", description: "Pros/cons analysis"}
      ]
    },
    {
      question: "How should the output be formatted?",
      header: "Output",
      multiSelect: false,
      options: [
        {label: "Detailed report (Recommended)", description: "Comprehensive write-up"},
        {label: "Summary", description: "Concise key findings"},
        {label: "Comparison table", description: "Side-by-side format"},
        {label: "Recommendations", description: "Actionable next steps"}
      ]
    }
  ]
})