---
name: ideate
description: |
  아이디어 탐색부터 Epic 생성까지 원스톱 워크플로우. Use when (1) 러프한 아이디어가 있을 때,
  (2) 새 기능/프로젝트 구상 시, (3) "뭔가 만들고 싶어", (4) 가설 수립 및 검증 필요 시.
tools: [Read, Write, Edit, Bash, AskUserQuestion]
location: project
triggers:
  - 아이디어가 있는데
  - 뭔가 만들고 싶어
  - 이런 거 되나
  - 새 기능 구상
  - 프로젝트 시작하고 싶어
  - 가설 세워보자
  - 에픽 만들자
  - 에픽 만들어줘
  - 에픽 만들어
  - epic 만들어
  - Epic 생성해줘
---

> **시스템 메시지**: `[SEMO] Skill: ideate 호출 - {아이디어 요약}`

# ideate Skill

**Purpose**: 러프한 아이디어를 구조화된 Epic으로 발전시키는 원스톱 워크플로우

## 핵심 원칙

> **Source of Truth**: Epic Issue가 아이디어의 진실 소스 (Design Brief 내용 직접 포함)
> **Epic 역할**: 팀 협업 허브 (문제 정의, 목표, 사용자 시나리오, 성공 지표)
> **개발자 체크리스트**: Task Issue로 위임 (Epic에 포함하지 않음)

## Workflow Overview

```text
[러프 아이디어]
      ↓
Phase 1: Brainstorming (3단계)
  - 아이디어 이해
  - 접근 방식 탐색
  - 디자인 합의 (Epic 본문 구성)
      ↓
Phase 2: 기술 검증 (선택)
  - spike 필요 여부 판단
  - explore-approach 연계
      ↓
Phase 3: Epic Issue 직접 생성
  - dev-checklist 검증 (Task에 위임할 항목 수집)
  - Epic Issue 생성 (Design Brief 내용 직접 포함)
      ↓
[Speckit으로 진행] → skill:generate-spec
  - spec.md, plan.md, tasks.md 생성
  - Task Issues 자동 생성
```

## Phase 1: Brainstorming

### Step 1: 아이디어 이해

**단일 질문 원칙**으로 핵심 파악:

```markdown
💡 한 가지만 여쭤볼게요:
이 기능으로 사용자가 어떤 문제를 해결하게 되나요?
```

**집중 영역**:

| 영역 | 질문 |
|------|------|
| Purpose | 왜 이 기능이 필요한가? |
| Constraints | 어떤 제한이 있는가? |
| Success | 어떻게 성공을 측정하는가? |

### Step 2: 접근 방식 탐색

2-3가지 옵션을 **객관식**으로 제시:

```markdown
🔍 접근 방식 옵션

**A) 최소 구현 (MVP)**
- 장점: 빠른 검증, 낮은 리스크
- 단점: 기능 제한
- 추천: 아이디어 검증 필요 시

**B) 표준 구현** (권장)
- 장점: 균형잡힌 기능성
- 단점: 중간 복잡도
- 추천: 명확한 요구사항 존재 시

**C) 확장 구현**
- 장점: 완전한 기능 세트
- 단점: 높은 복잡도
- 추천: 장기 로드맵 확정 시

어떤 방향으로 진행할까요? (A/B/C)
```

### Step 3: 디자인 합의

> **📌 Design Brief는 별도 파일로 저장하지 않고, Epic 본문에 직접 포함됩니다.**

Brainstorming 결과를 바탕으로 다음 정보를 수집:

| 섹션 | 수집 내용 |
|------|----------|
| Problem Statement | 현재 상황, 문제점, 영향 |
| Goals | Primary/Secondary 목표, Non-goals |
| User Scenarios | 사용자 행동 → 시스템 응답 → 결과 |
| Constraints | 기술적/비즈니스/사용자 제약 |
| Success Metrics | 측정 가능한 지표 |

이 정보는 Phase 3에서 Epic 본문으로 직접 변환됩니다.

## Phase 2: 기술 검증 (선택)

### spike 필요 여부 판단

**자동 감지 패턴**:

| 패턴 | 예시 |
|------|------|
| 가능성 불확실 | "이게 가능한지 모르겠어" |
| 성능 우려 | "성능이 괜찮을지..." |
| 라이브러리 선택 | "어떤 라이브러리가 좋을지" |
| 복수 옵션 | 구현 방식 간 선택 기준 부재 |

**spike 필요 시**:

