dev-docs-flow

Dev Docs Flow

Generate a consistent docs package and execution flow by orchestrating existing skills. Do not duplicate guidance that already exists in other skills.

Process

Use the checklist below and track progress:

Docs-flow progress:
- [ ] Step 1: Confirm input and target output
- [ ] Step 2: Discover technical context
- [ ] Step 3: Run implementation gap analysis
- [ ] Step 4: Build docs artifact
- [ ] Step 5: Build flow artifact
- [ ] Step 6: Validate quality gates

Step 1: Confirm input and target output

• Parse the user request or command.
• If command is /docs-flow, treat it as a request for both artifacts:
  • Structured documentation artifact
  • Execution flow artifact
• If the user asks only for one artifact, produce only that artifact.

Step 2: Discover technical context

• Use technical-context-discovery to identify project instructions and existing patterns.
• Reuse repository conventions from AGENTS.md, existing skills/*, and local templates.
• Avoid inventing new workflow phases unless explicitly requested.

Step 3: Run implementation gap analysis

• Use implementation-gap-analysis to classify scope into:
  • To be implemented
  • To be modified
  • To be reused
• Use this classification as the core of planning and flow ordering.

Step 4: Build docs artifact

• Use references/docs-template.md as the default structure.
• Fill sections with repository-backed facts, assumptions, gaps, and acceptance criteria.
• Keep output concise and directly actionable.

Step 5: Build flow artifact

• Use references/flow-template.md as the default structure.
• Provide:
  • Mermaid flowchart
  • Ordered phase checklist
  • Decision gates and dependencies
• Ensure flow is runnable phase-by-phase.

Step 6: Validate quality gates

• Confirm every task in the docs has a matching element in the flow.
• Confirm each phase has explicit quality gates.
• Confirm output is aligned with current workflow:
  • Research
  • Plan
  • Implement
  • Review