discover-product
Skill2 starsChanged 48 days agoMITView on GitHub
Run a multi-round discovery (persona / pain / JTBD / scenario / MVP / assumptions) and write DISCOVERY.md.
In this repository51 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accept-milestoneSkill
- bootstrap-projectSkill
- bootstrap-stackSkill
- consult-expertSkill
- design-milestoneSkill
- finalize-workitemSkill
- implement-workitemSkill
- plan-milestoneSkill
- plan-workitemSkill
- repair-acceptanceSkill
- repair-discoverySkill
- repair-milestoneSkill
- repair-planSkill
- repair-workitemSkill
- run-milestoneSkill
- seal-milestoneSkill
- stabilize-milestoneSkill
- stack-guardSkill
- validate-discoverySkill
- validate-milestoneSkill
- validate-planSkill
- validate-workitemSkill
- accept-milestoneSkill
- amend-ssotSkill
- boilerplate-contextSkill
- bootstrap-designSkill
- bootstrap-projectSkill
- bootstrap-stackSkill
- consult-expertSkill
- design-milestoneSkill
- finalize-workitemSkill
- implement-workitemSkill
- plan-milestoneSkill
- plan-workitemSkill
- repair-acceptanceSkill
- repair-discoverySkill
- repair-milestoneSkill
- repair-planSkill
- repair-workitemSkill
- research-packSkill
- review-docSkill
- run-milestoneSkill
- seal-milestoneSkill
- stabilize-milestoneSkill
- stack-guardSkill
- validate-discoverySkill
- validate-milestoneSkill
- validate-planSkill
- validate-workitemSkill
The file
Files
이 skill은 메인 세션이 R0R4 라운드를 직접 운전하는 절차서다.
무거운 추론(R0의 페르소나 후보, R1의 pain inventory)은 architect 단발 sub-call로 위임한다.
R0R3 산출물은 메인 컨텍스트에 누적시키지 않고 docs/10-charter/DISCOVERY.md에 누적 적재한다.
트레이드오프 명시 — 이 skill은 의도적으로 fork 격리를 풀고 메인 세션이 사용자 인터랙션을 직접 운전한다. R0~R3 산출물은 DISCOVERY.md에 적재해 메인 컨텍스트 부담을 최소화하지만, 라운드 요약 일부는 메인에 남는다. 종료 후 사용자가 /clear 또는 새 세션으로 컨텍스트를 정리할 것을 권장한다.
Codex: 본 skill은 wrapper 미보유(자연어 호출) — Codex에서는 "Follow .claude/skills/discover-product/SKILL.md"로 호출한다(목록 SSOT = README, ADR-010#amend-3·#amend-4).
입력:
$ARGUMENTS에 자연어 설명이 들어온다.--fast플래그가 있으면 R0의 페르소나 후보 제시·선택을 건너뛰고 R3(가정 정리)도 생략한 채 R1+R2+R4만 도는 단축 흐름. 단, R1은 페르소나 입력이 필요하므로 다음 절차로 페르소나를 확보한다:$ARGUMENTS에 페르소나가 한 줄이라도 명시되어 있으면 그것을 그대로 사용한다(예:--fast 회고 SaaS — 페르소나: 직장인 개인 사용자).- 명시되지 않았으면 architect 단발 sub-call로 페르소나 후보 1개를 자동 선정하고, 해당 페르소나를 가정으로 표시해 R1을 진행한다(출력에 "이 페르소나는 fast 모드의 R0 사용자 확인 단계를 생략한 자동 선정 결과이며, 가정으로 취급한다"를 명시).
- 사용자가 마음에 들지 않으면
/discover-product(fast 없이)로 재실행하면 된다는 안내를 출력에 포함.
사용자 응답 수단:
- 라운드별 응답은 자연어로만 받는다(
AskUserQuestion은 공식 문서의 Limitations 섹션 기준 sub-agent에서 사용 불가). - 매 라운드 끝에
skip/good/refine: ...로 응답할 수 있다.
라운드 출력 포맷 (ADR-046 출력 스타일 — 사용자-facing 표면만 압축, 내부 분석·DISCOVERY.md 적재 내용은 불변): 각 라운드는 다음 고정 포맷으로 압축해 출력한다.
이번 결정: <1~2줄>
확인 필요: <있으면 ≤3개, 없으면 생략>
답변: skip / good / refine: …단, 사용자가 선택해야 하는 옵션(R0 페르소나 후보·R1 pain 목록 등)은 선택 가능하도록 보존한다 — 압축은 framing·서술에만 적용하고 선택지 자체는 빠뜨리지 않는다(ADR-046#d3). architect 단발 sub-call의 과정만 대화에 풀어쓰지 않는다.
라운드 구성:
R0 — 문제 한 줄 + 페르소나 확인
- 입력 한 줄을 그대로 되돌려 "이 한 문장이 핵심 맞나" 확인.
- 동시에 페르소나 후보 2~3개를 한 단락씩 제시(직무·맥락·일과·압력 요소). architect 단발 sub-call로 위임해 후보 생성.
- 사용자가 1개를 고르거나 합쳐달라고 한다.
R1 — 핵심 pain + JTBD + 시나리오
- 선택된 페르소나의 pain 6~10개를 brainstorm 후 빈도×고통으로 정렬. architect 단발 sub-call.
- 상위 1~3개를 사용자가 고른다.
- 가장 큰 pain의 JTBD(Jobs To Be Done) 한 줄, happy path/alternate path/fail path를 5~7단계로 같이 적는다.
- 사용자가 끊을 지점·수용 가능 fail을 정한다.
R2 — MVP 범위 vs 비범위 / 성공 기준
- R1 시나리오를 충족시키는 최소 기능 묶음과 의도적으로 미루는 것을 분리.
- 측정 가능한 성공 기준 1~3개.
R3 — 핵심 가정 + 미결정 등재
- R0~R2에서 사용자가 추측으로 답한 모든 항목을 가정으로 표시.
- 가장 위험한 가정 1~3개에 검증 방법 1줄 + 위험도 판정(ADR-035#amend-3 / ADR-060 D5): 실패 시 다음 마일스톤 목표가 무효가 되는 핵심 가설인가, 실험 대상인가, 저위험인가. 실험·저위험이면 검증 방법·판정일·중단 기준 3필드를 채워 원장에
risk-accepted후보로 올린다. - 미결정은
DISCOVERY.md에 남기지 않는다 —docs/10-charter/DECISION_REGISTER.md에 등재한다(아래## 결정 마감). DISCOVERY## 11은 폐지됐다(ADR-060 D1).
R4 — DISCOVERY.md 정리(저장 단계)
- 위 결과를
docs/10-charter/_templates/DISCOVERY_TEMPLATE.md양식에 맞춰docs/10-charter/DISCOVERY.md에 저장.## 11은 폐지 섹션이므로 만들지 않는다. - 이 라운드에서 발생한 미결정·가설을
docs/10-charter/DECISION_REGISTER.md에 등재한다(아래## 결정 마감). - 이 skill은 charter/architecture를 만들지 않는다 —
/bootstrap-project가 이어 수행한다(자동 호출 아님).
단계별 출구 보장: 어느 라운드에서 멈춰도 그때까지의 산출물이 DISCOVERY.md에 들어가 /bootstrap-project의 입력으로 의미가 있다.
다국어: 입력 언어를 따른다. 한국어 입력이면 산출물도 한국어, 영문 입력이면 영문.
마지막 출력:
- DISCOVERY.md 경로
- 핵심 가정 요약
- 원장 요약:
closed N건 / deferred M건 / open K건(open이 있으면 그 항목의authority와 필요 시점을 1줄씩) - 다음 권장 단계 (
/bootstrap-project— DISCOVERY.md를 입력으로 사용) - (opt-in, ADR-044) 기획 품질 확신이 부족하면: 다른 세션·다른 LLM에서
/validate-discovery --reviewer-tag <tag>1+회 → 원본 세션에서/repair-discovery회수. 건너뛰어도 정상.
--update 모드 (mid-project pivot, ADR-035#amend-2)
기존 DISCOVERY.md 있으면:
- R-E (Evidence 회수): 지난 갱신 이후 추가된 §14 Evidence Log 신규 행 +
docs/10-charter/insights/의 노트(/research-pack산출 +/consult-expert도메인 노트)를 읽어 §15 Insight Backlog를 갱신(새 insight는 새 I-N, evidence는 §14에 적재).type: quant행은 본 skill 이 직접 해석하지 않는다 (ADR-042#amend-2 결정 2) — 정량 해석과confidence판정은analyst소유다. (a) 그 quant 를 해석한insights/<YYYY-MM-DD>-data-*.md노트가 있으면 그 노트의 인사이트를 받아 적는다, (b) 없으면 해석하지 않고 출력에Needs Quant Interpretation: <evidence ID> — /consult-expert data 권장1줄만 보고한다(자동 위임하지 않는다 — 명시 호출만. ADR-062 D10). 정성(qual) 행은 기존대로 본 skill 이 직접 처리한다.
- R0 (페르소나 재확인) → R1·R2 (opportunity backlog 갱신·새 pain 추가) → R3 (assumption tracker 갱신 — §14 evidence로 §12 검증 결과 갱신) → R4 저장.
--fast --update: §12 Assumption Tracker + §14 Evidence Log만 빠르게 갱신 (가장 빈번한 mid-project use case).
Idempotency (ADR-035)
ID 매칭 — 기존 ID(A-1·A-2)면 검증일·다음 행동만 갱신, 새 가정이면 새 ID 부여. DISCOVERY.md = persona/scenario/assumption SSOT, Charter는 snapshot view.
출력 스타일 (ADR-046)
라운드 표면 출력은 위 "라운드 출력 포맷"을 따른다 — 라운드 수·분석 깊이는 줄이지 않고 표면 분량만 압축한다.
결정 마감 (ADR-060)
본 skill이 내리거나 발견하는 기획 결정 중 사용자가 정하거나 승인해야 할 것을 docs/10-charter/DECISION_REGISTER.md에 등재한다 — 대화 출력으로만 두지 않는다.
- 등재 시점에
authority를 확정한다 (ADR-060 D2): 제품 의도·범위·우선순위·사용자 체감·외부 계약·데이터/보안·비용·위험 허용도·비가역 약속 →user-choice. 스택·인증·데이터 경계·되돌리기 비싼 구조 →user-approval. 승인된 경계 안의 가역적 내부 선택 →agent-delegated.user-*를agent-delegated로 낮추려면 사용자 명시 승인 + 항목에 이력 줄이 필요하다. - 등재 범위 (원장을 얇게 유지):
user-*결정 전부 + 종류 불문open/deferred로 남는 항목만 등재한다.agent-delegated는 개별 등재하지 않고 4의 일괄 확인으로만 처리한다. 코드 품질·형식 지적과 계획 결함은 원장 대상이 아니다 — 기존남은 미결정 사항출력 슬롯이 그대로 소유한다. user-*결정은 Decision Brief 6블록으로 제시한다 (ADR-060 D3 / ADR-046#amend-1 — 압축 예외): 배경(왜 지금) → 용어(배경 없이도 이해되게) → 선택지 2~3안(각각 한 줄 요약·이 프로젝트에서의 체감·장점·감수할 것) → 되돌리기 비용 → 추천+근거 → 답변 방법. 라운드당 3~5개 상한,skip불허(선택 / 추가 설명 / 리서치 요청 / 연기 중 택1). 답변은 평이한 문장으로 재진술해 확인한 뒤 정본에 기록한다.- 라운드 종료 시 일괄 확인 1회: 그 라운드의
agent-delegated결정을 목록으로 제시하고 "바꿀 것 있으면 알려달라"를 1회 확인받는다. 사용자가 뒤집으면 그 항목은user-approval로 원장에 등재한다. - 닫히지 않은 항목: 현재 M 무영향 + 이관 앵커 + 회수 시점 3개를 모두 갖추면
deferred, 아니면open으로 남긴다(ADR-060 D4). 앵커 없는 유예는 금지한다. 현재 M을 막는 사실 조사는deferred가 아니라/research-pack선행으로 종결한다. - 결정 본문은 본 skill이 소유한 정본 문서(DISCOVERY / Charter / ARCHITECTURE / DESIGN / ADR 중 해당 단계에 존재하는 것)에 쓰고, 원장에는 위치 앵커와 처분 상태만 적는다(ADR-005). 본 skill이 소유하지 않는 문서는 건드리지 않는다.
- 마일스톤이 아직 없는 단계(discover/bootstrap)에서는
영향: (미할당)으로 등재한다./plan-milestoneR1이 triage한다.
Context 정책 (ADR-019)
반드시 먼저 읽을 파일은 최소 충분. 추가 ADR/architecture 섹션은 task 본문에서 발화 시 인용 — 사전 fork-load 금지.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

