<div align="center">
출력 구조:
🌐 English | 한국어
MY Claude Code harness
<img src="assets/banner.png" alt="Claude Code Power Pack" width="720" />
실무에서 바로 쓸 수 있는 Claude Code 최적 에이전트 하네스
Skills Agents Hooks Rules Commands TTH 올인원
35개 스킬 | 12개 에이전트 | 5개 조건부 Rules | Hooks 보장 시스템 (8개) | TTH 멀티 에이전트 (M7) | AutoDev 자율 실험
</div>목차
- 설치
- PRD Aletheia v3
- TTH 멀티 에이전트 사일로
- Musk Evaluator
- AutoDev 자율 실험 루프
- CLAUDE.md 최적화 철학
- Hooks 보장 시스템
- 스킬 (35개)
- 에이전트 (12개)
- Commands (3개)
- Rules (5개)
- Boris Cherny 팁
- Codex CLI 버전
- 참고 자료
- Changelog
🚀 설치
사전 요구사항: CLI 도구 설치
스킬과 에이전트가 자동 분석에 활용하는 CLI 도구들입니다:
brew install ast-grep difftastic gitleaks scc
| 도구 | 용도 | 사용처 |
|---|---|---|
ast-grep (sg) | AST 기반 코드 검색/패턴 매칭 | verify, review, simplify, evaluator, code-reviewer |
difftastic (difft) | AST 기반 구조적 diff (포매팅 노이즈 제거) | review, code-reviewer |
| gitleaks | 800+ 패턴 시크릿 스캔 | verify, review, evaluator, security-reviewer |
| scc | 코드 통계 + 복잡도 분석 | evaluator, code-reviewer |
Note: 도구 미설치 시 해당 검사를 건너뜁니다 (폴백 동작).
npx기반 도구 (madge,knip,jscpd)는 자동 설치됩니다.
방법 1: 원클릭 전체 설치 (권장)
curl -fsSL https://raw.githubusercontent.com/jh941213/my-claude-code-asset/main/install.sh | bash
방법 2: 플러그인 설치 (Skills만)
claude plugin marketplace add jh941213/my-claude-code-asset
claude plugin install ccpp@my-claude-code-asset
Note: 플러그인 시스템은 skills만 지원합니다. 에이전트, rules, TTH는 별도 설정이 필요합니다.
방법 3: Claude에게 직접 요청
https://github.com/jh941213/my-claude-code-asset 저장소의 agents/, rules/, commands/, CLAUDE.md를
내 ~/.claude/ 폴더에 반영해줘
설치 항목 비교
| 항목 | 플러그인 설치 | 전체 설정 |
|---|---|---|
| Skills (35개) | ✅ | ✅ |
| Agents (12개) | ❌ | ✅ |
| Rules (5개) | ❌ | ✅ |
| Commands (3개) | ❌ | ✅ |
| TTH Team Roles (7개) | ❌ | ✅ |
| Hooks (8개) | ❌ | ✅ |
| CLAUDE.md | ❌ | ✅ |
| settings.json | ❌ | ✅ |
📋 PRD Aletheia v3
<div align="center"> <img src="assets/prd-banner.png" alt="PRD Aletheia v3" width="720" /> </div>CPS 세계관 정렬 + 인문학 프레임워크 + Six Thinking Hats = prd/ 디렉토리 8개 파일 자동 생성
/prd "아이디어" 한 줄로 CPS(Context-Problem-Solution) 정렬부터 PRD + SPEC 문서 생성까지 통합 자동화합니다.
/prd "개발자를 위한 AI 코드 리뷰 SaaS"
v3 핵심 혁신
| 요소 | 설명 |
|---|---|
| CPS (Context-Problem-Solution) | PRD 위의 메타 프레임워크 — 세계관 정렬 → 문제 정의 → 솔루션 방향 설정 |
| prd/ 디렉토리 구조 | 단일 PRD.md → 8개 파일 분리 (CPS, PRD, MARKET, USERS, FEATURES, RISKS, SPEC, APPENDIX) |
| PRD + SPEC 통합 | /prd 하나로 "무엇을, 왜" + "어떻게" 까지 한 번에 생성 → 바로 /tth 연결 |
| 복잡도 게이트 | Low/Mid/High 자동 판정 → 프로세스 적응 (2~5라운드) |
| 수렴 보드 | 6차원 진행 추적 (🔴→🟡→🟢) — 용어, 구조, 깊이, 일관성, 견고성, 시장 |
| 인문학 프레임워크 | 비트겐슈타인(용어정렬) + 데카르트(방법적 회의) + 소크라테스(모순탐지) + 조하리(맹점) + 가다머(정합성) |
파이프라인
Phase 0: 복잡도 판정 + 수렴 보드 초기화
↓
Phase 0.5: CPS (Context-Problem-Solution) 세계관 정렬
↓
Phase 1 (bg) ──┐ 시장 리서치 서브에이전트 (Tavily/Exa/Gemini CLI)
Phase 2 R1 ────┘ 용어 정렬 + W6H 구조 스캔 (병렬)
↓
Phase 2 R2-5: 적응적 인터뷰 (리서치 합류)
↓
Phase 3: 기술 심층 인터뷰 → SPEC 초안 동시 생성
↓
Phase 4-6: prd-planner 서브에이전트에 위임
├── Six Hats 합성 + 차별화 전략
├── MVP 경계선 + 위험 분석
└── prd/ 디렉토리 8개 파일 작성
↓
Phase 7: 자가 검증 (8개 파일 완전성 체크)
출력 구조: prd/ 디렉토리
prd/
├── CPS.md ← Context-Problem-Solution 세계관 정렬
├── PRD.md ← 핵심 제품 요구사항
├── MARKET.md ← 시장 분석 + 경쟁사
├── USERS.md ← 사용자 페르소나 + 여정
├── FEATURES.md ← 기능 목록 + 우선순위
├── RISKS.md ← 위험 분석 + 완화 전략
├── SPEC.md ← 기술 명세 (아키텍처 + API + DB)
└── APPENDIX.md ← 수렴 보드 + 인터뷰 로그
복잡도별 적응
| 복잡도 | 예시 | Phase 1 | 인터뷰 |
|---|---|---|---|
| Low | CLI 도구, 단순 기능 | 스킵 | 2라운드 |
| Mid | 새 모듈, 라이브러리 | 서브에이전트 1개 | 3라운드 |
| High | SaaS, 플랫폼 | 서브에이전트 3개 병렬 | 5라운드 |
PRD → 구현 (원커맨드 플로우)
/prd [아이디어] → prd/ 디렉토리 (CPS + PRD + SPEC 통합 생성)
/tth → prd/ 자동 읽기 → 멀티 에이전트로 자율 구현