| name | plan-2-draft |
| description | 기획 시작 스킬. "기획 시작", "기획 시작해주세요", "플래닝 시작", "새 기획", "기획 킥오프" 등의 요청 시 트리거. plan-1이 확정한 프로젝트의 Memory(용어집·플로우차트)를 로드하고, 기존 플로우/로직과의 정합성을 검사하여 기획 초안을 작성한다. AI Driven Development 파이프라인의 2단계. |
| compatibility | notion-fetch MCP 툴 필요 |
기획 시작 (AI Driven Development Step 2/6)
이 스킬은 AI Driven Development 파이프라인의 두 번째 단계이다.
완료 후 사용자에게 Step 3: Edge Case 검사 스킬 사용을 안내한다.
전제 조건
Step 1(브레인스토밍)의 로컬 md 파일(.claude/docs/brainstorm-*.md)이 존재해야 한다.
파일이 없으면 사용자에게 "먼저 '아이디어 정리해주세요'로 Step 1을 완료해 주세요"라고 안내한다.
로컬 md 파일에 Notion 상세 문서 링크가 있으면 해당 Notion 페이지도 notion-fetch로 로드한다.
Memory Bootstrap (공통)
이 스킬은 Notion Memory를 읽기 전용으로 참조한다. 실행 시 아래 순서로 Memory URL을 확보한다.
.claude/docs/brainstorm-*.md의 프론트매터에서 아래 값을 읽는다:
project_nameglossary_urlflowchart_urlprinciple_urlconstraint_url
- 이 단계에서 사용할 memory:
glossary_url, flowchart_url
- URL이 누락되었으면 해당 검사를 스킵하고 사용자에게 보고한다. ("이 프로젝트의 glossary URL이 없어 용어 정합성 검사를 스킵합니다")
- 프론트매터 자체가 없으면 "plan-1부터 다시 실행해 주세요" 안내 후 중단.
출력 전략
토큰 절감과 가독성을 위해 출력 채널을 분리한다.
| 채널 | 용도 | 내용 |
|---|
| 터미널 | 대화 전용 | 질문, 응답, 간단한 요약 (3줄 이내) |
| Notion | 상세 문서 | 기획 초안 전문, 정합성 검사 결과, 기능 상세 |
| 로컬 md | 파이프라인 입력 | plan-3-edge-case가 참조할 구조화된 요약 + Memory URL 프론트매터 계승 |
터미널 출력 규칙
- 정합성 검사 결과: 이슈가 있는 항목만 터미널에 요약. 전체 결과는 Notion에 작성.
- 기획 초안: 기능 목록 요약만 터미널에 출력. 기능 상세는 Notion에 작성.
- 완료 시: Notion 링크와 로컬 파일 경로만 터미널에 출력.
Notion 저장
Step 1에서 확보한 Notion 페이지에 이어서 작성한다.
Step 1의 로컬 md 파일에서 Notion 페이지 URL을 읽어온다.
로컬 md 파일
-
저장 경로: 프로젝트 루트의 .claude/docs/draft-{기획주제}.md
-
프론트매터는 plan-1의 값을 그대로 계승하여 기록한다 (plan-3~6 전파용):
---
project_name: {plan-1에서 계승}
glossary_url: {URL}
flowchart_url: {URL}
principle_url: {URL}
constraint_url: {URL}
---
-
본문은 plan-3-edge-case 및 plan-6-document가 참조할 수 있도록 아래 구조로 작성:
- 기획 주제, 목적, 배경, 범위
- 사용자 정의 (대상 유저 / 행동 특성 / etc. — plan-6 "사용자 정의" 섹션에 사용)
- 가설 (만약 X가 Y한다면 Z할 것이다 — plan-6 "가설" 섹션에 사용)
- 기능 목록 (F-ID, 기능명, 우선순위)
- 정합성 검사 결과 요약
- 검증 계획 초안
- Notion 상세 문서 링크
1단계: 참조 문서 로드 (Memory 기반)
Memory Bootstrap으로 확보한 URL을 순서대로 notion-fetch로 읽는다.
1-1. Glossary 로드
glossary_url을 fetch하여 용어 정의 표를 확보한다. 페이지 본문에서 용어명·정의·금지 표기를 파싱한다.
1-2. Flowchart 로드 (2단계 fetch)
flowchart_url을 fetch한다. 반환 결과에 <database inline="true"> 태그가 있으면 데이터베이스 형태이다:
- DB의 data source URL(
collection://...)을 이용해 전체 row 목록을 조회한다 (row 필터 없음 — 상태/검토 여부 속성 무시).
- 각 row의 title을 모아 기획 주제 키워드와 매칭되는 row만 개별
notion-fetch로 Mermaid 본문까지 읽는다.
- 직접 매칭되지 않더라도 인접 영역(관련 화면·엔티티)의 row는 추가 로드 대상으로 사용자에게 제안할 수 있다.
페이지 형태(인라인 DB가 없는 단일 Mermaid 페이지)라면 본문을 한 번에 확보한다.
1-3. 오류 처리
- 401/404: Notion 커넥터(OAuth) 연결 및 페이지 권한 재확인 안내.
- URL 누락: 해당 검사(용어 정합성 또는 플로우 매핑) 스킵 공지 후 계속 진행.
2단계: 기획 주제 및 범위 확인
사용자에게 다음을 확인한다.
2-1. 기본 정보
- 어떤 기능 / 화면 / 서비스에 대한 기획인지
- 기획의 목적과 배경 (신규 기능, 개선, 실험 등)
- 특별히 강조하거나 포함해야 할 내용이 있는지
- 이번 기획의 범위 — 포함할 것과 제외할 것
2-2. 사용자 정의 (plan-6 "사용자 정의" 섹션 입력 소스)
대상 유저를 구체적으로 정의하기 위해 아래 항목을 질문한다. 답변은 다음 단계에서 표로 정리된다.
| 항목 | 질문 |
|---|
| 대상 유저 | "이번 시도의 대상이 되는 유저는 누구입니까? (예: 신규 가입자, 헤비 유저, 휴면 사용자 등)" |
| 행동 특성 | "그 유저가 가진 특징적인 행동 패턴은 무엇입니까? (예: 매일 앱 실행, 앨범 5개 이상 보유 등)" |
| etc. | "그 외 추가로 정의해야 할 특성이 있습니까? (예: 디바이스, 지역, 가입 경로 등 — 없으면 생략 가능)" |
대상 유저가 여러 그룹이면 각각을 별도 행으로 분리하여 받는다.
2-3. 가설 (plan-6 "가설" 섹션 입력 소스)
이번 시도로 검증하고자 하는 가설을 아래 형식으로 받는다.
만약 (대상)가(이) (특정 행동)을 한다면, (기대 하는 결과)할 것이다.
- 사용자가 자유 서술로 답변한 경우 위 형식으로 LLM이 변환한 후 사용자에게 다시 보여 확인을 받는다.
- 가설이 여러 개면 우선순위(P0/P1/P2 등)를 함께 받는다.
- 가설이 명확히 정의되지 않으면 brainstorm-*.md의 "해결 방향"을 참조하여 LLM이 초안을 제시하고 사용자가 수정한다.
3단계: 기존 플로우/로직 정합성 검사
로드된 참조 문서를 기반으로 아래를 수행한다.
3-1. 기존 플로우 매핑
Flowchart DB에서 로드한 row들 중 이번 기획과 관련된 기존 흐름을 식별한다.
| 관련 기존 플로우 (row) | 연결 지점 | 영향 |
|---|
| (row 제목) | (Mermaid 노드 중 어디에서 분기/합류하는지) | (추가/변경/없음) |
3-2. 기존 기능 연계 확인
Flowchart DB의 각 row 제목과 Mermaid 본문이 곧 기능/화면 카탈로그 역할을 한다. 이번 기획과 겹치거나 영향받는 기능을 row 단위로 식별한다.
| 기존 기능 (row) | 관계 | 영향도 | 비고 |
|---|
| (row 제목) | (확장/변경/의존) | (높음/중간/낮음) | (Mermaid 내 구체 노드 언급) |
3-3. 용어 정합성
사용자 설명에 사용된 용어를 Glossary와 대조한다. 금지 표기 사용 또는 정의 불일치가 있으면 권장 표기로 치환을 제안한다.
3-4. 정합성 이슈 보고
검사 결과 충돌이나 주의사항이 있으면 아래 형식으로 사용자에게 보고한다.
| 이슈 ID | 유형 | 내용 | 권장 조치 |
|---|
| C-001 | 플로우 충돌 / 기능 중복 / 용어 불일치 | (설명) | (제안) |
사용자와 논의하여 각 이슈의 처리 방향을 결정한다.
4단계: 기획 초안 작성
정합성 검사를 반영하여 기획 초안을 아래 구조로 작성한다.
기획 초안
| 항목 | 내용 |
|---|
| 기획 주제 | |
| 목적 | |
| 배경 | |
| 범위 - 포함 | |
| 범위 - 제외 | |
사용자 정의
2-2에서 받은 답변을 표로 정리한다 (plan-6 "사용자 정의" 섹션에 그대로 옮겨진다).
가설
2-3에서 받은 답변을 옮긴다 (plan-6 "가설" 섹션에 그대로 옮겨진다).
만약 (대상)가(이) (특정 행동)을 한다면, (기대 하는 결과)할 것이다.
가설이 여러 개인 경우 우선순위와 함께 나열한다.
기능 목록 (초안)
| 기능 ID | 기능명 | 연계 기존 기능 | 우선순위 | 상태 | 간략 설명 |
|---|
| F-001 | | | must / should / could | 신규 / 변경 / 확장 | |
기능 상세 (초안, 기능 ID별 반복)
각 기능에 대해 아래를 작성한다:
선행 조건
사용자 입력
사용 흐름
성공 결과
검증 계획 초안
brainstorming 단계에서 논의된 성공 기준을 기반으로 작성한다.
논의된 내용이 없으면 사용자에게 아래 항목을 직접 질문하여 채운다.
| 항목 | 내용 |
|---|
| 확인할 지표 | (예: 앨범 등록 완료율, 등록 후 이탈률) |
| 성공 기준 | (예: 기존 대비 완료율 10% 이상 향상) |
| 확인 방법 | (예: 앱 내 이벤트 로그 분석, CS 문의량 추이) |
| 검증 시점 | (예: 출시 후 2주) |
관련 서비스 및 기능
정합성 검사 결과 요약
5단계: 사용자 확인 및 다음 단계 안내
기획 초안을 Notion 페이지에 작성하고 로컬 md 파일에 요약 + 프론트매터를 저장한 뒤, 사용자에게 Notion 링크와 로컬 파일 경로를 안내한다.
수정 사항이 있으면 Notion과 로컬 md를 모두 업데이트한다.
합의 후 아래 메시지로 다음 단계를 안내한다:
✅ 기획 초안 완료 (Step 2/6)
다음 단계로 Edge Case 검사를 진행합니다.
아래와 같이 요청해 주세요:
👉 "edge case 검사해주세요"
