flow-discover

{{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