Merge pull request #4 from claude-code-expert/develop

Develop

Author: villainscode

CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.2] - 2026-04-11
+
+### Added
+
+- **Automated test suite**: `tests/test-router.sh` (67 cases), `tests/test-files.sh` (78 cases), `tests/run-all.sh` unified runner
+- **Pre-commit hook**: `install.sh --dev` registers git pre-commit that runs all tests on commit
+- **Router enforcement**: `additionalContext` message changed to "MUST delegate" to ensure subagent execution
+
+### Changed
+
+- **CI pipeline**: Replaced manual frontmatter checks with `test-router.sh` + `test-files.sh`
+- **VERSION**: Bumped to 1.3.2
+
 ## [1.3.1] - 2026-04-11
 
 ### Changed

README.en.md

@@ -75,10 +75,11 @@ Subagents are invoked via Claude Code's built-in **Agent tool** — not by runni
 
 ### Version
 
-**v1.3.1** (current) — [Full changelog](CHANGELOG.md)
+**v1.3.2** (current) — [Full changelog](CHANGELOG.md)
 
 | Version | Key Changes |
 |---------|-------------|
+| v1.3.2 | 145 automated tests, pre-commit hook, router delegation enforcement, `run-all.sh` |
 | v1.3.1 | README restructure (KO/EN split), CI shellcheck fix, hook mechanism docs |
 | v1.3.0 | Squad Router hook (80 keywords, 3-phase matching, context injection) |
 | v1.2.1 | Cross-platform notifications (macOS/Linux/WSL), subagent verification |
@@ -230,13 +231,13 @@ Claude Code's `UserPromptSubmit` hook fires every time the user submits a prompt
 │    "security" detected → AGENT="squad-audit"                    │
 │                                                                 │
 │ 4. Outputs JSON to stdout (context injection)                   │
-│    {"hookSpecificOutput": {                                      │
-│      "hookEventName": "UserPromptSubmit",                        │
-│      "additionalContext": "[Squad Router] Use the squad-audit..." │
-│    }}                                                            │
+│    {"hookSpecificOutput": {                                     │
+│      "hookEventName": "UserPromptSubmit",                       │
+│      "additionalContext": "[Squad Router] Use the squad-audit.."│
+│    }}                                                           │
 │                                                                 │
 │ 5. Claude sees injected context and delegates to subagent       │
-│    → Agent(subagent_type="squad-audit", prompt="...")            │
+│    → Agent(subagent_type="squad-audit", prompt="...")           │
 └─────────────────────────────────────────────────────────────────┘
 ```
 

README.md

@@ -75,10 +75,11 @@ bash install.sh
 
 ### 버전
 
-**v1.3.1** (현재) — [전체 변경 이력](CHANGELOG.md)
+**v1.3.2** (현재) — [전체 변경 이력](CHANGELOG.md)
 
 | 버전 | 주요 변경 |
 |------|----------|
+| v1.3.2 | 자동 테스트 145건, pre-commit hook, 라우터 위임 강제, `run-all.sh` |
 | v1.3.1 | README 구조 개편 (KO/EN 분리), CI shellcheck 수정, 훅 메커니즘 문서화 |
 | v1.3.0 | Squad Router 훅 추가 (80 키워드, 3단계 매칭, context injection) |
 | v1.2.1 | 크로스 플랫폼 알림 (macOS/Linux/WSL), 서브에이전트 검증 완료 |
@@ -219,25 +220,25 @@ squad-plan → [구현] → squad-review → squad-qa → squad-gitops
 Claude Code의 `UserPromptSubmit` 훅은 사용자가 프롬프트를 제출할 때마다 실행됩니다. Squad Router는 이 메커니즘을 활용합니다:
 
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│ 1. 사용자가 프롬프트 입력                                          │
-│    "이 코드 보안 검사해줘"                                         │
-│                                                                 │
-│ 2. Claude Code가 훅 실행 (프롬프트가 Claude에 전달되기 전)           │
-│    stdin → {"prompt": "이 코드 보안 검사해줘"}                     │
-│                                                                 │
-│ 3. squad-router.sh가 키워드 매칭                                  │
-│    "보안" 감지 → AGENT="squad-audit"                              │
-│                                                                 │
-│ 4. stdout으로 JSON 출력 (context injection)                       │
+┌──────────────────────────────────────────────────────────────────┐
+│ 1. 사용자가 프롬프트 입력                                              │
+│    "이 코드 보안 검사해줘"                                            │
+│                                                                  │
+│ 2. Claude Code가 훅 실행 (프롬프트가 Claude에 전달되기 전)                │
+│    stdin → {"prompt": "이 코드 보안 검사해줘"}                        │
+│                                                                  │ 
+│ 3. squad-router.sh가 키워드 매칭                                    │
+│    "보안" 감지 → AGENT="squad-audit"                               │
+│                                                                  │ 
+│ 4. stdout으로 JSON 출력 (context injection)                        │
 │    {"hookSpecificOutput": {                                      │
 │      "hookEventName": "UserPromptSubmit",                        │
-│      "additionalContext": "[Squad Router] Use the squad-audit..." │
+│      "additionalContext": "[Squad Router] Use the squad-audit..."│
 │    }}                                                            │
-│                                                                 │
-│ 5. Claude가 주입된 컨텍스트를 보고 서브에이전트에 위임                  │
-│    → Agent(subagent_type="squad-audit", prompt="...")             │
-└─────────────────────────────────────────────────────────────────┘
+│                                                                  │
+│ 5. Claude가 주입된 컨텍스트를 보고 서브에이전트에 위임                      │
+│    → Agent(subagent_type="squad-audit", prompt="...")            │
+└──────────────────────────────────────────────────────────────────┘
 ```
 
 핵심은 `hookSpecificOutput.additionalContext`입니다. 이 필드로 출력한 텍스트는 Claude가 프롬프트를 처리할 때 system-reminder로 주입되어, Claude가 자연스럽게 해당 서브에이전트를 호출하도록 유도합니다. 프롬프트 자체는 변경되지 않습니다.