업무 매뉴얼 자동 생성 파이프라인. 기존 문서·코드를 분석하여 프로세스 플로차트, 단계별 매뉴얼, FAQ, 교육자료를 에이전트 팀이 협업 생성한다. '업무 매뉴얼 만들어줘', '운영 절차서 작성', 'SOP 자동 생성', '프로세스 문서화', '매뉴얼 작성', '업무 가이드 만들기', '절차서 자동화', '교육 자료 만들어줘' 등 업무 프로세스 문서화 전반에 이 스킬을 사용한다. 코드 리뷰, 기술 문서 번역, 마케팅 콘텐츠 작성은 이 스킬의 범위가 아니다.
기존 문서·코드·위키를 분석하여 프로세스 플로차트, 단계별 매뉴얼, FAQ, 교육자료를 에이전트 팀이 협업 생성한다.
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
| 에이전트 | 파일 | 역할 | 타입 |
|---|---|---|---|
| document-analyst | .claude/agents/document-analyst.md | 기존 문서/코드 분석, 프로세스 추출 | general-purpose |
| flowchart-designer | .claude/agents/flowchart-designer.md | Mermaid 플로차트, RACI 매트릭스 | general-purpose |
| manual-writer | .claude/agents/manual-writer.md | 단계별 절차서, 체크리스트 | general-purpose |
| faq-builder | .claude/agents/faq-builder.md | FAQ, 트러블슈팅, 에스컬레이션 | general-purpose |
| training-producer | .claude/agents/training-producer.md | 퀴즈, 실습과제, 요약카드 | general-purpose |
_workspace/ 디렉토리를 프로젝트 루트에 생성한다_workspace/00_input.md에 저장한다_workspace/에 복사하고 업데이트 모드로 전환한다팀을 구성하고 작업을 할당한다. 작업 간 의존 관계:
| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|---|---|---|---|
| 1 | 문서·코드 분석 | analyst | 없음 | _workspace/01_document_analysis.md |
| 2 | 프로세스 플로차트 | designer | 작업 1 | _workspace/02_process_flowcharts.md |
| 3a | 단계별 매뉴얼 | writer | 작업 1, 2 | _workspace/03_step_by_step_manual.md |
| 3b | FAQ·트러블슈팅 | faq | 작업 1, 2 | _workspace/04_faq_troubleshooting.md |
| 4 | 교육자료 | producer | 작업 3a, 3b | _workspace/05_training_materials.md |
작업 3a(매뉴얼)와 3b(FAQ)는 병렬 실행한다. 둘 다 작업 1, 2에만 의존하므로 동시에 시작할 수 있다.
팀원 간 소통 흐름:
오케스트레이터가 최종 통합 검증을 수행한다:
_workspace/ 내 모든 파일을 확인한다_workspace/06_review_report.md에 검증 결과를 저장한다| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|---|---|---|
| "업무 매뉴얼 전체 만들어줘" | 풀 파이프라인 | 5명 전원 |
| "이 코드 프로세스 분석해줘" | 분석 모드 | analyst + designer |
| "이 절차서에 FAQ 추가해줘" (기존 파일) | FAQ 모드 | faq + producer |
| "기존 매뉴얼 업데이트해줘" | 업데이트 모드 | analyst(변경점만) + writer + faq |
| "교육자료만 만들어줘" (기존 매뉴얼) | 교육 모드 | producer 단독 |
기존 파일 활용: 사용자가 기존 매뉴얼, 절차서, 플로차트를 제공하면 해당 파일을 _workspace/의 적절한 위치에 복사하고, 해당 단계의 에이전트는 건너뛴다.
| 전략 | 방식 | 용도 |
|---|---|---|
| 파일 기반 | _workspace/ 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
| 에러 유형 | 전략 |
|---|---|
| 소스 파일 접근 불가 | analyst가 접근 가능한 소스만으로 작업, 보고서에 "미분석 소스" 목록 명시 |
| 프로세스 추출 불가 | 사용자에게 핵심 프로세스 인터뷰 질문 제시, 답변 기반으로 작업 |
| 문서 간 모순 | 코드 기반 동작을 우선 채택, 모순 사항을 갭 분석에 기록 |
| Mermaid 렌더링 한계 | 복잡한 다이어그램은 서브 프로세스로 분리, 텍스트 설명 보완 |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 검증 보고서에 누락 명시 |
프롬프트: "우리 팀의 배포 프로세스 매뉴얼을 만들어줘. 소스는 deploy.sh, CI 설정 파일, 기존 위키 문서가 있어" 기대 결과:
프롬프트: "이 절차서를 기반으로 FAQ랑 교육자료만 추가해줘" + 기존 매뉴얼 파일 기대 결과:
_workspace/03_step_by_step_manual.md로 복사프롬프트: "고객 CS 프로세스 매뉴얼 만들어줘, 문서는 없고 구두로 설명할게" 기대 결과:
| 확장 스킬 | 경로 | 대상 에이전트 | 역할 |
|---|---|---|---|
| flowchart-standards | .claude/skills/flowchart-standards/skill.md | flowchart-designer | 플로차트 표기법, 프로세스 패턴, 복잡도 관리 |
| knowledge-base-design | .claude/skills/knowledge-base-design/skill.md | faq-builder, manual-writer | FAQ 설계, 트러블슈팅 진단 트리, 지식 수명주기 |