Technical Writer — technical document writing pipeline
structuredesign→→diagram→review→versionmanagement An agent team collaborates to generate all deliverables at once.
execution mode
agent team — 5 agents communicate directly via SendMessage and cross-verify each other's work.
agent composition
| agent |
file |
role |
type |
| info-architect |
.claude/agents/info-architect.md |
structure design, reader analysis, table of contents |
general-purpose |
| doc-writer |
.claude/agents/doc-writer.md |
body text writing, code example, |
general-purpose |
| diagram-maker |
.claude/agents/diagram-maker.md |
Mermaid diagram, wheneach material |
general-purpose |
| tech-reviewer |
.claude/agents/tech-reviewer.md |
accuracy, completeness, consistency verify |
general-purpose |
| version-controller |
.claude/agents/version-controller.md |
data, change capability, deployment |
general-purpose |
workflow
Phase 1: preparation (Orchestrator directly perform)
- Extract from user input:
- document week: regarding documentperson
- document type (optional): API//guide//operations
- target reader (optional): role, technical level
- reference material (optional): code, existing document,
- existing file (optional): existing document plan, structureplan
_workspace/ Create the directory at the project root
- Organize input and save to
_workspace/00_input.md
- If existing files are provided, copy them to
_workspace/and skip the corresponding Phase
- Determine the execution mode based on the scope of the request
Phase 2: team composition and execution
| order |
task |
responsible |
dependency |
deliverable |
| 1 |
structure design |
architect |
None |
_workspace/01_doc_structure.md |
| 2a |
body text |
writer |
task 1 |
_workspace/02_doc_draft.md |
| 2b |
diagram writing |
diagram |
task 1 |
_workspace/03_diagrams.md |
| 3 |
technical review |
reviewer |
task 2a, 2b |
_workspace/04_review_report.md |
| 4 |
version management |
version |
task 1~3 |
_workspace/05_version_meta.md |
task 2a(body text) and 2b(diagram) ** execution**. task 1(structure) only dependency when whenworkto do number .
teamKRW between flow:
- architect complete → writerto table of contents·content strategy, diagramto diagram requirement, versionto data deliver
- writer ↔ diagram: position, caption
- reviewer body text+diagram cross-verification. 🔴 required revision findings when Request revision from the relevant agent -> rework -> re-verify (up to 2 rounds)
- version review result reflectedto final data
Phase 3: integration and final deliverable
_workspace/ Verify all files in the directory
- review reportConfirm that all critical revisions from the review report have been addressed
- Report the final summary to the user:
- document structure —
01_doc_structure.md
- document body text —
02_doc_draft.md
- diagram —
03_diagrams.md
- review report —
04_review_report.md
- version —
05_version_meta.md
task scaleby mode
| user request pattern |
execution mode |
deploy agent |
| "technical document overall writing" |
Full pipeline |
5people beforeKRW |
| "document structure only " |
design mode |
architect + reviewer |
| " contentas document " (structure ) |
** mode** |
writer + diagram + reviewer |
| " document diagram addition" |
diagram mode |
diagram + reviewer |
| " document reviewplease do" |
review mode |
reviewer |
| " document please do" (existing version) |
** mode** |
writer + reviewer + version |
existing file utilization: existing document, code, provide applicable stage case existing material basedas task.
data deliver protocol
| strategy |
method |
also |
| File-based |
_workspace/ |
Store and share major deliverables |
| Message-based |
SendMessage |
Real-time key information transfer, revision requests |
| Task-based |
TaskCreate/TaskUpdate |
Progress tracking, dependency management |
File naming convention: {}_{agent}_{deliverable}.{extensionspecialist}
error handling
| error type |
strategy |
| document week/scope people |
reader·purpose afterreport present, optional also |
| technical taxdepartmentmatters insufficient |
[confirm needed] , review when verify |
| code example verify impossible |
"verify needed" tablewhen, readerto test |
| agent failure |
Retry once -> proceed without that deliverable, note the gap in the review report |
| reviewfrom 🔴 findings |
Request revision from the relevant agent -> rework -> re-verify (up to 2 rounds) |
test scenario
flow
Prompt: " team API documentplease do. target external developmentspecialist, REST API 5items endpoint ."
expected result:
- structure: API reference type, external developmentspecialist target reader analysis, endpointby section design
- body text: authentication, endpoint 5items detailed, error code, example code
- diagram: authentication when, process flowchart
- review: technical accuracy·completeness verify
- version: v1.0.0, Published status
existing file utilization flow
Prompt: " document structure existing, body text writingplease do" + structure file department
expected result:
- mode: writer + diagram + reviewer deploy
- architect case, existing structure based task
error flow
Prompt: "technical document , week versus whensystem before"
expected result:
- scope versus → architect document minute proposal ( overview, API, operations guide etc.)
- reader people → withindepartment developmentspecialist/external developmentspecialist/operationsteam afterreport present
- priority documentdepartment task
agentby extension skill
each agent specialistnature person skill:
| extension skill |
|
target agent |
role |
| diagram-patterns |
.claude/skills/diagram-patterns/skill.md |
diagram-maker |
Mermaid diagram pattern library (, when, flowchart, ER, status diagram) |
| api-doc-standards |
.claude/skills/api-doc-standards/skill.md |
doc-writer |
REST API document writing tablelevel (endpoint template, error code, degree, authentication) |
| code-example-patterns |
.claude/skills/code-example-patterns/skill.md |
doc-writer |
code example pattern (5stage structure, by style, composition) |
1---2name: technical-writer3description: technical document agent team to specialistqualityas writing pipeline. 'technical document writingplease do', 'API document', ' document', 'user guide', 'developmentspecialist document', 'README writing', ' create it', 'operations ', 'technical blog', 'document', 'documentation', 'technical peopletaxfrom' etc. technical document writing before skill usage. existing code existing document case also review and improvement degreeKRW. However, code writing, test execution, CI/CD building, actual document deployment is outside this skill's scope.4---56# Technical Writer — technical document writing pipeline78structuredesign→→diagram→review→versionmanagement An agent team collaborates to generate all deliverables at once.910## execution mode1112**agent team** — 5 agents communicate directly via SendMessage and cross-verify each other's work.1314## agent composition1516| agent | file | role | type |17|---------|------|------|------|18| info-architect | `.claude/agents/info-architect.md` | structure design, reader analysis, table of contents | general-purpose |19| doc-writer | `.claude/agents/doc-writer.md` | body text writing, code example, | general-purpose |20| diagram-maker | `.claude/agents/diagram-maker.md` | Mermaid diagram, wheneach material | general-purpose |21| tech-reviewer | `.claude/agents/tech-reviewer.md` | accuracy, completeness, consistency verify | general-purpose |22| version-controller | `.claude/agents/version-controller.md` | data, change capability, deployment | general-purpose |2324## workflow2526### Phase 1: preparation (Orchestrator directly perform)27281. Extract from user input:29 - **document week**: regarding documentperson30 - **document type** (optional): API//guide//operations31 - **target reader** (optional): role, technical level32 - **reference material** (optional): code, existing document, 33 - **existing file** (optional): existing document plan, structureplan342. `_workspace/` Create the directory at the project root353. Organize input and save to `_workspace/00_input.md`364. If existing files are provided, copy them to `_workspace/`and skip the corresponding Phase375. Determine the **execution mode** based on the scope of the request3839### Phase 2: team composition and execution4041| order | task | responsible | dependency | deliverable |42|------|------|------|------|--------|43| 1 | structure design | architect | None | `_workspace/01_doc_structure.md` |44| 2a | body text | writer | task 1 | `_workspace/02_doc_draft.md` |45| 2b | diagram writing | diagram | task 1 | `_workspace/03_diagrams.md` |46| 3 | technical review | reviewer | task 2a, 2b | `_workspace/04_review_report.md` |47| 4 | version management | version | task 1~3 | `_workspace/05_version_meta.md` |4849task 2a(body text) and 2b(diagram) ** execution**. task 1(structure) only dependency when whenworkto do number .5051**teamKRW between flow:**52- architect complete → writerto table of contents·content strategy, diagramto diagram requirement, versionto data deliver53- writer ↔ diagram: position, caption 54- reviewer body text+diagram cross-verification. 🔴 required revision findings when Request revision from the relevant agent -> rework -> re-verify (up to 2 rounds)55- version review result reflectedto final data 5657### Phase 3: integration and final deliverable58591. `_workspace/` Verify all files in the directory602. review reportConfirm that all critical revisions from the review report have been addressed613. Report the final summary to the user:62 - document structure — `01_doc_structure.md`63 - document body text — `02_doc_draft.md`64 - diagram — `03_diagrams.md`65 - review report — `04_review_report.md`66 - version — `05_version_meta.md`6768## task scaleby mode6970| user request pattern | execution mode | deploy agent |71|----------------|----------|-------------|72| "technical document overall writing" | **Full pipeline** | 5people beforeKRW |73| "document structure only " | **design mode** | architect + reviewer |74| " contentas document " (structure ) | ** mode** | writer + diagram + reviewer |75| " document diagram addition" | **diagram mode** | diagram + reviewer |76| " document reviewplease do" | **review mode** | reviewer |77| " document please do" (existing version) | ** mode** | writer + reviewer + version |7879**existing file utilization**: existing document, code, provide applicable stage case existing material basedas task.8081## data deliver protocol8283| strategy | method | also |84|------|------|------|85| File-based | `_workspace/` | Store and share major deliverables |86| Message-based | SendMessage | Real-time key information transfer, revision requests |87| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |8889File naming convention: `{}_{agent}_{deliverable}.{extensionspecialist}`9091## error handling9293| error type | strategy |94|----------|------|95| document week/scope people | reader·purpose afterreport present, optional also |96| technical taxdepartmentmatters insufficient | [confirm needed] , review when verify |97| code example verify impossible | "verify needed" tablewhen, readerto test |98| agent failure | Retry once -> proceed without that deliverable, note the gap in the review report |99| reviewfrom 🔴 findings | Request revision from the relevant agent -> rework -> re-verify (up to 2 rounds) |100101## test scenario102103### flow104**Prompt**: " team API documentplease do. target external developmentspecialist, REST API 5items endpoint ."105**expected result**:106- structure: API reference type, external developmentspecialist target reader analysis, endpointby section design107- body text: authentication, endpoint 5items detailed, error code, example code108- diagram: authentication when, process flowchart109- review: technical accuracy·completeness verify110- version: v1.0.0, Published status111112### existing file utilization flow113**Prompt**: " document structure existing, body text writingplease do" + structure file department114**expected result**:115- mode: writer + diagram + reviewer deploy116- architect case, existing structure based task117118### error flow119**Prompt**: "technical document , week versus whensystem before"120**expected result**:121- scope versus → architect document minute proposal ( overview, API, operations guide etc.)122- reader people → withindepartment developmentspecialist/external developmentspecialist/operationsteam afterreport present123- priority documentdepartment task124125## agentby extension skill126127each agent specialistnature person skill:128129| extension skill | | target agent | role |130|----------|------|-------------|------|131| diagram-patterns | `.claude/skills/diagram-patterns/skill.md` | diagram-maker | Mermaid diagram pattern library (, when, flowchart, ER, status diagram) |132| api-doc-standards | `.claude/skills/api-doc-standards/skill.md` | doc-writer | REST API document writing tablelevel (endpoint template, error code, degree, authentication) |133| code-example-patterns | `.claude/skills/code-example-patterns/skill.md` | doc-writer | code example pattern (5stage structure, by style, composition) |