Skip to main content
4 specialized agents covering documentation architecture, API references, technical writing, and visual diagrams.

​
Agents

Technical Writer

Technical documentation, API references, user guides, and SDK docs
  • Mode: subagent
  • Quality: 4.25/5 (Good)
  • Tags: technical-writing, documentation, api-reference, user-guides, sdk
npx github:dmicheneau/opencode-template-agent install technical-writer

API Documenter

API documentation, OpenAPI specs, and interactive documentation portals
  • Mode: subagent
  • Quality: 4.62/5 (Excellent)
  • Tags: api-docs, openapi, swagger, documentation, code-examples
npx github:dmicheneau/opencode-template-agent install api-documenter

Documentation Engineer

Documentation systems architecture including guides, tutorials, and APIs
  • Mode: subagent
  • Quality: 4.38/5 (Good)
  • Tags: documentation, architecture, tutorials, guides, developer-docs
npx github:dmicheneau/opencode-template-agent install documentation-engineer

Diagram Architect

C4 models, Mermaid diagrams, PlantUML, and architecture visualization
  • Mode: subagent
  • Quality: 4.62/5 (Excellent)
  • Tags: diagrams, c4, mermaid, plantuml, architecture, visualization
npx github:dmicheneau/opencode-template-agent install diagram-architect

​
Usage Examples

@docs/technical-writer Write a user guide for authentication

​
Quality Stats

  • Average score: 4.47/5
  • 2 Excellent, 2 Good rating
  • Total tokens: ~4,500 (avg ~1,125 per agent)
  • Coverage: Writing + API docs + architecture + systems

​
Common Workflows

Complete documentation + architecture:
npx github:dmicheneau/opencode-template-agent install --pack architecture-docs
Includes: microservices-architect, api-architect, database-architect, diagram-architect, documentation-engineer
  1. API Architect — Design API
  2. API Documenter — Write API documentation and OpenAPI spec
  3. Technical Writer — User guides and tutorials
  4. Diagram Architect — API flow diagrams
  1. Diagram Architect — Architecture diagrams (C4 model)
  2. Documentation Engineer — Documentation site structure
  3. Technical Writer — Guides and tutorials
  4. API Documenter — API reference
  1. Documentation Engineer — Information architecture
  2. API Documenter — Interactive API reference
  3. Technical Writer — Getting started guides
  4. Diagram Architect — Visual explanations

​
When to Use

  • Writing user guides and tutorials
  • Creating SDK documentation
  • Documenting features for end users
  • Writing release notes
  • Creating README files
  • Writing API reference documentation
  • Creating OpenAPI/Swagger specs
  • Building interactive API explorers
  • Documenting REST/GraphQL APIs
  • Generating code examples
  • Designing documentation systems
  • Building docs-as-code pipelines
  • Selecting documentation tools (Docusaurus, MkDocs, etc.)
  • Information architecture
  • Documentation site maintenance
  • Creating C4 architecture models
  • Writing Mermaid diagrams
  • Designing PlantUML diagrams
  • Visualizing system architecture
  • Creating flow diagrams

​
Documentation Types

API Reference

Agent: API Documenter
  • OpenAPI/Swagger specs
  • Endpoint descriptions
  • Request/response examples
  • Authentication guides

User Guides

Agent: Technical Writer
  • Getting started tutorials
  • How-to guides
  • Concept explanations
  • Troubleshooting guides

Architecture Docs

Agent: Diagram Architect
  • C4 models (Context, Container, Component, Code)
  • Sequence diagrams
  • Data flow diagrams
  • Infrastructure diagrams

Developer Portal

Agent: Documentation Engineer
  • Site structure and navigation
  • Search and discovery
  • Version management
  • Content organization

​
Integration with Development

Integrate documentation into your development workflow:
  1. API Documenter — Generate OpenAPI spec from code
  2. Documentation Engineer — Deploy docs site
  3. CI/CD Engineer — Automate docs builds
  4. Code Reviewer — Review docs in PRs
Treat documentation like code:
  • Version control (Git)
  • Code review process
  • Automated testing (broken links, examples)
  • CI/CD deployment
Use Documentation Engineer to set up the system.

​
Best Practices

Documentation quality matters. Well-written docs reduce support burden, improve developer experience, and accelerate adoption.

Keep Docs Current

  • Update docs in the same PR as code changes
  • Use automated testing for code examples
  • Review docs during code review

Multiple Formats

  • Tutorials (learning-oriented)
  • How-to guides (task-oriented)
  • Reference (information-oriented)
  • Explanation (understanding-oriented)

​
Tools & Formats

Diagram Architect supports:
  • Mermaid — Text-based diagrams (flowcharts, sequence, ER, C4)
  • PlantUML — UML diagrams
  • C4 Model — Architecture documentation (Context, Container, Component, Code)
  • Graphviz — Graph visualization
Documentation Engineer works with:
  • Docusaurus — React-based docs sites
  • MkDocs — Python-based static sites
  • GitBook — Modern documentation platform
  • Mintlify — Beautiful API documentation
  • ReadTheDocs — Open source documentation hosting
API Documenter supports:
  • OpenAPI 3.x (Swagger) — REST APIs
  • GraphQL Schema — GraphQL APIs
  • AsyncAPI — Event-driven APIs
  • JSON Schema — Data validation

Build docs developers (and LLMs) love

Get started for freeTalk to us