Workflow Diagram
graph TD
Start([Input: Epic Description + Story Domain]) --> Phase1[Phase 1: Identify Libraries]
Phase1 --> Parse[Parse Epic Technical Notes
+ Scope In + Goal]
Parse --> ExtractLibs[Extract Library List
3-5 libraries max]
ExtractLibs --> Domain[Determine Story Domain
e.g., rate limiting]
Domain --> SkipCheck{Libraries
found?}
SkipCheck -->|No| EmptySummary[Output: Empty Research Summary]
SkipCheck -->|Yes| Phase2[Phase 2: MCP Context7 Research]
Phase2 --> LoopLibs[FOR EACH Library]
LoopLibs --> ResolveID[resolve-library-id
libraryName]
ResolveID --> GetDocs[get-library-docs
libraryID, topic, tokens=3000]
GetDocs --> ExtractAPI[Extract:
- Latest version
- Key APIs 2-5
- Constraints
- Deprecations]
ExtractAPI --> Fallback{Found in
Context7?}
Fallback -->|No| WebSearch[Fallback: WebSearch
library latest version API]
Fallback -->|Yes| Phase3[Phase 3: MCP Ref Research]
WebSearch --> Phase3
Phase3 --> RefSearch[ref_search_documentation
library + domain best practices]
RefSearch --> RefStandards[ref_search_documentation
domain standards RFC]
RefStandards --> ExtractStandards[Extract:
- Industry standards
- Common patterns
- Security considerations
- Integration approaches]
ExtractStandards --> Phase4[Phase 4: Scan Existing Guides]
Phase4 --> GlobGuides[Glob docs/guides/*.md]
GlobGuides --> MatchDomain[Match guides to Story domain
fuzzy match]
MatchDomain --> CollectPaths[Collect guide paths]
CollectPaths --> Phase5[Phase 5: Generate Research Summary]
Phase5 --> CompileTable[Compile:
- Library table version, purpose
- Key APIs list
- Constraints list
- Standards compliance
- Existing guides links]
CompileTable --> FormatMD[Format as Markdown]
FormatMD --> End([Output: Research Summary
for Technical Notes])
EmptySummary --> End
style Start fill:#4A90E2,stroke:#2E5C8A,color:#fff
style End fill:#26A69A,stroke:#1B5E20,color:#fff
style Phase1 fill:#7E57C2,stroke:#4A148C,color:#fff
style Phase2 fill:#7E57C2,stroke:#4A148C,color:#fff
style Phase3 fill:#7E57C2,stroke:#4A148C,color:#fff
style Phase4 fill:#7E57C2,stroke:#4A148C,color:#fff
style Phase5 fill:#7E57C2,stroke:#4A148C,color:#fff
style SkipCheck fill:#FF9800,stroke:#E65100,color:#fff
style Fallback fill:#FF9800,stroke:#E65100,color:#fff
style WebSearch fill:#FFC107,stroke:#F57C00,color:#000
style EmptySummary fill:#9E9E9E,stroke:#424242,color:#fff