AI-assisted document authoring pipeline. Orchestrates excalidraw, vega, and confluence skills through a 5-phase workflow: explore → propose → generate → iterate → publish. Use when the user wants to create a structured document with diagrams, charts, and prose, and publish it to Confluence.
A 5-phase SDD framework for creating rich documents with diagrams, charts, and prose, then publishing them to Confluence.
/docflow:explore ──▶ /docflow:propose ──▶ /docflow:generate ──▶ /docflow:iterate ──▶ /docflow:publish
(think) (plan) (create) (refine) (ship)
All paths are relative to the workspace root.
| Asset | Path | Purpose |
|---|---|---|
| Phase guide | skills/docflow/references/phase-guide.md | Detailed phase descriptions, transitions, prerequisites |
| Artifact tagging | skills/docflow/references/artifact-tagging.md | Tag syntax ([diagram:name], [chart:name]) |
| CLI entry point |
skills/docflow/scripts/docflow_cli.py |
| Main CLI with subcommands |
| New project | skills/docflow/scripts/new_project.py | Create project directory + .docflow.yaml |
| Status | skills/docflow/scripts/status.py | Show project status, list projects |
| Instructions | skills/docflow/scripts/instructions.py | Phase-specific instructions + templates |
| Advance | skills/docflow/scripts/advance.py | Phase transitions + artifact status |
| Parse plan | skills/docflow/scripts/parse_plan.py | Extract artifact tags from plan.md |
| Generate tasks | skills/docflow/scripts/generate_tasks.py | Auto-generate tasks.md from plan |
| spec.md template | skills/docflow/templates/spec.md | Content brief template |
| plan.md template | skills/docflow/templates/plan.md | Document outline template |
| tasks.md template | skills/docflow/templates/tasks.md | Generation checklist template |
Invoke via: python skills/docflow/scripts/docflow_cli.py <command>
| Command | Description |
|---|---|
new <name> | Create a new project at docflow/<name>/ |
status [--project <name>] [--json] | Show project phase and artifact status |
list [--json] | List all projects |
instructions <phase> [--project <name>] [--json] | Get phase-specific instructions |
advance [--project <name>] | Transition to next phase |
mark-done <artifact> [--project <name>] | Mark an artifact as complete |
docflow/<project-name>/
.docflow.yaml ← State file (phase, artifacts, metadata)
spec.md ← Content brief + requirements
plan.md ← Document outline with artifact tags
tasks.md ← Generation checklist
artifacts/
sections/ ← Generated markdown sections
diagrams/ ← Generated .excalidraw files
charts/ ← Generated .vega.json files
Each phase has a dedicated prompt and skill file:
| Phase | Prompt | Skill |
|---|---|---|
| Explore | .github/prompts/docflow-explore.prompt.md | .github/skills/docflow-explore/SKILL.md |
| Propose | .github/prompts/docflow-propose.prompt.md | .github/skills/docflow-propose/SKILL.md |
| Generate | .github/prompts/docflow-generate.prompt.md | .github/skills/docflow-generate/SKILL.md |
| Iterate | .github/prompts/docflow-iterate.prompt.md | .github/skills/docflow-iterate/SKILL.md |
| Publish | .github/prompts/docflow-publish.prompt.md | .github/skills/docflow-publish/SKILL.md |
During generate and iterate phases, docflow delegates to:
| Artifact Type | Delegated Skill |
|---|---|
.excalidraw diagrams | skills/excalidraw/SKILL.md |
.vega.json charts | skills/vega/SKILL.md |
| Confluence publishing | skills/confluence/SKILL.md |
.md sections | Generated directly (no delegation) |