majiayu000 시스템 메시지:
[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 위임용)