Skip to content

Doc Generation — Sequence Flow

Documentation Generation — Sequence Flow

Section titled “Documentation Generation — Sequence Flow”

Quick Reference

  • Trigger: User invokes DocKit Master in AI IDE
  • Components: 6 participants
  • Total Steps: 14
sequenceDiagram
    autonumber

    actor User
    participant CLI as CLI Script
    participant SK as SKILL.md
    participant AN as Analyze Skill
    participant KN as Knowledge Skills
    participant GN as Doc Gen Skills
    participant EX as Export Workflow

    User->>CLI: Run dockit-master.sh
    CLI->>CLI: Gather config (type, format, scope)
    CLI-->>User: Generated prompt (clipboard)

    User->>SK: Paste prompt in AI IDE
    SK->>AN: Step 2 - Analyze codebase
    AN->>AN: Scan dirs, detect stack, map routes
    AN-->>SK: analysis.md

    SK->>KN: Step 4a - Build personas
    KN-->>SK: personas/
    SK->>KN: Step 4b - Extract JTBD
    KN-->>SK: jtbd/
    SK->>KN: Step 4c - Map flows
    KN-->>SK: flows/

    SK->>GN: Step 4d-f - Generate docs
    GN-->>SK: architecture.md, sop/, api/

    SK->>EX: Step 5 - Export
    EX->>EX: Build Astro site
    EX-->>User: Docs site at localhost:4321

Sequence summary: The user runs the CLI to generate a prompt, pastes it into their AI IDE, and the SKILL.md orchestrator sequentially invokes analysis, knowledge, documentation, and export skills. Each skill reads previous output for enrichment.

#FromToAction
1UserCLIRun dockit-master.sh
2CLICLIGather 6 config parameters
3CLIUserCopy prompt to clipboard
4UserSKILL.mdPaste prompt in AI IDE
5-7SKILL.mdAnalyzeScan, detect, map
8-10SKILL.mdKnowledgePersonas, JTBD, Flows
11-12SKILL.mdDoc GenTech, SOP, API
13-14SKILL.mdExportBuild and serve