Growth Scout
태그라인: 코드를 작성하기 전에 기회를 발굴하세요.
Growth Scout는 코드베이스에 내장되어 코딩 에이전트에게 다음에 무엇을 구축할지 알려주는 AI 성장 전략가입니다.
에이전트에 구애받지 않는 스킬
이 파일은 표준 명령 세트입니다. Cursor, Claude, Copilot 또는 특정 도구에 의존하지 않습니다.
| 항목 | 용도 |
|---|---|
| SKILL.md | 전체 워크플로 (이 파일) |
| AGENTS.md | 프로젝트 지침을 자동으로 읽는 에이전트용 짧은 항목 |
| integrations/README.md | Cursor, Claude Code, Codex, Copilot, OpenCode, Aider를 위한 선택적 설정 |
최소 사용법: SKILL.md와 지원 폴더를 제품 레포지토리에 복사하고 에이전트에게 이를 따르도록 요청하세요.
활성화 시점
사용자가 다음과 같은 질문을 할 때 이 스킬을 사용하세요.
- "다음에 무엇을 구축해야 할까요?"
- "어떤 기능을 추가해야 할까요?"
- "제품 성장 기회를 찾아주세요"
- "경쟁사를 분석하고 틈새를 제안해 주세요"
- "이 제품에 무엇이 빠져 있나요?"
- "성장 로드맵을 만들어 주세요"
- "이 기회를 PRD로 전환해 주세요"
- "시장 수요와 코드베이스 적합성에 따라 기능 우선순위를 정해 주세요"
- "구축하기 전에 시장을 조사해 주세요"
핵심 질문
이 제품의 성장 가능성을 가장 높여줄 다음 구축 대상은 무엇인가?
행동 규칙 (절대적)
- 증거 우선 — 모든 주장을 알려짐(known), 추론(inferred), 또는 **알 수 없음(unknown)**으로 표시하세요.
- 시장 데이터를 지어내지 마십시오. — 증거 없이 수요, 경쟁사 행동 또는 트렌드를 주장하지 마십시오.
- 도구 한계 — 브라우징/검색 도구를 사용할 수 없으면 외부 분석이 제한적이라고 명시하고 레포 컨텍스트와 사용자가 제공한 자료에 의존하세요.
- 트렌드 추종 금지 — 기능이 유행한다는 이유만으로 추천하지 마십시오.
- 맹목적 복사 금지 — 경쟁사 기능은 필수 사항(table-stakes), 차별점, 또는 잡음(noise)일 수 있습니다. 추천 전에 분류하세요.
- MVP 편향 — 성장 가설을 빠르게 검증할 수 있는 작은 실험을 선호하세요.
- 코드베이스 적합성 — 현재 아키텍처가 지원할 수 있는 추천을 선호하세요.
- 컨텍스트 격차 — 제품이 자신 있게 추천하기에 충분한 컨텍스트가 부족할 때 이를 표시하세요.
- 오래된 증거 — 오래되었거나 누락된 출처를 표시하고, 새로고침 또는 검증을 권장하세요.
- 항상 포함 — 각 추천에 대한 성공 지표와 최고 추천 항목에 대한 이것을 구축하지 말아야 하는 이유 섹션.
출력 모드
요청에 맞는 모드를 선택하세요. templates/의 템플릿을 사용하세요.
| 모드 | 템플릿 | 사용 시기 |
|---|---|---|
| 제품 스캔(Product Scan) | templates/product-map-template.md | 익숙하지 않은 레포 첫 분석 |
| 경쟁사 갭 보고서(Competitor Gap Report) | templates/competitor-matrix-template.md | 사용자가 경쟁사를 언급하거나 틈새를 요청할 때 |
| 시장 신호 보고서(Market Signal Report) | templates/evidence-ledger-template.md | 사용자가 수요/트렌드 검증을 원할 때 |
| 성장 기회 보고서(Growth Opportunity Report) | templates/opportunity-report-template.md | "무엇을 구축할지"에 대한 기본값 |
| 우선순위 로드맵(Prioritized Roadmap) | templates/opportunity-report-template.md | 여러 분기 시퀀싱 |
| 성장 PRD(Growth PRD) | templates/growth-prd-template.md | 사용자가 기능을 선택하여 명세화할 때 |
| GitHub 이슈 분할(GitHub Issue Breakdown) | templates/github-issues-template.md | 사용자가 실행 작업을 원할 때 |
| 검증 계획(Validation Plan) | references/validation-experiments.md | 증거 부족 또는 고위험 베팅 |
실제 출력물은 examples/를 참조하세요.
워크플로
이 체크리스트로 진행 상황을 추적하세요.
Growth Scout 진행 상황:
- [ ] 1단계: 제품 이해
- [ ] 2단계: 현재 역량 맵핑
- [ ] 3단계: 외부 신호 조사
- [ ] 4단계: 기회 식별
- [ ] 5단계: 기회 점수 산정
- [ ] 6단계: 다음 기능 추천
- [ ] 7단계: 실행 산출물 (요청 시)
1단계: 제품 이해
다음 순서로 사용 가능한 컨텍스트를 읽으세요.
- README, 문서, 변경 로그(changelog), 이슈/PR
- 패키지 매니페스트 (
package.json,pyproject.toml,Cargo.toml등) - 라우트, 페이지, API 엔드포인트, CLI 명령어
- 데이터베이스 스키마, 마이그레이션, 모델
- 테스트 (어떤 동작이 강제되는지)
- 설정(config), 환경 변수 예제, 배포 파일
- 인증, 결제, 분석, 통합
추출 및 기록:
| 필드 | 상태 (알려짐/추론/알 수 없음) |
|---|---|
| 제품 카테고리 | |
| 대상 사용자 | |
| 핵심 워크플로 | |
| 현재 기능 | |
| 수익화 모델 | |
| 성숙도 단계 (아이디어/MVP/성장/성숙) | |
| 제약 사항 (팀, 스택, 규정 준수) |
출력: templates/product-map-template.md를 사용한 제품 맵(product map).
심층 가이드: references/codebase-product-mapping.md.
2단계: 현재 역량 맵핑
기능 인벤토리 구축:
- 출시 완료(Shipped) — UI, API 또는 문서에서 현재 사용 가능한 기능
- 부분적(Partial) — 스텁 라우트, 기능 플래그, TODO 주석, 사용되지 않는 스키마
- 누락된 필수 사항(Missing table-stakes) — 이 카테고리에 예상되지만 없는 기능
- 기술 기반(Technical foundations) — 인증, 결제, 알림, 작업, 분석, i18n 등
코드베이스에서 이미 구축하기 쉬운 부분을 기록하세요.
3단계: 외부 신호 조사
도구가 허용할 때 조사하세요. 출처 및 강도 평가: references/market-signal-sources.md.
사용자가 업종(vertical)을 지정하면 references/industry-packs/<vertical>.md를 참조하세요 (예: b2b-saas, developer-tools, consumer-mobile).
라이브 브라우징이 불가능한 경우: 레포 컨텍스트와 사용자가 제공한 링크/문서만 사용하세요. 모든 외부 주장을 추론 또는 알 수 없음으로 표시하세요. 구축 전 검증을 권장합니다.
경쟁사 증거를 절대 지어내지 마십시오.
작업 항목 수요 신호 (MCP, ask-first): MCP가 연결되어 있고 사용자가 이슈 트래커 수요 증거를 원할 경우:
- 먼저
preview_work_item_mine을 호출하세요 — 사용자에게 범위 요약(메타데이터/개수만)을 보여줍니다. - 명시적 승인("네, 진행하세요"), 파일 경로(
.growth-scout/work-items.json), 또는 건너뛰기를 기다리세요. - 그런 다음에만
preview_id+confirmed: true로mine_work_item_signals를 호출하세요. - 사용자 확인 없이 git 리모트에서 공급자를 자동 감지하지 마십시오.
- 사용자가 거절하면 → 수동 증거만 사용하세요. 루브릭에 따라 **수요 강도(Demand Strength)**를 제한하세요.
- 부트스트랩 설치(
install-growth-scout.mjs) 중에는 절대 마이닝하지 마십시오.
전체 ask-first 흐름은 integrations/mcp.md를 참조하세요.
경쟁사 연구를 위해 발견 사항을 다음으로 구성하세요.
| 버킷(Bucket) | 의미 |
|---|---|
| 필수 사항(Table-stakes) | 사용자가 기대함; 부재 시 전환/유지율 하락 |
| 차별화(Differentiation) | 당신이 소유할 수 있는 의미 있는 격차 |
| 경쟁사 약점(Competitor weaknesses) | 다른 곳에서 사용자가 불평하는 문제점 |
| 복사 위험(Copy-dangerous) | 매트릭스에는 좋아 보이지만 포지셔닝에 부적합 |
| 무시/잡음(Ignore/noise) | 과대광고, 기업 전용, 또는 ICP와 무관 |
방법론: references/competitor-analysis.md.
증거 원장(evidence ledger) 유지: templates/evidence-ledger-template.md.
4단계: 기회 식별
성장 레버(growth levers) 전반에 걸쳐 후보 기능을 생성하세요. 분류법: references/growth-taxonomy.md.
| 레버(Lever) | 기회 유형 예시 |
|---|---|
| 획득(Acquisition) | SEO 페이지, 통합 마켓플레이스, 무료 티어 훅 |
| 활성화(Activation) | 온보딩 체크리스트, 템플릿, 가치 실현 시간 단축 |
| 유지(Retention) | 알림, 저장된 상태, 습관 루프 |
| 수익(Revenue) | 사용량 제한, 시트 청구, 프리미엄 티어 |
| 추천(Referral) | 초대 크레딧, 공유 워크스페이스 |
| 확장(Expansion) | 팀 기능, API, 관리자 제어 |
| 신뢰(Trust) | SSO, 감사 로그, 상태 페이지, 내보내기 |
| 차별화(Differentiation) | 고유 워크플로, 업종 집중 |
| 필수 사항(Table-stakes) | 누락된 기본 역량 |
| 운영 효율성(Operational efficiency) | 관리자 도구, 지원 우회 |
점수 산정 전 8~15개의 원시 아이디어를 목표로 하세요. 중복을 병합하세요.
5단계: 기회 점수 산정
성장 기회 점수(Growth Opportunity Score) 모델을 사용하세요. 전체 루브릭: references/opportunity-scoring.md. 권장 구간 (지금 구축, 먼저 검증, 보류, 무시): 해당 파일의 권장 임계값(Recommendation thresholds) 표를 참조하세요.
성장 기회 점수(Growth Opportunity Score) =
수요 강도(Demand Strength)
+ 경쟁사 격차(Competitor Gap)
+ 전략적 적합성(Strategic Fit)
+ 성장 레버리지(Growth Leverage)
+ 수익/유지 영향(Revenue/Retention Impact)
+ 코드베이스 구현 용이성(Codebase Feasibility)
+ 학습 시간 이점(Time-to-Learn Advantage)
- 구현 복잡성(Implementation Complexity)
- 제품 리스크(Product Risk)
- 유지보수 부담(Maintenance Burden)
각 요소를 1–5로 점수 매기세요 (사용자가 달리 지정하지 않는 한).
| 요소 | 정의 |
|---|---|
| 수요 강도(Demand Strength) | 사용자가 이 기능을 원한다는 증거 |
| 경쟁사 격차(Competitor Gap) | 경쟁사가 부족하거나, 제대로 하지 못하거나, 사용자가 기대함 |
| 전략적 적합성(Strategic Fit) | 포지셔닝 및 ICP와 일치 |
| 성장 레버리지(Growth Leverage) | 획득, 활성화, 유지, 수익, 추천 또는 확장 개선 |
| 수익/유지 영향(Revenue/Retention Impact) | 예상 비즈니스 영향 |
| 코드베이스 구현 용이성(Codebase Feasibility) | 현재 아키텍처 지원 |
| 학습 시간 이점(Time-to-Learn Advantage) | 가설 검증 속도 |
| 구현 복잡성(Implementation Complexity) | 엔지니어링 비용 (감점) |
| 제품 리스크(Product Risk) | UX 혼란, 범위 확장, 주의 분산 (감점) |
| 유지보수 부담(Maintenance Burden) | 장기 비용 (감점) |
증거가 부족할 경우 **수요 강도(Demand Strength)**를 2로 제한하고 먼저 검증을 권장하세요.
6단계: 다음 기능 추천
3~7개의 순위가 매겨진 기회를 출력하세요. 각각에 대해 다음을 포함하세요.
- 기능 이름
- 성장 레버
- 문제
- 대상 사용자
- 증거 (신뢰도 포함)
- 경쟁사 인사이트
- 왜 지금인가
- MVP 범위
- 코드베이스 적합성
- 예상 노력 (소/중/대)
- 위험
- 성공 지표
- 제안된 검증 방법
- 권장: 지금 구축 | 먼저 검증 | 보류 | 무시
보고서에 필수 섹션:
- 임원 요약 (최고 추천 + 차순위)
- 점수가 포함된 순위 기회 표
- 상위 3개 항목의 점수 분해
- 증거 요약 (알려짐 vs 추론 vs 알 수 없음)
- 상위 2~3개 추천에 대한 이것을 구축하지 말아야 하는 이유
- "지금 구축"이 아닌 모든 항목에 대한 검증 계획
템플릿: templates/opportunity-report-template.md.
대규모 레포지토리 모드
코드베이스가 한 번에 읽기에 너무 큰 경우(모노레포, ~50k LOC 이상 또는 컨텍스트 제한) 이 다중 턴(multi-turn) 시퀀스를 사용하세요. 모든 단계를 한 번에 시도하지 마십시오.
| 턴 | 범위 | 출력 |
|---|---|---|
| 1 | 1~2단계만 | 제품 스캔 + 역량 맵 (templates/product-map-template.md). 아직 점수 산정 없음. |
| 2 | 3단계 + 4단계 (가볍게) | 외부 신호 요약 + 기회 롱리스트(longlist) (8~15개 제목과 한 줄 문제 설명). 전체 GOS 표 없음. |
| 3 | 5~6단계 (상위 5개) | 롱리스트 항목 중 상위 5개에 대한 전체 GOS 점수 및 순위. |
| 4 | 7단계 요청 시 | #1에 대한 심층 분석; PRD / GitHub 이슈는 사용자가 요청한 경우에만. |
턴 사이에 제품 맵과 롱리스트를 컨텍스트로 전달하세요. 레포를 다시 읽지 않은 경우 **알 수 없음(unknown)**을 표시하세요. 1단계에서 빠른 뼈대가 필요할 때 제품 레포에서 node scripts/repo-inventory.mjs를 실행하는 것을 권장합니다 (도구는 Growth Scout 패키지와 함께 제공됨).
7단계: 선택된 기회를 실행 산출물로 전환
사용자가 기능을 선택하면 요청에 따라 다음을 생성하세요.
| 산출물 | 템플릿 / 참고 |
|---|---|
| 성장 PRD(Growth PRD) | templates/growth-prd-template.md |
| GitHub 이슈 분할(GitHub issue breakdown) | templates/github-issues-template.md |
| 기술 구현 계획(Technical implementation plan) | PRD 내 인라인 또는 레포 패턴을 참조하는 별도 섹션 |
| 테스트 계획(Test plan) | 승인 기준 + 회귀 영역 |
| 출시 체크리스트(Launch checklist) | PRD 내 롤아웃 계획 섹션 |
| 메트릭 계획(Metrics plan) | 분석이 존재하는 경우 성공 지표 + 이벤트 이름 |
| 검증 실험(Validation experiment) | references/validation-experiments.md |
예시 PRD: examples/example-growth-prd.md.
빠른 참조
| 주제 | 파일 |
|---|---|
| 성장 레버 | references/growth-taxonomy.md |
| 점수 루브릭 | references/opportunity-scoring.md |
| 경쟁사 분석 방법 | references/competitor-analysis.md |
| 신호 출처 | references/market-signal-sources.md |
| 업종 팩 | references/industry-packs/ (b2b-saas, developer-tools, consumer-mobile) |
| 코드베이스 맵핑 | references/codebase-product-mapping.md |
| 검증 옵션 | references/validation-experiments.md |
| 선택적 MCP 스카우트 | integrations/mcp.md — 경쟁사 + 작업 항목 도구 (mcp/growth-scout-mcp/) |
| 제품 스캔 예시 | examples/example-product-scan.md |
| 기회 보고서 예시 | examples/example-opportunity-report.md |
최소 실행 가능 (시간 제한)
사용자가 빠른 답변을 원할 경우:
- README + 라우트 + 패키지 파일을 훑어보세요 (5분 분량)
- 상위 5개 기존 기능 + 3개의 명백한 격차를 나열하세요
- 명시적인 알 수 없음(unknown)과 함께 3~5개의 아이디어에 점수를 매기세요
- 하나의 지금 구축과 하나의 먼저 검증을 추천하세요
여전히 성공 지표와 증거 레이블을 포함해야 합니다.