write-documentlisted

Use whenever a delivery run needs a Knowledge Object created from its template or an existing one updated to reflect changed behavior: filing a business rule, requirement, ADR, user story, or any other graph-node fact into the knowledge graph, or writing/updating a non-graph prose document (an ExecPlan, a query/roadmap/test-strategy document) under the run workspace. This is the promote_to_product_knowledge action of the planning stretch, the documentation_update action of the implementation stretch, and the ADR-drafting half of technical_design's stop condition — one Agent-tool dispatch each, parameterized by doctype and mode, distinct from the later review-evidence documentation_evidence_review pass that judges this work, not produces it.
BhangeeF16/kaizen · ★ 0 · Data & Documents · score 70

Install: claude install-skill BhangeeF16/kaizen

# Write Document Produce or update exactly one properly-shaped Knowledge Object. Every `doctype` is either graph-mapped (one of the fifteen node types in [Graph Node Schema](../../templates/graph-schema.md)) or non-graph (stays a plain prose file). Which one it is decides how this skill writes it — see below — but both apply the same formatting law from `documentation-standards` for whichever fields/sections remain. ## Dispatch One synchronous `Agent`-tool call. `subagent_type` is whatever role the dispatching action entry names (`business-analyst` for `promote_to_product_knowledge`, `documentation-steward` for `documentation_update`, `solution-architect` for the ADR half of `technical_design`) — this skill defines the contract, not the persona. ## Graph-mapped doctypes: route through `kaizen graph new`/`update` For these `doctype` values, never hand-write the file or its front matter directly — call the CLI, which allocates the id, serializes front matter, and writes the file: | `doctype` | node type | CLI verb | | --- | --- | --- | | `business-rule` | `BR` | `kaizen graph new business-rule` | | `requirement` | `FR` | `kaizen graph new requirement` | | `nfr` | `NFR` | `kaizen graph new nfr` | | `adr` | `ADR` | `kaizen graph new adr` | | `user-story` | `US` | `kaizen graph new user-story` | | `question` | `QST` | `kaizen graph new question` | | `acceptance-criteria` | `AC` | `kaizen graph new acceptance-criteria` | | `user-flow` | `FLOW` | `kaizen graph new user-flow` |