Claude Code 플러그인 마켓플레이스
HunminKim의 개인 Claude Code 플러그인 저장소.
새 환경에서 사용하기
git clone https://github.com/HunminKim/claude.git ~/claude-config
cd ~/claude-config
bash install.sh
install.sh 가 하는 일:
hunminkim 마켓플레이스 등록- 공식 플러그인 설치 (code-review, code-simplifier, skill-creator, hookify)
- 개인 플러그인 설치 (project-init, harness-check, prompt-log)
설치 후 Claude Code 재시작 또는 /reload-plugins
플러그인 목록
project-init
프로젝트 시작 시 개발 환경을 한 번에 초기화한다.
호출: /project-init 또는 "프로젝트 초기화해줘"
생성되는 파일
| 파일 | 시점 | 작성 주체 |
|---|
CLAUDE.md | 초기화 시 | /project-init |
docs/development_plan.md | 초기화 시 | 사용자 작성 |
docs/context_note.md | 초기화 시 | 사용자 작성 |
docs/checklist.md | 초기화 시 → 소단위마다 업데이트 | verifier (자동) |
docs/technical_doc.md | 소단위 완료마다 누적 | verifier (자동) |
docs/completion_report.md | 소단위 완료마다 누적 | verifier (자동) |
docs/deployment_guide.md | 개발 중 누적 → 완료 후 정리 | verifier + 사용자 |
docs/retrospective.md | 완료 사인 후 | Claude |
docs/debug/*.md | 버그 발생 시 | Claude |
.claude/agents/verifier.md | 초기화 시 | /project-init |
개발 워크플로우 (verifier)
사용자: 기능 구현 요청
↓
Claude: 소단위로 구현
↓
Claude: @verifier 호출 (CLAUDE.md에 명시, 예외 없음)
↓
verifier: 검증 후 docs/.verifier_result.json 저장
↓
PostToolUse 훅 자동 감지 (컨텍스트 무관)
↓
checklist / completion_report / technical_doc 자동 업데이트
↓
.verifier_result.json 자동 삭제
기능 그룹이 완전히 끝나면 /compact 실행 (소단위마다 하지 않음)
plan-gate (자동 강제 + 체크포인트 자동 관리)
복잡한 코드 수정을 자동 감지해 사용자 계획 승인을 강제하고, 작업 시작 시점에
체크포인트를 자동으로 만들어 롤백 가능하게 한다. 사용자는 메시지 토큰만으로
모든 단계를 제어한다 (코드/파일시스템 직접 접근 불필요).
트리거 조건 (PreToolUse 훅, OR):
Edit/Write/MultiEdit 호출 ≥ 3회- 영향 파일 ≥ 3개
- 단일
MultiEdit 항목 ≥ 5개
워크플로우:
Claude: Edit 시도 (1·2·3차)
↓ 3차에서 차단 (트리거 임계값 도달)
PreToolUse 훅: git stash + git tag (체크포인트 생성)
↓
Claude: tasks/todo.md 작성
↓ PostToolUse 훅(plan_summary_request): 계획 내용 Claude 컨텍스트 주입
Claude: 계획 요약 → 사용자에게 /approve-plan 요청
↓
사용자: /approve-plan
↓ todo.md SHA-256 검증
plan_approval 훅 + 슬래시 커맨드: gate.state = "approved"
↓
Claude: 구현 진행 (max(initial+2, 5) 초과 시 scope creep 차단)
↓
@verifier 호출 → docs/.verifier_result.json
↓
update_docs 훅: gate.state = "verified", verifier_status 기록
↓
사용자 결정:
✅ → /done (체크포인트 정리)
/rollback (체크포인트로 복원, dirty stash 보존)
❌ → /retry (같은 체크포인트에서 재시도)
/rollback (체크포인트로 복원)
계획 재작성 필요 → /replan (카운터 리셋, 체크포인트 유지)
상태 파일: .claude/state/plan_gate.json
체크포인트: git tag .claude/gate/<id>/clean + [plan-gate] <id> stash entry
GC: SessionEnd 훅이 30일 이상된 tag·stash·gate 기록 정리
가드: .claude/agents/verifier.md 가 없는 (project-init 미적용) 프로젝트에선 plan-gate가 자동 비활성화된다.
prompt-log
제거 가능한 사용자 prompt + 도구 호출 통계 수집 플러그인. 동의한 프로젝트에서만 작동한다.
목적
- plan-gate 휴리스틱 튜닝 (V2)
- 사용자 워크플로우 패턴 분석
- 다른 플러그인이 read-only로 활용
동의 메커니즘 (default deny)
다음 두 조건이 모두 만족해야 수집:
- 글로벌 whitelist 등록 —
~/.claude/prompt-log/projects-allowed.json
- 프로젝트별 marker —
<project>/.claude/prompt-log-consent
/project-init 실행 시 4단계에서 동의 요청이 자동 표시되며, y 응답 시 둘 다 자동 생성. n 또는 미실행이면 수집 안 함.
저장
~/.claude/prompt-log/
├── prompts-YYYY-MM.jsonl # 월별 분할 (한 줄 = 한 prompt record)
└── projects-allowed.json # 동의 whitelist
record 스키마: prompt(sanitized) + tools 카운트(edit/write/bash/task) + 영향 파일 + plan-gate 메타(read-only) + outcome.
Sanitize: API key, JWT, AWS, 이메일 등 정규식 마스킹 ([REDACTED:type] 치환).
1줄 제거
bash plugins/prompt-log/uninstall.sh
claude plugins uninstall prompt-log
식별 마커 컨벤션: 추가된 모든 코드는 [prompt-log] 식별 마커로 검색 가능 (grep -rn '\[prompt-log\]' ~/.claude-config/). 외부 통합 부분은 <!-- >>> [prompt-log] integration begin --> ~ <!-- <<< [prompt-log] integration end --> 마커로 감싸져 있어 안전하게 제거 가능.
자세한 내용: plugins/prompt-log/README.md. 미뤄둔 항목: plugins/prompt-log/V2_TODO.md.
플러그인 업데이트
claude plugins update project-init@hunminkim
