router

Router (전체 파이프라인)

[ROUTER 활성화]

목표

도메인·주제 입력부터 경영진 발표 PPT·최종 검증까지 end-to-end 파이프라인을 오케스트레이션함. STEP 1(기획) → STEP 2(MAS 설계) → STEP 3(PPT 생성) → 최종 검증의 4개 Phase를 순차 수행하며, STEP 경계에서 3회 사용자 승인을 획득함.

활성화 조건

사용자가 /mas-designer:router 호출 시 또는 "AI 기획 도와줘", "멀티에이전트 설계", "기획부터 PPT까지" 등 포괄 요청 키워드 감지 시.

워크플로우

Phase 0: 도메인·주제 수집 + 프로젝트 네이밍

1. AskUserQuestion으로 비즈니스 도메인·주제·핵심 고민 수집
2. 수집된 정보에서 영문 kebab-case 프로젝트 식별자 2~3안 자동 제안:
   • 예: 도메인="스마트 물류" + 주제="AI 견적 자동화" → smart-logistics-quoting, ai-quoting-agent, logistics-auto-quote
3. AskUserQuestion으로 사용자에게 최종 {project} 식별자 선택 (직접 입력 옵션 포함)
4. output/{project}/ 하위 디렉토리 구조 생성:

   output/{project}/{plan,step2,step3,final}/
   output/{project}/plan/es/
   output/{project}/step3/images/
   

5. 수집된 도메인·주제를 output/{project}/plan/0-input.md에 저장

Phase 1: STEP 1 기획 실행 → Skill: plan (/mas-designer:plan 위임)

• INTENT: 문제가설 → 방향성 → 솔루션 탐색/선정 → 이벤트 스토밍 → 유저스토리 순차 수행
• ARGS: {project} 식별자, output/{project}/plan/0-input.md 경로
• RETURN: STEP 1 완료 상태 + 산출물 13종 경로 + plan 스킬 Phase 8의 체크리스트 결과

Phase 1 종료 후: 사용자 승인 (1차)

plan 스킬 완료 보고를 사용자에게 제시하고 "STEP 2(MAS 설계)로 진행할까요?" 문의.

• 승인 → Phase 2로 진행
• 수정 요청 → 원인에 따라 plan 스킬 재호출 또는 개별 Phase 재수행
• 중단 → 산출물 보존 후 종료

Phase 2: STEP 2 MAS 설계 실행 → Skill: design-mas (/mas-designer:design-mas 위임)

• INTENT: 에이전트 식별 → LangGraph 그래프 → 시퀀스 → Tool·MCP → RAG/메모리 → 멀티모달 → 에러폴백 → 통합 설계서
• ARGS: {project} 식별자
• RETURN: STEP 2 완료 상태 + 8개 설계 파일 경로

Phase 2 종료 후: 사용자 승인 (2차)

design-mas 스킬 완료 보고 + mas-architecture.md 요약을 사용자에게 제시. "STEP 3(경영진 발표 PPT 생성)으로 진행할까요?" 문의.

Phase 3: STEP 3 PPT 생성 실행 → Skill: generate-pptx (/mas-designer:generate-pptx 위임)

• INTENT: 스토리라인 → spec.md 작성 → 이미지 생성 → pptxgenjs 빌드
• ARGS: {project} 식별자
• RETURN: STEP 3 완료 상태 + 3.{project}.pptx 경로 + 파일 크기

Phase 3 종료 후: 사용자 승인 (3차)

generate-pptx 스킬 완료 보고를 사용자에게 제시. "최종 독립 검증으로 진행할까요?" 문의.

Phase 4: 최종 독립 검증 → Skill: review (/mas-designer:review 위임)

• INTENT: 5개 체크 섹션 정합성 검증 + doc-exporter로 final/ 패키징
• ARGS: {project} 식별자
• RETURN: APPROVED 시 final/ 패키지 경로 + MANIFEST, REJECTED 시 수정 옵션

Phase 5: 최종 보고

사용자에게 최종 산출물 보고:

• 설계서: output/{project}/final/mas-architecture.md
• PPTX: output/{project}/final/{project}.pptx
• 검증 리포트: output/{project}/final/review-report.md
• 기획 아카이브: output/{project}/final/plan-artifacts/
• 매니페스트: output/{project}/final/MANIFEST.md

완료 조건

• Phase 0 {project} 확정
• Phase 1/2/3에서 각 STEP 승인 획득 (총 3회)
• Phase 4 review APPROVED
• final/ 디렉토리 5개 산출물 모두 존재

상태 정리

진행 상태를 AGENTS.md의 ## 워크플로우 상태 섹션에 하위 스킬별 Phase 단위로 기록. 파이프라인 완료 시 각 하위 스킬 항목을 "(기록 없음)"으로 초기화.

재개

1. AGENTS.md의 ## 워크플로우 상태 섹션에서 각 하위 스킬의 마지막 완료 Phase를 읽음
2. 미시작 스킬은 Phase 0부터, 진행 중 스킬은 마지막 완료 Phase 다음부터 재시작
3. {project} 식별자 재확인 필수