research

Research

[MARKET-RESEARCH 활성화]

목표

사용자의 시장조사 요청을 받아 정보 수집 → 종합 분석 → 보고서 생성의 전체 워크플로우를 오케스트레이션하여 구조화된 시장조사 보고서를 자동 생성함.

활성화 조건

사용자가 /market-research:research 호출 시 또는 "시장조사", "시장 분석", "경쟁사 분석", "SWOT 분석" 키워드 감지 시.

에이전트 호출 규칙

에이전트 FQN

에이전트	FQN	티어
researcher	market-research:researcher:researcher	MEDIUM
architect	market-research:architect:architect	HIGH
writer	market-research:writer:writer	MEDIUM

프롬프트 조립

1. agents/{agent-name}/ 에서 3파일 로드 (AGENT.md + agentcard.yaml + tools.yaml)
2. gateway/runtime-mapping.yaml 참조하여 구체화:
   • 모델 구체화: agentcard.yaml의 tier → tier_mapping에서 모델 결정
   • 툴 구체화: tools.yaml의 추상 도구 → tool_mapping에서 실제 도구 결정
   • 금지액션 구체화: agentcard.yaml의 forbidden_actions → action_mapping에서 제외할 실제 도구 결정
   • 최종 도구 = (구체화된 도구) - (제외 도구)
3. 프롬프트 조립: AGENT.md + agentcard.yaml + tools.yaml을 합쳐 하나의 프롬프트로 구성
   • 구성 순서: 공통 정적(runtime-mapping) → 에이전트별 정적(3파일) → 동적(작업 지시)
4. Task(subagent_type=FQN, model=구체화된 모델, prompt=조립된 프롬프트) 호출

오케스트레이션 스킬 활용

워크플로우 단계	부스팅 스킬
Phase 1 (주제 설정)	ulw 매직 키워드
Phase 2 (정보 수집)	ulw 매직 키워드
Phase 3 (종합 분석)	ulw 매직 키워드
Phase 4 (보고서 생성)	ulw 매직 키워드
Phase 5 (검증 및 완료)	ulw 매직 키워드

워크플로우

Phase 1: 조사 주제 설정 (ulw 활용)

AskUserQuestion 도구를 활용하여 조사 주제를 수집함.

수집 항목:

• 조사할 시장/산업 (필수)
• 조사 범위 (지역, 기간)
• 관심 경쟁사 (선택)
• 자사 정보 (SWOT 분석을 위한 강점/약점, 선택)
• 특별히 관심 있는 분석 영역 (선택)

수집된 정보를 output/research-brief.md에 저장.

Phase 2: 정보 수집 → Agent: researcher (ulw 활용)

• TASK: 시장 트렌드, 경쟁사, 타겟 고객 정보를 웹 검색으로 수집·정리
• EXPECTED OUTCOME: 시장 트렌드/경쟁사/타겟 고객 3개 영역의 구조화된 조사 데이터 (출처 포함)
• MUST DO: 모든 데이터에 출처(URL) 명시, 경쟁사 최소 3개 조사, 수치에 시점(연도) 표기
• MUST NOT DO: 전략적 분석이나 시사점 도출 금지, SWOT 분석 금지
• CONTEXT: output/research-brief.md의 조사 주제 참조. 수집 결과를 output/research-data.md에 저장

Phase 3: 종합 분석 → Agent: architect (ulw 활용)

• TASK: 수집된 정보를 SWOT 프레임워크로 종합 분석하여 전략적 시사점 도출
• EXPECTED OUTCOME: SWOT 매트릭스 + 교차 전략(SO/WO/ST/WT) + 우선순위별 권장사항
• MUST DO: SWOT 각 요소 최소 3개 항목, 모든 항목에 근거 데이터 명시, 교차 전략 포함
• MUST NOT DO: 추가 웹 검색 금지, 보고서 작성 금지, 파일 수정 금지
• CONTEXT: output/research-data.md의 조사 데이터와 output/research-brief.md의 자사 정보 참조

Phase 4: 보고서 생성 → Agent: writer (ulw 활용)

• TASK: 조사 결과와 분석을 구조화된 시장조사 보고서로 작성
• EXPECTED OUTCOME: 마크다운 형식의 시장조사 보고서 (Mermaid 다이어그램 최소 1개 포함)
• MUST DO: 필수 섹션(요약~참고 출처) 모두 포함, Mermaid 다이어그램 삽입, 출처 명시
• MUST NOT DO: 추가 웹 검색 금지, 분석 내용 변경 금지
• CONTEXT: output/research-data.md + architect의 분석 결과 참조. 보고서를 output/market-research-report.md에 저장

Phase 5: 검증 및 완료 (ulw 활용)

1. 보고서 파일(output/market-research-report.md) 존재 확인
2. 보고서 필수 섹션 포함 여부 확인
3. Mermaid 다이어그램 포함 여부 확인
4. 사용자에게 보고서 완료 보고 및 파일 경로 안내

완료 조건

• 시장 트렌드, 경쟁사, 타겟 고객 정보가 모두 수집됨
• SWOT 분석 및 교차 전략이 완성됨
• 보고서에 필수 섹션이 모두 포함됨
• Mermaid 다이어그램이 최소 1개 포함됨
• 보고서 파일이 output/market-research-report.md에 저장됨

검증 프로토콜

보고서 생성 후 다음 항목을 검증:

• 필수 섹션 완성도 (7개 섹션)
• 데이터 출처 명시 여부
• Mermaid 다이어그램 유효성
• 수치 데이터 시점 표기

상태 정리

완료 시 중간 산출물 유지:

• output/research-brief.md (조사 주제)
• output/research-data.md (수집 데이터)
• output/market-research-report.md (최종 보고서)

취소

사용자가 "취소", "중단" 요청 시 현재까지 진행된 산출물을 유지하고 안내.

재개

이전 산출물이 존재하면 마지막 완료된 Phase부터 재시작 가능.