```markdown
⚠️ 기술적 불확실성 감지

다음 사항에 대해 spike가 필요해 보입니다:
- {불확실한 기술 주제}

A) spike 먼저 진행 → skill:explore-approach 호출
B) 현재 정보로 계속 → 리스크 인지 후 진행
```

## Phase 3: Epic Issue 직접 생성

### 🔴 dev-checklist 검증 (Task 위임용)

> **개발자 체크리스트는 Epic에 포함하지 않고, Task Issue 생성 시 위임됩니다.**

개발자 관점 체크리스트를 검증하고 결과를 **내부적으로 기록** (Task 생성 시 활용):

| 카테고리 | 검증 항목 |
|----------|----------|
| 데이터 흐름 | 충돌 해결 정책, 멀티플랫폼 동기화, 삭제 정책 |
| 시간/계산 | 집계 기준, 일할 계산, 타임존 |
| 플랫폼 제약 | PWA/웹/네이티브 제약 및 대안 |
| 도메인 지식 | 업계 표준, 엣지 케이스 |

**누락 항목 발견 시**: 사용자에게 추가 정보 요청 후 기록

### Epic 본문 생성

> **📌 Design Brief 내용이 Epic 본문에 직접 포함됩니다.**

```bash
# Epic 본문 (Design Brief 내용 직접 포함)
EPIC_BODY=$(cat <<'EOF'
## 📋 {기능명}

## 🎯 Problem Statement
- **현재 상황**: {현재 사용자 경험}
- **문제점**: {해결해야 할 핵심 문제}
- **영향**: {비즈니스/사용자 영향}

## 🎯 Goals
- **Primary**: {핵심 목표}
- **Secondary**: {부가 목표}
- **Non-goals**: {명시적 범위 외}

## 👤 User Scenarios
1. 사용자가 {action}
2. 시스템이 {response}
3. 결과로 {outcome}

## ⚠️ Constraints
- **기술적**: {기존 스택, 성능}
- **비즈니스**: {일정, 리소스}
- **사용자**: {접근성, 호환성}

## 📊 Success Metrics
- [ ] {측정 가능한 지표 1}
- [ ] {측정 가능한 지표 2}
EOF
)

# Epic Issue 생성
gh issue create \
  --repo semicolon-devteam/docs \
  --title "[Epic] {도메인} · {기능명}" \
  --body "$EPIC_BODY" \
  --label "{project_label}"

# GitHub Projects 연동 + Issue Type 설정
# (create-epic 스킬과 동일한 로직)
```

**Epic 본문에 포함되지 않는 항목**:
- ❌ Design Brief 링크 (내용이 직접 포함되므로 불필요)
- ❌ 개발자 체크리스트 (Task Issue로 위임)

## Output Format

### Ideation 완료

```markdown
[SEMO] Skill: ideate 완료

## 🎯 Ideation Summary

### Epic 생성
- 번호: #{epic_number}
- URL: {epic_url}
- 상태: 검수대기

### Epic 본문 포함 내용
✅ Problem Statement (문제 정의)
✅ Goals (목표)
✅ User Scenarios (사용자 시나리오)
✅ Constraints (제약사항)
✅ Success Metrics (성공 지표)

### 개발자 체크리스트 (Task 위임 예정)
- 데이터 흐름: {검증 결과}
- 시간/계산: {검증 결과}
- 플랫폼 제약: {검증 결과}

> 💡 개발자 체크리스트는 Task Issue 생성 시 각 Task에 포함됩니다.

### 다음 단계
1. **Speckit 실행**: "태스크 만들어줘" 또는 `skill:generate-spec`
   - spec.md, plan.md, tasks.md 생성
   - Task Issues 자동 생성
```

## Usage

```javascript
// 러프한 아이디어
skill: ideate("사용자 참여를 늘리고 싶은데");

// 명시적 기능 구상
skill: ideate({ idea: "댓글 기능", domain: "comments" });

// spike 포함 요청
skill: ideate({ idea: "실시간 알림", spike: true });
```

## Related Skills

- `explore-approach` - 기술 불확실성 탐색 (spike)
- `create-epic` - Epic 생성 헬퍼 (GitHub API 로직)
- `generate-spec` - Speckit 통합 워크플로우 (spec → plan → tasks → Task Issues)

## References

- [Brainstorming Guide](references/brainstorming-guide.md) - 질문 기법, 옵션 설계
- [Dev Checklist](references/dev-checklist.md) - 개발자 관점 검증 항목 (Task 위임용)