Documentation Workflow
When to Use This Skill
Use this skill from the root session to run the whole documentation workflow, or to resume it at a named step. It is an alias: it adds no tool call, receipt or write authority of its own and dispatches to the seven skills below.
Prerequisites
Root steps run Invoke-DocsCommand.ps1 from the docs helper library that the Claude customization push-down delivers, under PowerShell 7.4 or later. Without that library every root step in this skill is unavailable; the docs MCP tools stay available.
Dispatch Order
Run the skills in this order. Each step names the role that runs it; a root step runs in the root session.
- docs-init (root): create and validate the docs profile.
- docs-inventory-surface (docs-architect): inventory the documented surface.
- docs-plan-ia (docs-architect): plan the information architecture.
- docs-author-page (docs-author): write and revise pages.
- docs-reconcile-behavior (docs-reconciler): record dispositions, pins and dimensions.
- docs-review-coverage (docs-coverage-reviewer): review coverage and accuracy.
- docs-validate (docs-coverage-reviewer or root): validate
docs-completefor the head revision.
Rules
- Pass each role its prepared inputs:
workspace_root, the profile path and the outputs of the earlier steps. - Read each role's report tokens before the next step. A
BLOCKEDorFAILresult stops the workflow until the cause is resolved. - Every write of a profile artifact goes through a root step or through
update_docs_ledger; no role writes the profile, the ledger, the matrix, the pins or a receipt directly.