Guided workflow to create, review, update, or extend any document from a curated template library. Routes to the correct subflow based on the user's selection. Invoke when the user wants to write, improve, or add to a document.
Presents a template and operation menu, collects the document subject, and routes to the appropriate subflow. All file writes require explicit user approval of the target location before execution.
Ask the user what the document is about:
What is the document subject or purpose?
(e.g. "a Node.js REST API for managing orders", "the checkout service architecture")
Hold the subject as context for the activated subflow.
What would you like to do?
1. Write a new document
2. Review an existing document
3. Update an existing document
4. Add content to an existing document
Enter 1–4:
If the user selected 1:
Select a document template:
1. Git README.md — discoverable project readme optimised for GitHub/GitLab
2. Mermaid diagram — architecture, flow, sequence, or state diagram
3. ADR — Architecture Decision Record
4. Other — describe the document type you need
Enter 1–4:
1 → load subflows/document-readme-sf.md, pass the subject.2 → activate mermaid-wf, pass the subject.3 → load subflows/document-adr-sf.md, pass the subject.4 → ask: "Describe the document type (e.g. runbook, API reference, onboarding guide)." Then load subflows/document-readme-sf.md with a generic document mode, or inform the user that this template is not yet available and suggest the closest match.If the user selected 2 → load subflows/document-audit-sf.md.
If the user selected 3 → load subflows/document-update-sf.md.
If the user selected 4 → load subflows/document-extend-sf.md.
For operations 2–4, ask: Path to the existing document: before loading the subflow.
After the subflow completes, ask:
Anything else? (select another operation or "done")
Return to Step 2 on any new request. Exit on "done".
| File | Load when |
|---|---|
subflows/document-adr-sf.md | User wants to create an Architecture Decision Record |
subflows/document-readme-sf.md | User wants to draft a Git README.md |
subflows/document-audit-sf.md | User wants to review an existing document |
subflows/document-update-sf.md | User wants to update sections of an existing document |
subflows/document-extend-sf.md | User wants to add content to an existing document |
document-sme — SME for document structure, technical writing standardsmermaid-wf — generates Mermaid diagram codediagram-sme — SME for diagram type selection and design decisions