discovery-orchestrator

Coordinate codebase mapping and risk analyses into a consolidated memo.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/gaabscps/ai-squad --skill discovery-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discovery-orchestrator
Source: https://github.com/gaabscps/ai-squad/tree/main/squads/discovery/skills/discovery-orchestrator
Command: npx skills add https://github.com/gaabscps/ai-squad --skill discovery-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinates Phase 2 Investigate by orchestrating the sequential codebase mapper and parallel Cagan's Four Big Risks analyses, producing a consolidated memo.md and a gated handoff to Phase 3.

Core Features & Use Cases

  • End-to-end Investigate orchestration: mapper bootstrapping, risk fan-out, memo aggregation, and gate decision.
  • Supports resuming paused sessions by re-reading memo.md and session state, preserving progress.
  • Generates a structured memo with codebase mapping and risk verdicts to guide Phase 3 investment decisions.

Quick Start

Run the orchestrator for a validated session: /discovery-orchestrator DISC-NNN to start Phase 2, or /discovery-orchestrator DISC-NNN --resume to continue a paused session.

Frequently Asked Questions about discovery-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate risk analysis and codebase mapping during a discovery phase?

You can orchestrate risk analysis by dispatching a codebase mapper and four risk analysts to produce a consolidated memo with a gated handoff, coordinating the full Investigate phase end-to-end.

How do I resume a paused discovery session without losing previous investigation progress?

Resume a paused discovery session by running with the --resume flag to re-read memo.md and session state, preserving progress and continuing the investigation from where it stopped.

What is a gated handoff in product discovery and when is it needed?

A gated handoff in product discovery is a phase transition decision based on risk verdicts, needed when moving from Investigate to Phase 3 to ensure investment decisions are guided by consolidated risk analysis.

Do I need an existing session and memo file to start investigating risks?

Yes, you need a stored session at .agent-session/<spec_id> and a memo.md with phase_completed data, plus codebase-mapper and risk analyst outputs to begin orchestrating the investigation.

What happens to the session state when risk analysts return high-risk verdicts?

When risk analysts return high-risk verdicts, the orchestrator auto-advances or gates the session based on those verdicts, updating session.yml and writing input/output packets to control the phase transition.