# /write-docs - Technical Documentation & API Reference Writer

> OpenAPI 3.0 specs, developer guides, code samples, and architecture docs.

Canonical: https://www.agentickit.co/commands/write-docs
Last updated: 2026-11-18

Produces clear developer documentation: OpenAPI 3.0 schemas, interactive curl examples, system architecture guides, and SDK quickstarts.

**Usage:** `Use to keep codebase documentation updated as new features and APIs ship.`

## Pipeline
1. Scan API routes and TypeScript interfaces to extract schema definitions
2. Generate OpenAPI 3.0 YAML/JSON specification with example payloads
3. Write step-by-step developer tutorial with copy-paste code snippets
4. Create Mermaid architecture diagram visualizing request lifecycles

## Output files
- `docs/api/openapi.json`
- `docs/guides/quickstart.md`

**Claude Code frontmatter:** `argument-hint: [doc target and audience]` · `model: inherit`

## Related
- [technical-writer](https://www.agentickit.co/agents/technical-writer)
- [tech-lead](https://www.agentickit.co/agents/tech-lead)
- [technical-docs](https://www.agentickit.co/skills/technical-docs)
- [project-conventions](https://www.agentickit.co/skills/project-conventions)
