다이나믹 워크플로우 프롬프트 작성 가이드

단계별 제어 역할 분업 공유 및 검증 품질 향상

오케스트레이터 (비실무)

요청 입력

https://example.com/project

에이전트 생성
게이트 검증
진행 관리
최종 보고

탐색 에이전트 (4개 병렬)

Haiku

개발 에이전트 (역할 분리)

Sonnet

검수 에이전트

Opus

최종 평가 에이전트 (단 1개)

Fable 5

공유 작업 공간

/workspace

rubric.md

explore-01.md

explore-02.md

explore-03.md

explore-04.md

_analysis.md

prompts-improvement.md

_status.md

_final-report.md

01핵심 원칙 8가지

단계 게이팅

앞 단계 산출물이 다음 단계의 입력이 되도록 설계

팬아웃 수와 분할 기준 명시

병렬 에이전트 수와 병합 추출 숫자와 기준으로 지정

역할별 모델 티어링

작업량이 많을수록 가볍게, 의사결정이 클수록 무겁게

블랙보드(공유 폴더) 패턴

공유 폴더 + 네이밍 규칙 + 쓰기 권한을 명확히

역할 세분화의 축 지정

파이프라인 축 또는 분담 계획을 먼저 수립하고 승인

팬인 지점의 단일화 강제

취합/평가/최종 판단은 단일 에이전트만 담당

네거티브 제약 + 검증 방법

금지 조항에는 반드시 측정 가능한 검증 절차를 포함

기준을 계약으로, 각 자율은 의무로

기준 항목 추가는 가능하나 측정 방법을 함께 정의

02권장 워크플로우 구조(예시)

Phase 1기준 수립

평가 기준(루브릭)과 완료 조건 정의

rubric.md

Phase 2탐색 및 분석

탐색 에이전트 4개가 병렬 탐색 후 취합

explore-*.md_analysis.md

Phase 3작업 실행

역할 분리된 개발 에이전트가 순차/병렬 수행

변경 코드변경 로그

Phase 4검수 및 개선

검수 에이전트(Opus)가 검토 및 피드백

review.mdfeedback.md

Phase 5최종 평가

최종 평가 에이전트(Fable 5)가 종합 평가

_final-report.md

03프롬프트 구조 예시

## 목표

<작업의 목적과 성공 기준(수치적 정의)을 한 문장으로 작성>

## 단계

<각 단계별 산출물 파일 경로와 게이트 조건 명시>

## 에이전트 구성

<역할, 개수, 권한, 입력/출력, 제시된 정책 등 정의>

## 공유 규약

<공유 폴더, 네이밍 규칙, 보고서 섹션 템플릿, 쓰기 권한 등>

## 제약 및 검증

<금지 조항과 검증 방법, 교차 검증 절차 명시>

## 종료 조건

<완료 조건 재확인, 실패 처리 정책 명시>

보고서 공통 섹션 템플릿

개요
핵심 발견
강점
개선 포인트
권장 조치
근거 및 참고

04보완 항목 5가지(자주 빠뜨리는 체크포인트)

완료 조건(정의)

각 단계가 '끝났다'의 기준을 수치로 정의

검수·기각 시 루프 정책

재시도 상한과 반려/피드백 절차를 명시

오케스트레이터 역할

비실무자(위임/검증/보고 전임)로 역할 고정

실패 처리 정책

오류/빌드 실패 시 행동(즉시 보고 or 재시도) 정의

진행 상황 가시화

_status.md로 진척 상황 갱신 및 재개 지원

05프롬프트 개선 사이클

탐색 및 진단

문제 정의

프롬프트 개선

적용 및 검증

결과 공유

↺ 결과 공유 → 다시 탐색 및 진단으로 순환

실무 예시 시나리오 (예시)

목표:내부 문서 요약 및 지식 베이스 생성

입력:여러 형식의 문서/링크/이미지

산출물:요약본, Q&A, 태그, 검색 인덱스

성공 기준:정확도/커버리지/일관성/최신성