| name | docs-writer |
| version | 0.2.0 |
| description | Documentation workflow that converts requirements into structured AsciiDoc sections, runs Vale for style compliance, and produces merge-ready content. Use when creating or updating AsciiDoc documentation from Jira tickets, GitHub issues, or feature descriptions. |
Docs Writer Workflow Orchestrator
Quick Start
- If the user invoked a specific command (e.g.
/draft, /validate), read commands/{command}.md and follow it.
- Otherwise, read
skills/controller.md to load the workflow controller:
- If a
ticket_id is known, check .artifacts/${ticket_id}/ for existing artifacts and resume from the next incomplete phase (see "Resuming Work" in the controller)
- If the user provided a Jira ticket, GitHub issue URL, or feature description, execute the
/gather phase
- Otherwise, execute the first phase the user requests
If a step fails or produces unexpected output, stop and report the error to the
user. Do not advance to the next phase. Offer to retry the failed step or
escalate.
For principles, hard limits, safety, quality, and escalation rules, see guidelines.md.
