본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Agentic MVP

핵심 개념

Agentic MVP 원리가설을 문장으로 고정실험 설계실험 타입 선택

Agentic 운영

Agentic 운영 체계컨텍스트 팩7일 실행 플랜

측정 & 품질

계측(Measure) 최소 세트품질·보안·신뢰

출시 & 의사결정

출시 & 성장 실험Go / Pivot / Kill템플릿 & 프롬프트

부록

업데이트 내역검증 리포트
핸드북›Agentic MVP›템플릿 & 프롬프트
한국어English

템플릿 & 프롬프트

Agentic MVP를 바로 실행하게 해주는 제품·GTM 문서/티켓/에이전트 프롬프트 모음

핵심 요약

  • 가설·실험 브리프·티켓·학습 리포트·CLAUDE.md 등 복사해서 바로 쓰는 12개 템플릿 모음입니다.
  • 팀 상황에 맞게 항목을 줄여도 가설·판정·검증 3가지는 반드시 유지합니다.
  • Discovery·GTM·Tech Lead·Dev·QA·Analytics·Risk 역할별 에이전트 프롬프트 라이브러리를 제공합니다.
  • Signal Brief는 신호를 A~D 등급으로 나누고 Go/Pivot/Kill에 필요한 최소 신호를 고정합니다.
  • Hooks 설정·권한 매트릭스·MCP allowlist는 구조 예시일 뿐이라 적용 전에 최신 공식 문서를 확인합니다.

이 챕터는 복사해서 바로 쓰는 템플릿 모음입니다. 팀 상황에 맞게 항목을 줄이거나 바꾸되, 가설/판정/검증 3가지는 유지하세요.

1) Hypothesis (6줄)

- 대상(Who):
- 상황/문제(When/Problem):
- 가치(Value):
- 행동(Behavior):
- 측정(Metric):
- 판정 기준(Decision rule):

2) Experiment Brief

# Experiment Brief

## 목표(학습 질문)

- 이번 실험으로 무엇을 줄일 것인가?

## 실험 타입

- Fake Door / WoZ / Concierge / Thin Slice / PoC

## 대상/유입

- 대상:
- 채널:
- 메시지(카피):
- 가격/반론 가설:

## 사용자 행동(한 줄)

- 사용자는 무엇을 해야 하나?

## 지표

- Primary:
- Secondary:
- GTM signal:

## 중단 기준

- (시간/표본/최저 성과)

## 수집할 정성 데이터

- 인터뷰 질문 5개:
- 반론/구매 트리거:

2-1) Signal Brief

# Signal Brief

## 검증할 제품 약속

- (타겟이 믿고 행동해야 하는 한 문장)

## 신호 등급

- A: 결제/예약금/반복 사용/공유
- B: 데모 요청/구체적 도입 일정
- C: 이메일 등록/CTA 클릭
- D: 좋아요/칭찬/AI 예측

## 이번 루프에서 필요한 최소 신호

- Go:
- Pivot:
- Kill:

3) Ticket (AC 중심)

# Ticket

## 목표

## 범위

- 포함:
- 제외:

## 수용 기준(AC)

- [ ] ...
- [ ] ...

## 제약

- PII 로그 금지
- 실패 메시지 필수

## 검증 방법

- [ ] ...

4) PR 체크리스트

- [ ] 변화가 1가지인지 확인(기능+리팩터 혼합 금지)
- [ ] 실패/빈 상태 UX 포함
- [ ] 이벤트 추가/수정 시 스펙 문서 업데이트
- [ ] 검증 방법(테스트/수동 경로) 명시

5) 에이전트 프롬프트 라이브러리

아래 6줄 템플릿으로 가설을 2개 제안해줘.
각 가설마다 실제 사용자에게 확인해야 할 증거와 AI 추론에 불과한 부분을 분리해줘.

6) Learning Report (학습 리포트)

# Learning Report (YYYY-MM-DD)

## 1) 이번 루프 가설

- 대상/문제/가치/행동/측정/판정 기준:

## 2) 실험 요약

- 실험 타입:
- 노출/표본:
- 기간:

## 3) 결과(정량)

- Primary metric:
- Secondary:
- 퍼널 병목:
- 오류/실패 사유 Top:
- GTM 신호:
- 증거 등급(A/B/C/D):

## 4) 결과(정성)

- 반복 표현(칭찬/불만):
- 가장 큰 반론:
- 제품 약속과 실제 경험의 차이:

## 5) 결론

- Go / Pivot / Kill:
- 근거:

## 6) 다음 루프

- 다음 가설:
- 다음 실험:
- 가장 먼저 줄일 리스크:

7) CLAUDE.md (컨텍스트 팩 — 프로젝트 루트에 두고, 폴더별 규칙은 필요할 때만 추가)

루트 CLAUDE.md는 프로젝트 전반에 적용하고, 특정 경로에만 필요한 규칙은 해당 디렉터리의 CLAUDE.md에 분리합니다. 개인 메모는 CLAUDE.local.md로 따로 두는 편이 깔끔합니다.

# CLAUDE.md — [프로젝트명]

## 제품 한 줄

- (무엇을, 누구에게, 어떤 가치로)

## 현재 가설(이번 루프)

- 대상/문제/가치/행동/측정/판정 기준:
- 제품 약속:
- 이번에 필요한 GTM 신호:

## 범위(이번 주)

- 포함:
- 제외:

## 사용자 여정(Thin Slice)

