Documentation Workflows

Workflows for creating, restructuring, remediating, and reviewing documentation. Covers greenfield doc creation through multi-persona quality review.

How to Start

The doc workflow router classifies your doc state and recommends the right entry point:

• Greenfield (no docs exist) → docs-create.00_docs_plan_slicing_parallel

• Brownfield (RST exists, needs restructuring) → docs-restructure.00_readiness_content_audit

• Maintained (docs exist, need updating) → task.docs.docs-update

Or describe your intent directly:

• “Create documentation for this project” → docs-create suite

• “Restructure the existing docs” → docs-restructure suite

• “The docs are stale, audit and fix” → doc-remediation suite

• “Review the docs from a user’s perspective” → doc-persona-review suite

Docs Create

Build documentation from scratch with structured planning and Sphinx integration.

Step	Skill	What it does
0	docs-create.00_docs_plan_slicing_parallel	Inventory docs and code, classify tiers, slice into plans
1	docs-create.01_docs_plan_authoring_per_plan	Author one doc plan with tier classification and evidence
2	docs-create.02_docs_execution_per_plan	Execute a plan: write content using surface type templates
3	docs-create.03_sphinx_rst_man_plan_authoring	Plan Sphinx wiring: toctree, man pages, build config
4	docs-create.04_sphinx_rst_man_execution	Execute the Sphinx plan: conf.py, toctree, build validation

Docs Restructure

Reorganize existing RST documentation into a coherent structure.

Step	Skill	What it does
0	docs-restructure.00_readiness_content_audit	Audit Sphinx infrastructure and content completeness
1	docs-restructure.01_refactor_plan_slicing	Slice restructuring work into disjoint plans
2	docs-restructure.02_refactor_execution_per_plan	Execute each restructure plan
3	docs-restructure.03_build_validation_final_polish	Full rebuild, conformance certification, polish

Doc Remediation

Fix documentation gaps and quality issues with a structured multi-pass approach.

Step	Skill	What it does
0	doc_remediation.00_baseline_and_context	Establish baseline and gather context
1	doc_remediation.01_positioning_page	Create or fix the “Why this project?” page
2	doc_remediation.02_architecture_narrative	Create or fix the architecture overview
3	doc_remediation.03_workflow_narratives	Create or fix workflow narrative pages
4	doc_remediation.04_example_diversity	Improve example coverage and diversity
5	doc_remediation.05_cleanup_and_process	Fix cross-references, formatting, consistency
6	doc_remediation.06_validation	Final validation pass

Doc Persona Review

Multi-persona documentation review for quality assurance.

Step	Skill	What it does
0	doc_persona_review.00_select_personas	Define the persona roster for review
1	doc_persona_review.01_review_and_triage	Run review per persona, triage findings between passes
2	doc_persona_review.02_summary_and_next	Summarize findings and recommend next steps

See Also

• Skill Runtime — how skills are compiled and discovered

• Glossary — documentation tier definitions