@choblue/claude-code-toolkit 1.1.2 → 1.1.6

package/README.md

@@ -42,15 +42,24 @@
 │   ├── TypeScript/
 │   │   └── SKILL.md             ← TypeScript 고급 패턴
 │   ├── TypeORM/
-│   │   └── SKILL.md             ← TypeORM Entity, Repository
+│   │   ├── SKILL.md             ← TypeORM Entity, Repository
+│   │   └── references/          ← 고급 쿼리, 마이그레이션, 트랜잭션
+│   ├── DDD/
+│   │   ├── SKILL.md             ← DDD 전술적 패턴
+│   │   └── references/          ← Entity/VO, Aggregate, Domain Event 심화
 │   ├── TDD/
 │   │   ├── SKILL.md             ← TDD 핵심 원칙
 │   │   ├── frontend.md          ← React 테스트 규칙
 │   │   └── 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 +140,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 (프론트엔드)
@@ -275,6 +279,7 @@ copy_be() {
 
   # BE 스킬 (디렉토리 전체)
   copy_dir "skills/TypeORM"
+  copy_dir "skills/DDD"
 
   # BE 개별 스킬 파일
   copy_file "skills/Coding/backend.md"
@@ -330,6 +335,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 +343,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.2",
+  "version": "1.1.6",
   "description": "Claude Code 서브에이전트 위임 툴킷 - npx로 바로 설치",
   "bin": {
     "claude-code-toolkit": "bin/cli.js"