- Step 1:
- Step 2:
- Step 3:

## 계측(필수 이벤트)

- event_1:
- event_2:
- demo_request:
- objection_capture:

## 제약/가드레일

- PII 로그 금지
- 실패 시 사용자 메시지 필수
- PR은 작게(한 변화만)
- 외부 발송/결제/삭제는 사람 승인

## GTM 맥락

- ICP:
- 채널:
- 주요 반론:
- 가격 가설:

## 용어/정의

-

## 개발 명령어

- dev:
- lint:
- build:
- test:

## 코딩 규칙

- TypeScript strict mode
- (프레임워크 규칙)
- (네이밍 컨벤션)

8) Hooks 설정 (.claude/settings.json)

도구별 훅 schema는 바뀔 수 있으니 아래는 구조 예시로만 쓰고 실제 적용 전 공식 문서를 확인하세요.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "npm test -- --bail 2>/dev/null || echo 'TESTS FAILED'"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "./scripts/check-safe-bash.sh"
          }
        ]
      }
    ],
    "StopFailure": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -X POST $SLACK_WEBHOOK -d '{\"text\":\"Claude Code turn failed - review needed\"}' || true"
          }
        ]
      }
    ]
  }
}

9) 커스텀 스킬 예시 (.claude/skills/create-experiment/SKILL.md)

도구가 추론 강도나 실행 프로필을 지원한다면, 실험 설계처럼 판단이 필요한 작업에 더 높은 프로필을 지정하고 단순 변환에는 낮은 프로필을 씁니다.

---
name: create-experiment
description: 새 실험 브리프를 생성합니다
effort: high
---

다음 순서로 실험 브리프를 만들어주세요:

1. 가설 6줄 템플릿을 채운다
2. 실험 타입(Fake Door/WoZ/Concierge/Thin Slice)을 추천한다
3. 이벤트 스펙 8~12개를 설계한다
4. 판정 기준을 텍스트로 고정한다
5. 결과를 docs/experiments/YYYY-MM-DD-{name}.md에 저장한다

10) CI 경량 실행 (--bare 모드)

헤드리스/CI 실행 옵션은 도구 버전마다 다릅니다. 핵심은 "작은 범위, 명확한 프롬프트, 검증 결과 기록"입니다.

# GitHub Actions에서 PR 변경 범위만 리뷰
claude --bare -p "PR #${PR_NUMBER}의 변경사항을 리뷰해줘" --output-format json

# 실패 시 훅이나 CI 알림으로 사람에게 넘기기

11) Agentic 권한 매트릭스

| 행동 | 자동 허용 | 사람 승인 | 금지/보류 | 로그 |
| ---- | --------- | --------- | --------- | ---- |
| 문서 읽기/요약 | O | - | - | source path |
| 코드 수정 | 작은 범위 | shared module | prod hotfix | diff |
| 고객 메일/DM | - | O | 대량 자동 발송 | recipient, template |
| DB 변경 | - | O | prod 삭제 | query, approver |
| 배포/가격 변경 | - | O | 무승인 배포 | release id |

12) MCP 도구 allowlist 템플릿

# 읽기 도구부터 열고, 외부 발송/삭제/결제 도구는 비활성화한다
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[mcp_servers.crm]
url = "https://mcp.example.com/crm"
enabled_tools = ["search_leads", "read_account", "list_notes"]
disabled_tools = ["send_email", "delete_contact", "update_billing"]

[mcp_servers.analytics]
url = "https://mcp.example.com/analytics"
enabled_tools = ["query_events", "read_dashboard"]
disabled_tools = ["export_raw_pii", "delete_event"]

참고 자료

  • Anthropic, Manage Claude's memory — CLAUDE.md, CLAUDE.local.md, 디렉터리별 메모 적용 범위 설명.
  • Anthropic, Hooks reference — 현재 hooks JSON schema와 matcher 형식을 설명하는 공식 문서.
  • Anthropic, Subagents — 역할 분리를 템플릿과 프롬프트에 어떻게 반영할지 참고할 수 있는 공식 가이드.
  • OpenAI, Using tools in the Agents SDK — specialist-as-tool, guardrail, MCP 연결 방식 참고.

관련 문서

컨텍스트 팩

에이전트에 반복 주입하는 작은 운영 문서. CLAUDE.md/AGENTS.md 계층, 제품 약속·금지 행동 고정, 세션 간 진행 파일·compact로 맥락을 잃지 않게 만드는 방법을 정리합니다.

Go / Pivot / Kill

Agentic MVP는 완성이 아니라 결정을 배송합니다. Go/Pivot/Kill 판정 신호, Pivot 7종, A~D 증거 등급, 확증 편향·매몰 비용 함정을 피하는 학습 리포트 작성법을 다룹니다.

업데이트 내역

Agentic MVP 핸드북 변경 로그

On this page

1) Hypothesis (6줄)2) Experiment Brief2-1) Signal Brief3) Ticket (AC 중심)4) PR 체크리스트5) 에이전트 프롬프트 라이브러리6) Learning Report (학습 리포트)7) CLAUDE.md (컨텍스트 팩 — 프로젝트 루트에 두고, 폴더별 규칙은 필요할 때만 추가)8) Hooks 설정 (.claude/settings.json)9) 커스텀 스킬 예시 (.claude/skills/create-experiment/SKILL.md)10) CI 경량 실행 (--bare 모드)11) Agentic 권한 매트릭스12) MCP 도구 allowlist 템플릿참고 자료