Skip to content

Skill Execution Pipeline β€” Workflow

Quick Reference

graph TB

    Start(["Trigger: CLI or IDE command"])
    A["Step 1: Gather config\ntype, format, scope, language"]
    B["Step 2: Analyze codebase\nskills/analyze-codebase.md"]
    C["Step 3: Generate knowledge\npersonas, JTBD, flows"]
    D["Step 4: Generate tech docs\narchitecture, DB, deploy"]
    E["Step 5: Generate SOP guides\nKnowledge-enriched"]
    F["Step 6: Generate API ref\nEndpoints and schemas"]
    Decision{"Format?"}
    G["Export: Astro Starlight\nsetup-astro.md"]
    H["Export: Markdown\nexport-markdown.md"]
    End(["Complete documentation suite"])

    Start --> A --> B --> C --> D --> E --> F --> Decision
    Decision -->|"astro"| G --> End
    Decision -->|"markdown"| H --> End

Workflow summary: The pipeline starts with configuration gathering, then sequentially runs codebase analysis, knowledge generation, technical documentation, SOP guides, and API reference. Finally, it exports to either Astro Starlight or plain Markdown based on user choice.

StepActionSkill FileOutput
1Gather input (10 config questions)SKILL.md:42-82Config object
2Analyze codebase (scan, detect, map)skills/analyze-codebase.mddocs/analysis.md
3Generate knowledge layerpersona-builder.md, jtbd-analyzer.md, flow-mapper.mddocs/personas/, docs/jtbd/, docs/flows/
4Generate technical docsskills/tech-docs.mddocs/architecture.md, docs/database.md, etc.
5Generate SOP guidesskills/sop-guide.mddocs/sop/
6Generate API referenceskills/api-reference.mddocs/api/
7Export to chosen formatworkflows/setup-astro.md or workflows/export-markdown.mdastro-site/ or docs/