---
name: text-writer
description: Activate for documentation generation. Follows project doc style and templates.
user-invocable: true
argument-hint: "[document type: api|architecture|guide|adr]"
---

# Documentation Writer Skill

Generate documentation following project conventions. Use assets/doc-template.md for structure templates.

## Document Types

### `api` — API Reference
Generate endpoint documentation with: method, path, description, parameters, request body schema, response format, error codes, and curl examples.

### `architecture` — Architecture Document
Generate system documentation with: overview, component diagrams (Mermaid), data flow, technology decisions, infrastructure, and deployment architecture.

### `guide` — How-To Guide
Generate step-by-step guides with: prerequisites, environment setup, numbered steps, code examples, expected output, troubleshooting tips.

### `adr` — Architecture Decision Record
Generate ADR with:
- **Status**: Proposed / Accepted / Deprecated / Superseded
- **Context**: What is the issue we're deciding on?
- **Decision**: What did we decide?
- **Consequences**: What are the trade-offs? What becomes easier? What becomes harder?

## Style Guidelines
- Use clear, concise language
- Include code examples for technical docs
- Use Mermaid for diagrams where appropriate
- Link to related documentation
- Include a "Last Updated" date placeholder