scenario

name	scenario
description	요구사항 시나리오 생성 및 선택 (STEP 1)
user-invocable	true
type	orchestrator

Scenario

[SCENARIO 스킬 활성화]

목표

비즈니스 요구사항을 N개의 구조화된 시나리오로 변환하고 사용자가 하나를 선택하도록 함. STEP 1: 시나리오 생성 및 선택 단계를 담당.

활성화 조건

다음 키워드 감지 시 자동 활성화:

• "시나리오 생성", "요구사항 생성", "요구사항 정의"
• "시나리오 만들어", "요구사항 만들어"

또는 /abra:scenario 명령 호출 시.

작업 환경 변수 로드

AGENTS.md 파일에서 환경변수를 로딩. 로딩 실패 시 사용자에게 /abra:setup을 먼저 수행하라고 안내하고 종료.

## 환경변수
- AI_RUNTIME: 현재 구동중인 런타임
- PROJECT_DIR: 현재 프로젝트 경로
- ABRA_PLUGIN_DIR: ABRA 플러그인 경로
- DIFY_DIR: DIFY 설치 경로

AI_RUNTIME 자동 감지 및 업데이트:
{ABRA_PLUGIN_DIR}/resources/guides/call-subagent.md의 "0. AI_RUNTIME 자동 감지" 규칙에 따라 현재 런타임을 감지하고 AGENTS.md의 AI_RUNTIME 값을 업데이트.

에이전트 호출 규칙

에이전트 FQN

에이전트	FQN
scenario-analyst	abra:scenario-analyst:scenario-analyst

프롬프트 조립

• {ABRA_PLUGIN_DIR}/resources/guides/combine-prompt.md에 따라 AGENT.md + agentcard.yaml + tools.yaml 합치기
• Agent(subagent_type=FQN, model=tier_mapping 결과, prompt=조립된 프롬프트) 호출
• tier → 모델 매핑은 {ABRA_PLUGIN_DIR}/gateway/runtime-mapping.yaml 참조

서브 에이전트 호출

워크플로우 단계에 Agent: {agent-name}이 명시된 경우, 메인 에이전트는 해당 단계를 직접 수행하지 않고, {ABRA_PLUGIN_DIR}/resources/guides/call-subagent.md에 따라 서브 에이젼트 호출

진행상황 업데이트 및 재개

{PROJECT_DIR}/AGENTS.md에 각 Phase 완료 시 저장. 최종 완료 시 'Done'으로 표기.

## 워크플로우 진행상황
- scenario: Phase3

진행상황 정보가 있는 경우 마지막 완료 단계 이후부터 자동 재개

워크플로우

Phase 0: 입력 수집

Step1. 사용자 요청 정보 수집: 사용자에게 아래 양식을 제공하고 입력 요청

# 사용자 정보 제공

## 서비스 목적(필수)
(예: 소호 행사 기획자를 위한 AI 자동화 서비스)

## 사업 배경 및 맥락(선택)
(예: 현재 수작업으로 처리하는 업무 현황, 해결하고 싶은 Pain Point 등)

## 세부 요구사항(선택)
(예: 특정 기능, 처리 방식, 제약 조건 등)

## 외부 기능 연동 요건(선택)
(예: 슬랙, 구글 캘린더, 결제 시스템 등 연동이 필요한 외부 서비스)

## 참고 자료(선택: 파일 경로 입력)
(예: C:\Users\hiond\workspace\soho-event\docs\requirements.md)

Step2. AskUserQuestion 생성할 비즈니스 시나리오 갯수 요청:

항목	필수	기본값	설명
생성 갯수	선택	3	생성할 시나리오 버전 수 (1~5 권장)

Step3. 요구사항 명확화:
모호하거나 추가정보가 필요하면 추가로 사용자에게 정보 요청.
서비스 목적, 사업 배경 및 맥락, 세부 요구사항, 외부 기능 연동 요건, 참고 자료를 명확하게 재정리

Phase 1: 시나리오 생성 → Agent: scenario-analyst

scenario-analyst 에이전트에 위임:

• TASK: 서비스 목적을 기반으로 N개의 요구사항 시나리오 자동 생성. 각 시나리오는 서로 다른 관점(업무자동화, 고객경험, 비용절감, 의사결정 지원, 협업효율화)으로 작성
• EXPECTED OUTCOME: 각 시나리오에 8개 섹션(서비스개요, 사용자시나리오, 에이전트역할, 워크플로우설계, 외부도구, AI지시사항, 품질요구사항, 검증시나리오) 포함 + 버전 간 비교표 포함한 마크다운 문서
• MUST DO: 다양한 관점(업무자동화, 고객경험, 비용절감, 의사결정, 협업효율화) 반영, 비즈니스 용어 사용(기술 용어 최소화), 각 시나리오 차별화(서비스명, 우선순위, 품질 지표), 사용자 제공 외부 기능 요구사항을 시나리오에 우선 반영, 각 기능에 대해 구현 방식은 명시하지 않고 기능 수준으로만 기술
• MUST NOT DO: 사용자에게 직접 질문 금지, 시나리오 선택 금지, DSL 생성 금지
• CONTEXT: 서비스 목적: {service_purpose}, 사업 배경 및 맥락: {domain_context}, 세부 요구사항: {requirement}, 외부 기능 연동 요건: {external_capabilities}, 참고 자료: {references}, 생성 갯수: {count}

