Skill Execution Pipeline β Workflow
Skill Execution Pipeline β Workflow
Section titled βSkill Execution Pipeline β WorkflowβQuick Reference
- Persona: AI Agent Alex
- JTBD: Systematize codebase knowledge
- Trigger: User runs CLI or invokes /DocKit Master command
- Outcome: Complete documentation suite in docs/ or astro-site/
Process Flow
Section titled βProcess Flowβ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.
Step Details
Section titled βStep Detailsβ| Step | Action | Skill File | Output |
|---|---|---|---|
| 1 | Gather input (10 config questions) | SKILL.md:42-82 | Config object |
| 2 | Analyze codebase (scan, detect, map) | skills/analyze-codebase.md | docs/analysis.md |
| 3 | Generate knowledge layer | persona-builder.md, jtbd-analyzer.md, flow-mapper.md | docs/personas/, docs/jtbd/, docs/flows/ |
| 4 | Generate technical docs | skills/tech-docs.md | docs/architecture.md, docs/database.md, etc. |
| 5 | Generate SOP guides | skills/sop-guide.md | docs/sop/ |
| 6 | Generate API reference | skills/api-reference.md | docs/api/ |
| 7 | Export to chosen format | workflows/setup-astro.md or workflows/export-markdown.md | astro-site/ or docs/ |