identify-gaps-and-generate-epics

/identify-gaps-and-generate-epics

Scan documentation sources, analyze codebase implementation, identify gaps, and generate actionable epics with deep reasoning.

---

Purpose

This command orchestrates a comprehensive gap analysis workflow that:

1. Discovers Requirements - Scans local documentation and Obsidian vault for requirements, specifications, and architectural decisions
2. Analyzes Implementation - Inventories existing codebase features, patterns, and capabilities
3. Identifies Gaps - Compares documented requirements against actual implementation to find missing features, incomplete implementations, and architectural drift
4. Generates Epics - Uses sequential-thinking MCP to create detailed, prioritized epics with dependencies, user stories, and implementation strategies
5. Produces Deliverables - Outputs gap analysis reports, priority matrices, and epic specifications ready for backlog integration

Best for: Organizations scaling development across multiple teams, ensuring alignment between requirements and implementation, and establishing sustainable backlog management practices.

---

Multi-Agent Coordination Strategy

This command uses the Blackboard Pattern for multi-agent coordination, where specialized agents contribute to a shared workspace:

graph TD
    BB[Blackboard<br/>Shared Workspace]

    %% Phase 1: Documentation Discovery
    R1[researcher-1<br/>Local Docs]
    R2[researcher-2<br/>Obsidian Vault]
    R3[researcher-3<br/>API Specs]

    %% Phase 2: Codebase Analysis
    REV[reviewer<br/>Feature Inventory]
    SA[system-architect<br/>Architecture State]
    BD[backend-dev<br/>Code Patterns]

    %% Phase 3: Gap Detection
    SEC[security-auditor<br/>Risk Assessment]
    REV2[reviewer<br/>Gap Categorization]
    SA2[system-architect<br/>Dependency Mapping]

    %% Phase 4: Epic Generation
    PO[product-owner<br/>Epic Synthesis]
    PLAN[planner<br/>Prioritization]
    DW[docs-writer<br/>Epic Documentation]
    SEQ[sequential-thinking<br/>MCP Reasoning]

    %% Phase 5: Output Generation
    DA[data-analyst<br/>Reports & Matrices]

    %% Connections
    R1 --> BB
    R2 --> BB
    R3 --> BB

    BB --> REV
    BB --> SA
    BB --> BD

    REV --> BB
    SA --> BB
    BD --> BB

    BB --> SEC
    BB --> REV2
    BB --> SA2

    SEC --> BB
    REV2 --> BB
    SA2 --> BB

    BB --> PO
    BB --> PLAN
    BB --> DW
    BB --> SEQ

    PO --> BB
    PLAN --> BB
    DW --> BB
    SEQ --> BB

    BB --> DA
    DA --> OUT[Epic Files<br/>Reports<br/>Matrices]

    style BB fill:#f9f,stroke:#333,stroke-width:4px
    style SEQ fill:#ff9,stroke:#333,stroke-width:2px
    style OUT fill:#9f9,stroke:#333,stroke-width:2px