템플릿 & 프롬프트
Agentic MVP를 바로 실행하게 해주는 제품·GTM 문서/티켓/에이전트 프롬프트 모음
이 챕터는 복사해서 바로 쓰는 템플릿 모음입니다. 팀 상황에 맞게 항목을 줄이거나 바꾸되, 가설/판정/검증 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 추론에 불과한 부분을 분리해줘.ICP 1개를 기준으로 랜딩 헤드라인 5안, 콜드메일 3안, 가격 반론 FAQ를 만들어줘.
각 문안이 어떤 가설을 검증하는지도 표로 써줘.이 MVP를 60분 단위 티켓으로 쪼개고,
리스크가 큰 순서대로 실행 계획(작은 PR)을 만들어줘.아래 AC를 만족하도록 구현해줘.
- (AC 목록)
구현 후에는 로컬 검증 방법과 변경 파일 목록을 요약해줘.정상 플로우 5개 + 실패 플로우 10개 테스트 시나리오를 만들어줘.
실패 플로우는 네트워크/권한/입력 오류/타임아웃/데이터 오류를 포함해줘.이벤트 8~12개와 GTM 신호 이벤트를 설계해줘.
각 이벤트의 정의/발생 위치/필수 속성(variant, channel, objection_type 포함)을 표로 만들어줘.이 MVP의 에이전트 도구 권한을 읽기/쓰기/외부전송/삭제로 분류해줘.
사람 승인이 필요한 지점, 감사 로그, 롤백 경로를 표로 정리해줘.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 연결 방식 참고.