시스템 메시지:

[SEMO] Skill: ideate 호출 - {아이디어 요약}

ideate Skill

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

핵심 원칙

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

Workflow Overview

[러프 아이디어]
      ↓
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: 아이디어 이해

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

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

집중 영역:

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

Step 2: 접근 방식 탐색

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

🔍 접근 방식 옵션

**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 필요 시:

⚠️ 기술적 불확실성 감지

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

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

Phase 3: Epic Issue 직접 생성

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

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

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

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

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

Epic 본문 생성

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

# 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 완료

[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

// 러프한 아이디어
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 - 질문 기법, 옵션 설계
• Dev Checklist - 개발자 관점 검증 항목 (Task 위임용)