doc

Generate OpenAPI specs, interactive API docs, and SDK templates

Create comprehensive system architecture documentation

Code explanation and analysis

Automated documentation generation

Create exhaustive parameter and configuration reference documentation

Rewrite a markdown document following Amazon's narrative writing standards

Create step-by-step tutorials and educational content

Create OpenAPI specifications, interactive API documentation, and developer portal experiences. Generate SDKs and try-it-now consoles. <example>Context: User needs API specification. user: "Create an OpenAPI spec for our REST API" assistant: "I'll use api-documenter to generate a comprehensive OpenAPI 3.1 specification" <commentary>OpenAPI generation - api-documenter creates machine-readable specs.</commentary></example> <example>Context: User wants interactive docs. user: "Build interactive API documentation with try-it-now" assistant: "Let me dispatch api-documenter to create interactive API explorer documentation" <commentary>Interactive docs - try-it-now consoles and live testing.</commentary></example> <example>Context: User needs SDK documentation. user: "Generate SDK stubs from this API spec" assistant: "I'll use api-documenter to create SDK templates for multiple languages" <commentary>SDK generation - code samples and client libraries from specs.</commentary></example> <example>Context: User needs auth flow docs. user: "Document our OAuth2 authentication flow" assistant: "Let me use api-documenter to create OAuth2 integration documentation" <commentary>Auth documentation - security flows with working examples.</commentary></example>

Auto-detects and generates Mermaid diagrams that help Claude execute complex plans. Focuses on execution aid, not visual appeal. Skips diagrams when they add no value.

Create comprehensive long-form technical documentation that explains system architecture, design decisions, and the "why" behind complex systems. <example>Context: User needs system documentation. user: "Document our payment processing system architecture" assistant: "I'll use docs-architect to create comprehensive architectural documentation" <commentary>System architecture - docs-architect creates narrative documentation explaining design.</commentary></example> <example>Context: User needs to explain design decisions. user: "Write documentation explaining why we chose microservices over monolith" assistant: "Let me dispatch docs-architect to document the architectural decision and rationale" <commentary>Design rationale - docs-architect explains the "why" behind decisions.</commentary></example> <example>Context: User needs onboarding documentation. user: "Create a technical guide for new engineers to understand our system" assistant: "I'll use docs-architect to create an architectural overview for onboarding" <commentary>System overview - long-form narrative for understanding the whole system.</commentary></example> <example>Context: User needs to document a codebase. user: "Write technical documentation for this repository" assistant: "Let me use docs-architect to analyze the codebase and create comprehensive documentation" <commentary>Codebase documentation - architecture, patterns, and design from code analysis.</commentary></example>

Generate Mermaid diagram code for any visualization need. Use for flowcharts, sequence diagrams, ERDs, state machines, and more. <example>Context: User needs to visualize a database schema. user: "Create an ERD for our user and orders tables" assistant: "I'll use the mermaid-expert agent to generate the entity relationship diagram" <commentary>Database schema visualization - mermaid-expert generates the ERD code.</commentary></example>

Create exhaustive technical reference documentation with parameter tables, configuration matrices, and searchable lookup material. <example>Context: User needs complete API parameter documentation. user: "Document all parameters for the createUser endpoint" assistant: "I'll use reference-builder to create an exhaustive parameter reference table" <commentary>Parameter table generation - reference-builder creates lookup-optimized docs.</commentary></example> <example>Context: User needs configuration documentation. user: "List all environment variables and their valid values" assistant: "Let me dispatch reference-builder to create a complete configuration reference" <commentary>Configuration matrix - reference-builder documents every option with defaults.</commentary></example> <example>Context: User needs error code reference. user: "Create a reference of all error codes this API can return" assistant: "I'll use reference-builder to generate an error code lookup table" <commentary>Error code table - searchable reference for debugging.</commentary></example> <example>Context: User needs CLI reference. user: "Document all the command-line flags for this tool" assistant: "Let me use reference-builder to create a complete CLI parameter reference" <commentary>CLI flag documentation - exhaustive with examples per flag.</commentary></example>

Reference guide for Mermaid diagram syntax. Load when generating diagrams.

Create step-by-step tutorials, workshops, and educational content that transforms learners from confused to confident. <example>Context: User needs onboarding documentation. user: "Create a getting started guide for new developers" assistant: "I'll use tutorial-engineer to create a progressive onboarding tutorial" <commentary>Onboarding guide - tutorial-engineer creates step-by-step learning content.</commentary></example> <example>Context: User wants to teach a feature. user: "Write a tutorial on how to use our authentication system" assistant: "Let me dispatch tutorial-engineer to create a hands-on authentication tutorial" <commentary>Feature tutorial - progressive learning with exercises.</commentary></example> <example>Context: User needs workshop content. user: "Create a 2-hour workshop on building REST APIs" assistant: "I'll use tutorial-engineer to design a workshop with exercises and checkpoints" <commentary>Workshop format - structured learning with practice activities.</commentary></example> <example>Context: User wants to explain a concept. user: "Help developers understand async/await with examples" assistant: "Let me use tutorial-engineer to create an async/await tutorial with progressive examples" <commentary>Concept explanation - build understanding through hands-on coding.</commentary></example>

Use when writing narrative memos, 6-pagers, 1-pagers, press releases, or PRFAQs in Amazon style. Applies Amazon's no-PowerPoint writing standards with data over adjectives, active voice, and the "so what" test.