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.
structuredesign→→diagram→review→versionmanagement An agent team collaborates to generate all deliverables at once.
agent team — 5 agents communicate directly via SendMessage and cross-verify each other's work.
| 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 |
_workspace/ Create the directory at the project root_workspace/00_input.md_workspace/and skip the corresponding Phase| 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:
_workspace/ Verify all files in the directory01_doc_structure.md02_doc_draft.md03_diagrams.md04_review_report.md05_version_meta.md| 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.
| 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 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) |
Prompt: " team API documentplease do. target external developmentspecialist, REST API 5items endpoint ." expected result:
Prompt: " document structure existing, body text writingplease do" + structure file department expected result:
Prompt: "technical document , week versus whensystem before" expected result:
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) |