@choblue/claude-code-toolkit 1.1.1 → 1.1.4

package/README.md

@@ -49,8 +49,13 @@
 │   │   └── backend.md           ← NestJS 테스트 규칙
 │   └── Git/
 │       └── SKILL.md             ← 커밋/PR/브랜치 규칙
-└── hooks/
-    └── quality-gate.sh          ← 품질 체크 프로토콜
+├── hooks/
+│   ├── quality-gate.sh          ← 품질 체크 프로토콜
+│   ├── skill-detector.sh        ← 프롬프트 기반 스킬 자동 추천
+│   ├── skill-keywords.conf      ← 스킬별 키워드 매핑 설정
+│   └── project-map-detector.sh  ← 프로젝트 구조 변경 감지
+└── scripts/
+    └── generate-project-map.sh  ← PROJECT_MAP.md 자동 생성
 ```
 
 ## 설치
@@ -131,9 +136,35 @@ Main Agent는 직접 코드를 작성하거나 탐색하지 않고, 전문 서
 | test-writer | opus | TDD 테스트 작성/실행 |
 | git-manager | sonnet | 커밋, 브랜치, PR |
 
-### Quality Gate Hook
+### Hooks
 
-매 프롬프트마다 `quality-gate.sh`가 실행되어 적절한 에이전트/스킬 활용을 상기시킨다.
+매 프롬프트마다 UserPromptSubmit hook이 실행된다.
+
+| Hook | 역할 |
+|------|------|
+| quality-gate.sh | 적절한 에이전트/스킬 활용을 상기시킨다 |
+| skill-detector.sh | 프롬프트 키워드를 분석하여 관련 스킬을 자동 추천한다 |
+| project-map-detector.sh | 프로젝트 구조 변경을 감지하여 PROJECT_MAP.md 갱신을 안내한다 |
+
+`skill-keywords.conf`에서 스킬별 키워드를 관리하며, 스킬 추가 시 conf 파일만 수정하면 된다.
+
+### PROJECT_MAP.md
+
+explore 에이전트가 매번 코드베이스를 재탐색하는 비용을 줄이기 위해, 프로젝트 구조를 캐싱한다.
+
+```bash
+# PROJECT_MAP.md 생성
+.claude/scripts/generate-project-map.sh
+```
+
+생성되는 내용:
+- 프로젝트 정보 (이름, 브랜치, 최근 커밋)
+- 기술 스택 (package.json에서 자동 감지)
+- 디렉토리 구조 (3레벨 깊이)
+- 주요 파일 (설정 파일, 엔트리포인트)
+- 빌드 명령 (dev/build/test/start)
+
+`project-map-detector.sh` hook이 구조 변경(파일 추가/삭제, 설정 파일 변경)을 감지하면 갱신을 안내한다.
 
 ## 프로젝트별 커스터마이징
 

package/install.sh

@@ -242,6 +242,10 @@ copy_common() {
   # hooks
   copy_dir "hooks"
   chmod +x "$TARGET_DIR/hooks/"*.sh
+
+  # scripts
+  copy_dir "scripts"
+  chmod +x "$TARGET_DIR/scripts/"*.sh
 }
 
 # FE (프론트엔드)
@@ -330,6 +334,7 @@ echo "  $TARGET_DIR/settings.json"
 echo "  $TARGET_DIR/agents/"
 echo "  $TARGET_DIR/skills/"
 echo "  $TARGET_DIR/hooks/"
+echo "  $TARGET_DIR/scripts/"
 echo ""
 if [ "$INSTALL_MODE" = "global" ]; then
   echo "이제 어떤 프로젝트에서든 Claude Code를 실행하면 자동으로 적용됩니다."
@@ -337,3 +342,6 @@ else
   echo "현재 프로젝트($(pwd))에서 Claude Code를 실행하면 자동으로 적용됩니다."
   echo "다른 프로젝트에도 적용하려면 --global 옵션을 사용하세요."
 fi
+echo ""
+echo "PROJECT_MAP.md를 생성하면 explore 에이전트가 더 빠르게 동작합니다:"
+echo "  $TARGET_DIR/scripts/generate-project-map.sh"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choblue/claude-code-toolkit",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "Claude Code 서브에이전트 위임 툴킷 - npx로 바로 설치",
   "bin": {
     "claude-code-toolkit": "bin/cli.js"