Technical writing specialists for functional and API documentation. Dispatch when you need to create guides, conceptual docs, or API references following established documentation standards.
The ring-tw-team plugin provides specialized agents for technical documentation. Use them via Task tool with subagent_type:.
Remember: Follow the ORCHESTRATOR principle from ring:using-ring. Dispatch agents to handle documentation tasks; don't write complex documentation directly.
| Agent | Specialization | Use When |
|---|---|---|
ring:functional-writer | Conceptual docs, guides, tutorials, best practices, workflows | Writing product guides, tutorials, "how to" content |
ring:api-writer | REST API reference, endpoints, schemas, errors, field descriptions | Documenting API endpoints, request/response examples |
ring:docs-reviewer | Voice/tone, structure, completeness, clarity, accuracy |
| Reviewing drafts, pre-publication quality check |
--- dividersParallel dispatch for comprehensive documentation (single message, multiple Tasks):
Task #1: functional-writer (write the guide)
Task #2: api-writer (write API reference)
(Both run in parallel)
Then:
Task #3: docs-reviewer (review both)
Agents: functional-writer, api-writer, docs-reviewer
Skills:
Commands:
| Plugin | Use For |
|---|---|
| ring:using-ring (default) | ORCHESTRATOR principle |
| ring:using-dev-team | Developer agents for technical accuracy |
| ring:using-pm-team | Pre-dev planning before documentation |
✅ "I need documentation for the new feature. Let me dispatch functional-writer."
❌ "I'll manually write all the documentation myself."
Before dispatching any documentation agent:
HARD GATE: MUST dispatch appropriate specialist (not write directly).
| Condition | Decision | Action |
|---|---|---|
| Documentation type unclear | STOP | Report: "Need to clarify functional guide vs API reference" |
| No subject matter source | STOP | Report: "Need source material or SME access" |
| Audience undefined | STOP | Report: "Need target audience definition" |
| Product not yet defined | STOP | Report: "Cannot document undefined features" |
These requirements are NON-NEGOTIABLE:
| Severity | Criteria | Examples |
|---|---|---|
| CRITICAL | Writing directly instead of dispatching | Orchestrator writes full documentation |
| HIGH | Wrong agent for document type | Using api-writer for conceptual guide |
| MEDIUM | Skipping review step | Publishing without docs-reviewer check |
| LOW | Suboptimal agent combination | Could parallelize dispatches |
| User Says | Your Response |
|---|---|
| "Just write the docs quickly, no need for specialists" | "MUST dispatch specialists. They apply consistent standards. I'll dispatch the appropriate agent." |
| "Skip the review, we're in a hurry" | "Documentation review is REQUIRED before publication. I'll dispatch docs-reviewer." |
| "One agent can do it all" | "Each agent has specialized knowledge. I'll dispatch the correct specialist for each document type." |
| "README is enough documentation" | "README is an entry point, not complete documentation. I'll dispatch agents for proper docs." |
| "Developers can figure it out from the code" | "Code is NOT documentation. MUST create proper documentation. I'll dispatch the appropriate writers." |
| Rationalization | Why It's WRONG | Required Action |
|---|---|---|
| "Simple docs, I can write directly" | Simple ≠ no standards. Specialists ensure consistency | MUST dispatch specialist |
| "Faster to write myself" | Speed without quality creates tech debt | Dispatch agents, ensure quality |
| "Already know the product well" | Knowledge ≠ documentation skill | Use specialists for writing |
| "Review takes too long" | Review catches issues before users do | MUST include review step |
| "Documentation isn't critical path" | Documentation IS part of the feature | Treat docs as required deliverable |
| "Internal docs don't need standards" | Internal users deserve quality too | Apply same standards everywhere |
Signs that documentation workflow is already correct:
If all above are true: Workflow is correct, proceed with dispatches.