Phase 2: 사용자 선택

생성된 각 시나리오의 요약 정보를 표 형식으로 제시하고 선택할 시나리오 버전을 입력하도록 안내:

| 버전 | 관점 | 서비스명 | 핵심 가치 |
|------|------|----------|----------|
| 1 | ... | ... | ... |
| 2 | ... | ... | ... |

Phase 3: AGENTS.md 생성

선택된 시나리오를 바탕으로
{ABRA_PLUGIN_DIR}/resources/guides/create-agents.md을 참조하여 {PROJECT_DIR}/AGENTS.md에 추가

멤버 구성 규칙:
선택된 시나리오를 구현에 필요한 팀원의 프로필을 작성함

• 예제와 같이 역할, 이름, 닉네임, 성별, 나이, 성향, 경력을 적절히 생성
• 별명은 한국어로 하며 4자를 넘지 않도록 함

**예시: **

PO
- 프로파일: 이해경 "갑빠" (남성, 54세)
- 성향: Value Oriented, Interactive, Iterative를 중시하며 친화적인 성격
- 경력:
  - IBM에서 5년간 애자일 코치로 근무
  - 네이버, 쿠팡, 카카오에서 PO로 10년간 근무
  - 애자일 컨설팅 회사 창업 및 5년간 운영
  - 국제 애자일 연합회 인증 트레이너

Phase 4: 결과 저장 및 완료

선택된 시나리오를 {PROJECT_DIR}/output/scenario.md로 저장. 후보 파일({PROJECT_DIR}/output/scenario-candidates.md)은 참조용으로 보존.

scenario.md 구성:

## 사용자 요구사항 
- 서비스 목적: `{service_purpose}`
- 사업 배경 및 맥락: `{domain_context}` 
- 세부 요구사항: `{requirement}` 
- 외부 기능 연동 요건: `{external_capabilities}`
- 참고 자료: `{references}` 

## 비즈니스 시나리오 (관점: {관점명})
### 1. 서비스 개요
...
### 8. 검증 시나리오
...

사용자에게 완료 보고:

✅ 시나리오 생성 완료

- 생성된 시나리오 수: {count}개
- 선택된 버전: 버전 {selected_version} ({관점})
- 후보 파일: {PROJECT_DIR}/output/scenario-candidates.md
- 최종 파일: {PROJECT_DIR}/output/scenario.md

다음 단계: `/abra:dsl-generate`로 Dify DSL 생성

완료 조건

• N개 시나리오 생성 완료
• 각 시나리오에 8개 섹션 포함
• 버전 간 비교표 포함
• 사용자 선택 완료
• scenario.md 파일 저장 완료

검증 프로토콜

시나리오 파일의 필수 요소 확인:

1. 8개 섹션이 모두 존재하는지 확인
2. 비교표가 모든 버전을 포함하는지 확인
3. 비즈니스 용어로 작성되었는지 확인 (기술 용어 최소화)

상태 정리

{PROJECT_DIR}/AGENTS.md에 각 Phase 완료 시 저장. 최종 완료 시 'Done'으로 표기

## 워크플로우 진행상황
- scenario: Phase2

재개

AGENTS.md에 마지막 완료 단계 이후 자동 재개

MUST 규칙

#	규칙
1	N개 시나리오 모두 8개 섹션(서비스개요, 사용자시나리오, 에이전트역할, 워크플로우설계, 외부도구, AI지시사항, 품질요구사항, 검증시나리오)을 포함한다
2	다양한 관점(업무자동화, 고객경험, 비용절감, 의사결정, 협업효율화)을 반영한다
3	버전 간 비교표를 포함한다
4	사용자 제공 외부 기능 요구사항을 시나리오에 우선 반영한다

MUST NOT 규칙

#	금지 사항
1	시나리오 선택을 에이전트가 대신 수행하지 않는다 (사용자가 선택)
2	DSL을 생성하지 않는다 (별도 STEP에서 수행)
3	사용자에게 직접 질문하지 않는다 (에이전트 내에서)
4	기술 용어를 과도하게 사용하지 않는다 (비즈니스 용어 우선)

검증 체크리스트

• 요청된 갯수(N개)의 시나리오가 모두 생성되었는가
• 각 시나리오에 8개 필수 섹션이 포함되어 있는가
• 버전 간 비교표가 존재하는가
• 사용자가 시나리오를 선택했는가
• scenario-candidates.md 파일이 output/ 디렉토리에 저장되었는가
• scenario.md (선택된 최종본)가 output/ 디렉토리에 저장되었는가