Über
doc-writer ist ein Community-Skill, der READMEs, ADRs und Tutorials nach einer konsistenten Stilvorlage schreibt. Er kennt typische Stolperfallen generativer Texte — passive Sprache, Buzzwords, leere Behauptungen — und verlangt aktive Stimmen mit beweisbaren Aussagen. Beim Anlegen eines neuen ADR folgt er dem bewährten Vier-Absatz-Schema mit Status, Kontext, Entscheidung und Konsequenzen.
Praxisbeispiel
Du entscheidest dich, vom Monolithen zu zwei Service-Modulen zu wechseln, und willst die Begründung festhalten. Der Skill legt unter docs/adr/0007-service-split.md einen Eintrag mit Status "Proposed", einem knappen Kontext (Warum), der Entscheidung (Was) und einer Konsequenz-Liste mit drei Punkten an. Auf Wunsch zieht er daraus eine TOC-Zeile und ein Mermaid-Diagramm.
Stärken
- Macht Doku zum aktiven Artefakt — nicht zur verstaubten Pflicht.
- Konsistenter Ton auch über mehrere Autoren hinweg.
Schwächen
- Generierte ADRs sind ein guter Startpunkt, brauchen aber Diskussion und Review durch den Menschen.