/flow-discover

name: flow-discover
description: "Multi-AI research using available external providers (Double Diamond Discover phase)"
disable-model-invocation: true

> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex. > Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands. > Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it. > For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.

{{PREAMBLE}}

Compaction-Resistant Contract

• Dispatch MUST go through background agents that call `${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh probe-single`; direct single-model research is not a valid substitute.
• Use the dynamic fleet from `build-fleet.sh`; the plugin can route across Codex, Antigravity, Copilot, Qwen, OpenCode, Ollama, Perplexity, OpenRouter, Cursor Agent, and Claude depending on local availability.
• Before synthesis, run `${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh agent-summary` and use only providers reported as `ok`, `degraded`, or `timeout` with usable output.
• For `standard` and `deep` research, require at least 2 usable provider outputs unless fewer providers are installed; failed/rejected providers are reported as gaps, not cited as evidence.

Pre-Discovery: Optional Project Persistence

Workflow state is stored in the host workspace by default. Only create the project-local `.octo/` lifecycle artifacts when the user explicitly opts in by setting `OCTOPUS_PROJECT_PERSISTENCE=true`.

if [[ "${OCTOPUS_PROJECT_PERSISTENCE:-false}" == "true" ]]; then
  if [[ ! -d ".octo" ]]; then
    echo "📁 Initializing opt-in .octo/ project state..."
    if ! "${HOME}/.claude-octopus/plugin/scripts/octo-state.sh" init_project; then
      echo "Discover incomplete: could not initialize opt-in project state." >&2
      exit 1
    fi
  fi
  if ! "${HOME}/.claude-octopus/plugin/scripts/octo-state.sh" update_state \
      --phase 1 \
      --position "Discovery" \
      --status "in_progress"; then
    echo "Discover incomplete: could not persist in-progress state." >&2
    exit 1
  fi
fi

Native Plan Mode Compatibility (v7.23.0+)

**IMPORTANT:** claude-octopus workflows are designed to persist across context clearing.

Detecting Native Plan Mode

Check if native plan mode is active:

# Check for native plan mode markers
if [[ -n "${PLAN_MODE_ACTIVE}" ]] || claude-code plan status 2>/dev/null | grep -q "active"; then
    echo "⚠️  Native plan mode detected"
    echo ""
    echo "   Resolve Claude Octopus workflow state with: octopus state-path"
    echo "   State will persist across plan mode context clears"
    echo "   Multi-AI orchestration will continue normally"
    echo ""
fi

State Persistence Across Context Clearing

**How it works:**

• Native plan mode may clear Claude's memory via `ExitPlanMode`
• Claude Octopus workflow state persists in the host workspace, namespaced by project; resolve its exact path with `state-manager.sh state_path`
• Each workflow phase reads prior state at startup
• Context is automatically restored from files

**No action required** - state management handles this automatically via STEP 3 in the execution contract.

⚠️ EXECUTION CONTRACT (MANDATORY - CANNOT SKIP)

This skill uses **ENFORCED execution mode**. You MUST follow this exact sequence.

STEP 1: Detect Work Context (MANDATORY)

Analyze the user's prompt and project to determine context:

**Knowledge Context Indicators**:

• Business/strategy terms: "market", "ROI", "stakeholders", "strategy", "competitive", "business case"
• Research terms: "literature", "synthesis", "academic", "papers", "personas", "interviews"
• Deliverable terms: "presentation", "report", "PRD", "proposal", "executive summary"

**Dev Context Indicators**:

• Technical terms: "API", "endpoint", "database", "function", "implementation", "library"
• Action terms: "implement", "debug", "refactor", "build", "deploy", "code"

**Also check**: Does project have `package.json`, `Cargo.toml`, etc.? (suggests Dev Context)

**Capture context_type = "Dev" or "Knowledge"**

**DO NOT PROCEED TO STEP 2 until context determined.** Context type (Dev vs Knowledge) determines which provider prompts to use — wrong context produces irrelevant research that wastes provider credits.

STEP 2: Display Visual Indicators (MANDATORY - BLOCKING)

**MANDATORY: You MUST use the native shell command tool to run this provider check BEFORE displaying the banner. Do NOT skip it. Do NOT assume availability.**

bash "${HOME}/.claude-octopus/plugin/scripts/helpers/check-providers.sh"

**Use the ACTUAL results below. PROHIBITED: Showing only "🔵 Claude: Available ✓" without listing all providers.**

If `OCTO_ALLOWED_PROVIDERS` is set, treat it as the source of truth for which providers may participate. Providers filtered out by that allowlist are intentionally reported as unavailable; do not invoke or recommend them in the workflow.

**Display this banner BEFORE orchestrate.sh execution:**

**For Dev Context:**

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Dev] Discover Phase: [Brief description of technical research]

Provider Availability:
🔴 Codex CLI: ${codex_status}
🟡 Antigravity CLI: ${agy_status}
🧭 Antigravity CLI: ${agy_status}
🟣 Perplexity: ${perplexity_status}
🔵 Claude: Available ✓ (Strategic synthesis)

💰 Estimated Cost: $0.01-0.08
⏱️  Estimated Time: 2-5 minutes

**For Knowledge Context:**

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Knowledge] Discover Phase: [Brief description of strategic research]

Provider Availability:
🔴 Codex CLI: ${codex_status}
🟡 Antigravity CLI: ${agy_status}
🧭 Antigravity CLI: ${agy_status}
🟣 Perplexity: ${perplexity_status}
🔵 Claude: Available ✓ (Strategic synthesis)

💰 Estimated Cost: $0.01-0.08
⏱️  Estim