다이나믹 워크플로우 프롬프트 작성 가이드
멀티 에이전트 시스템을 안정적으로 제어하고, 일관된 품질의 결과를 만드는 프롬프트 설계 원칙과 예시를 한 장에 정리했습니다. 단계 게이팅·역할 분업·공유 검증·품질 향상의 네 축으로, 어떤 작업에도 적용할 수 있는 워크플로우 템플릿을 제공합니다.
이미지를 클릭하면 인터랙티브 원본(전체 화면)을 새 탭에서 볼 수 있습니다.
핵심 원칙 8가지
단계 게이팅
앞 단계 산출물이 다음 단계의 입력이 되도록 설계
팬아웃 수와 분할 기준 명시
병렬 에이전트 수와 병합·추출 숫자를 기준으로 지정
역할별 모델 티어링
작업량이 많을수록 가볍게, 의사결정이 클수록 무겁게
블랙보드(공유 폴더) 패턴
공유 폴더 + 네이밍 규칙 + 쓰기 권한을 명확히
역할 세분화의 축 지정
파이프라인 축 또는 분담 계획을 먼저 수립하고 승인
팬인 지점의 단일화 강제
취합·평가·최종 판단은 단일 에이전트만 담당
네거티브 제약 + 검증 방법
금지 조항에는 반드시 측정 가능한 검증 절차를 포함
기준을 계약으로, 각 자율은 의무로
기준 항목 추가는 가능하나 측정 방법을 함께 정의
권장 워크플로우 5단계
- Phase 1
기준 수립
평가 기준(루브릭)과 완료 조건 정의
rubric.md - Phase 2
탐색 및 분석Haiku
탐색 에이전트 4개가 병렬 탐색 후 취합
explore-*.md_analysis.md - Phase 3
작업 실행Sonnet
역할 분리된 개발 에이전트가 순차/병렬 수행
변경 코드변경 로그 - Phase 4
검수 및 개선Opus
검수 에이전트가 검토 및 피드백
review.mdfeedback.md - Phase 5
최종 평가Fable 5
최종 평가 에이전트가 종합 평가
_final-report.md
빠른 탐색 작업
역할 분리 구현
정밀 검수
최종 판단
보완 체크포인트
완료 조건(정의)
각 단계가 ‘끝났다’의 기준을 수치로 정의
검수·기각 시 루프 정책
재시도 상한과 반려/피드백 절차를 명시
오케스트레이터 역할
비실무자(위임/검증/보고 전임)로 역할 고정
실패 처리 정책
오류/빌드 실패 시 행동(즉시 보고 or 재시도) 정의
진행 상황 가시화
_status.md로 진척 상황 갱신 및 재개 지원
프롬프트 개선 사이클
- 1탐색 및 진단
- 2문제 정의
- 3프롬프트 개선
- 4적용 및 검증
- 5결과 공유
↺ 결과 공유 → 다시 탐색 및 진단으로 순환
보고서 공통 섹션 템플릿
- 1. 개요
- 2. 핵심 발견
- 3. 강점
- 4. 개선 포인트
- 5. 권장 조치
- 6. 근거 및 참고
실무 예시 시나리오
- 목표: 내부 문서 요약 및 지식 베이스 생성
- 입력: 여러 형식의 문서/링크/이미지
- 산출물: 요약본, Q&A, 태그, 검색 인덱스
- 성공 기준: 정확도/커버리지/일관성/최신성
TIP · 이 템플릿을 그대로 복사해 프로젝트에 맞게 채워 넣으세요. 파일 기반 공유 + 명확한 게이트 = 안정적인 멀티 에이전트 워크플로우의 핵심
멀티 에이전트 워크플로우, 팀에 내재화하고 싶으신가요?
쓸모랩은 워크플로우 설계부터 실습·운영 내재화까지 한 과정으로 지원합니다. 카카오톡으로 편하게 문의해 주세요.
카카오톡으로 문의하기