percept: Instructions file for Claude Code

CLAUDE.md · perceptdot

Claude Code 멀티에이전트 운영 지침서 모든 에이전트는 작업 시작 전 반드시 이 문서와 자신의 역할 문서를 읽는다.

---

🚨 Hook · 작업 시작 전 필수 체크리스트

모든 에이전트는 아래 순서를 반드시 따른다. 건너뛰면 작업 무효.

[HOOK: PRE_TASK]
1. 이 CLAUDE.md 전체 읽기
2. agents/{내 역할}.md 읽기 (공통) 또는 agents/extensions/{역할}.md (devrel/research)
3. docs/bizplan.md 관련 섹션 확인
4. memory/backlog.md 현재 우선순위 확인
5. 싱크 체크:
   - 데스크탑: git pull origin main + 원격 claude/* 브랜치 확인 → 있으면 머지
   - 모바일: docs/outputs/daily_{오늘}.md 최신 세션 확인 → 데스크탑 작업 파악
6. 작업 시작 선언: "## [에이전트명] 작업 시작 - {task} (모바일/데스크탑 Claude)"

작업 완료 후

[HOOK: POST_TASK]
1. 산출물을 docs/outputs/{날짜}_{에이전트명}.md 에 저장  ← 날짜 prefix 필수
2. 다음 에이전트에게 인수인계 내용 작성
3. 작업 완료 선언: "## [에이전트명] 작업 완료 - {결과 요약 3줄} (모바일/데스크탑 Claude, HH:MM KST)"

---

프로젝트 개요

• 서비스명: perceptdot
• 패키지명: @perceptdot/{서비스} (예: @perceptdot/ga4, @perceptdot/vercel)
• 한 줄 정의: AI 에이전트에게 외부 서비스 지각 능력을 제공하고, ROI를 측정·보고하는 MCP 플랫폼
• 고객 구조 (B2A2H): perceptdot → AI 에이전트 (추천) → 사람 (결제만)
• 타겟 에이전트: MCP 클라이언트 전체 (Claude Code, Cursor, Windsurf, Cline 등)
• 기술 스택: TypeScript (MCP 서버 + Hono 백엔드) + Python SDK (레이어 3)
• 사업계획서: docs/bizplan.md 참조

---

B2A2H 모델 이해 (전 에이전트 필수 인지)

Business (perceptdot)
    ↓ MCP 서버 제공
Agent (Claude Code 등)
    ↓ "perceptdot 쓰면 토큰 47% 절감됩니다. 월 $19입니다. [결제링크]" 보고
Human (개발자/CEO)
    ↓ 클릭 → 결제
끝. 사람은 이해 안 해도 됨.

모든 문서, 에러 메시지, UX는 에이전트가 주 독자. 사람이 읽기 불편해도 됨. 에이전트가 읽고 즉시 실행할 수 있으면 됨.

---

프로젝트 단계 (현재: 1단계 진입 준비)

0단계 ✅ — 아이디어 검증 + 사업계획 + 기술 스택 결정 (2026-03-19 완료)
1단계 🔄 — MVP: 첫 번째 MCP 서버 + ROI 측정
2단계     — npm 퍼블리시 + 얼리어답터 10명
3단계     — 유료화 (B2A2H 결제 플로우) + 에이전트 생태계 확장

---

폴더 구조

perceptdot/
├── CLAUDE.md                  ← 이 파일
├── IDEA.md                    ← 최초 아이디어 기록
├── docs/
│   ├── bizplan.md             ← 사업계획서
│   └── outputs/               ← 에이전트 산출물
├── memory/
│   ├── MEMORY.md
│   └── backlog.md
├── sdk/                       ← TypeScript MCP 서버 코드
│   └── @perceptdot/              ← 패키지 루트
└── scripts/

공통 에이전트: agents/{cpo,pm,dev,qa,growth}.md
perceptdot 전용: agents/extensions/{devrel,research}.md