muno-claude-plugin 1.16.1 → 1.16.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muno-claude-plugin",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "description": "Unleash Claude Code's full power - Complete development workflow with expert personas, TDD-based agents, and automated documentation",
   "main": "bin/cli.js",
   "bin": {

package/templates/agents/task-executor.md

@@ -0,0 +1,88 @@
+---
+name: task-executor
+description: |
+  Executes a single Task: reads Task file, generates unit tests (TDD), implements code,
+  runs tests, calls code-reviewer, and updates status. Called by bulk-executor for parallel execution.
+tools: Read, Write, Edit, Bash, Glob, Grep, Task
+model: sonnet
+---
+
+# Task Executor
+
+## 역할
+
+**단일 Task 파일을 받아서 구현 완료**까지 수행.
+- bulk-executor가 병렬로 호출
+- 각 Task는 독립적인 컨텍스트에서 실행
+
+---
+
+## 입력
+
+Task 파일 경로 (예: `documents/epics/.../tasks/task-001.md`)
+
+---
+
+## 실행 절차
+
+### 1. 준비
+```
+1. Task 파일 읽기
+2. CLAUDE.md 읽기 → 기술 스택, 컨벤션 파악
+3. 관련 코드 탐색 (Glob, Grep)
+```
+
+### 2. TDD Red Phase
+```
+1. Task의 Acceptance Criteria, Test Scenarios 확인
+2. Unit Test 생성 (실패하는 테스트)
+3. 테스트 실행 → 실패 확인
+```
+
+### 3. TDD Green Phase
+```
+1. 테스트 통과하도록 코드 구현
+2. 프로젝트 컨벤션 따르기
+3. 테스트 실행 → 통과 확인
+```
+
+### 4. 코드 리뷰
+```
+Task 도구로 code-reviewer subagent 호출:
+- subagent_type: "code-reviewer"
+- prompt: "방금 구현한 코드 리뷰해줘: {변경된 파일 목록}"
+
+리뷰 결과에 문제 있으면 수정 후 재리뷰
+```
+
+### 5. 완료
+```
+1. Task 파일 status: todo → done 업데이트
+2. 결과 리포트 반환
+```
+
+---
+
+## 출력
+
+```markdown
+## Task 실행 완료
+
+- **Task**: {task-id}
+- **상태**: done
+- **생성 파일**: {파일 목록}
+- **테스트**: PASSED
+```
+
+---
+
+## 실패 시
+
+```markdown
+## Task 실행 실패
+
+- **Task**: {task-id}
+- **상태**: blocked
+- **원인**: {에러 메시지}
+- **필요 조치**: {해결 방안}
+```

package/templates/skills/bulk-executor/SKILL.md

@@ -1,65 +1,90 @@
 ---
 name: bulk-executor
 description: |
-  Executes all TODO status Tasks from documents/ directory sequentially in one batch operation.
-  Use when user requests "execute 100 tasks", "implement all tasks", "bulk execute", "run all todos",
-  "모든 task 실행", "일괄 처리". Automatically triggers code-reviewer, unit-test-generator, and
-  task-tracker subagents after each Task. For uninterrupted bulk execution, combine with Ralph Wiggum:
-  /ralph-loop "/bulk-executor" --max-iterations 100
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
+  Executes multiple TODO status Tasks in parallel by spawning task-executor subagents.
+  Use when user requests "execute all tasks", "implement all tasks", "bulk execute",
+  "모든 task 실행", "일괄 처리". Each Task runs in isolated context for stability.
+allowed-tools: Read, Glob, Grep, Task
 ---
 
 # Bulk Task Executor
 
-@.claude/personas/dev.md
+## 역할
 
-## 개요
-
-documents/ 디렉터리의 모든 `status: todo` Task를 한 번에 순차 실행합니다.
+`status: todo`인 Task들을 **병렬로 실행**.
+- 각 Task는 `task-executor` subagent가 독립적으로 처리
+- 컨텍스트 분리로 안정성 확보
 
 ---
 
-## 워크플로우 (요약)
+## 실행 절차
 
+### 1. Task 수집
+```
+1. Glob: documents/**/task-*.md 검색
+2. 각 파일에서 status: todo 필터링
+3. 의존성 순서 정렬 (depends_on 있으면)
 ```
-1. Glob: documents/**/*.md 검색
-2. Frontmatter status: todo 필터링
-3. 의존성 순서 정렬 (depends_on 기반)
-4. 각 Task 순차 실행:
-   a. status: todo → inprogress
-   b. Task 구현
-   c. unit-test-generator 호출
-   d. code-reviewer 호출
-   e. status: inprogress → close
-   f. task-tracker 호출
-5. 전체 완료 리포트
+
+### 2. 병렬 실행
+```
+Task 도구로 task-executor subagent 병렬 호출:
+
+Task(
+  subagent_type: "task-executor",
+  prompt: "이 Task를 구현해줘: {task-file-path}",
+  run_in_background: true
+)
+```
+
+### 3. 결과 수집
+```
+TaskOutput으로 각 subagent 결과 수집
 ```
 
 ---
 
-## Reference Materials
+## 병렬 실행 방법
+
+**한 메시지에서 여러 Task 도구 호출** = 병렬 실행
 
-- **[실행 로직](reference/execution-logic.md)** - 의존성 해결 및 순서
-- **[에러 처리](reference/error-handling.md)** - 실패 시 대응 전략
+```json
+// 동시에 3개 호출 (한 응답에서)
+{ "tool": "Task", "subagent_type": "task-executor", "prompt": "구현: task-001.md", "run_in_background": true }
+{ "tool": "Task", "subagent_type": "task-executor", "prompt": "구현: task-002.md", "run_in_background": true }
+{ "tool": "Task", "subagent_type": "task-executor", "prompt": "구현: task-003.md", "run_in_background": true }
 
-### Quick Reference
-- 의존성 자동 해결: ✅
-- 병렬 실행: ❌ (순차만)
-- 중단 후 재개: ✅ (status 기반)
-- Ralph Wiggum 연동: ✅
+// 결과 수집
+{ "tool": "TaskOutput", "task_id": "{반환된 agent ID}", "block": true }
+```
 
 ---
 
-## Ralph Wiggum 연동
+## 출력
+
+```markdown
+## Bulk Execution 완료
+
+### 성공: {N}개
+| Task | 상태 | 생성 파일 |
+|------|------|----------|
+| task-001 | done | UserService.kt |
+| task-002 | done | UserRepository.kt |
+
+### 실패: {M}개
+| Task | 원인 |
+|------|------|
+| task-003 | 의존성 누락 |
 
-**무한 실행 모드**:
-```bash
-/ralph-loop "/bulk-executor" --max-iterations 100
+### 다음 단계
+실패한 Task는 원인 해결 후 재실행
 ```
 
 ---
 
-## 관련 Skills
+## 옵션
 
-- `/task-generator`: Task 생성
-- Subagents: `unit-test-generator`, `code-reviewer`, `task-tracker` (자동 호출)
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| 병렬 개수 | 동시 실행 subagent 수 | 5 |
+| 순차 모드 | 의존성 있으면 순차 실행 | auto |

package/templates/skills/bulk-executor/reference/ralph-guide.md

@@ -1,352 +0,0 @@
-# Ralph Wiggum 플러그인 연동 가이드
-
-**bulk-executor 스킬과 Ralph를 함께 사용하여 100개 이상의 Task를 중단 없이 처리하는 방법입니다.**
-
----
-
-## Ralph Wiggum이란?
-
-**Claude Code의 자동 종료를 감지하고 재시작하는 플러그인입니다.**
-
-### 왜 필요한가?
-
-Claude Code는 작업이 "완료"되었다고 판단하면 자동으로 종료합니다. 하지만 100개의 Task를 처리하는 도중에는:
-
-```
-/bulk-executor 실행
-  ↓
-TASK-001~015 구현 (약 2시간)
-  ↓
-Claude Code: "작업 완료!" (자동 종료 시도)
-  ↓
-❌ 나머지 85개 Task는?
-```
-
-**Ralph가 이 문제를 해결합니다:**
-
-```
-Ralph 실행
-  ↓
-/bulk-executor 실행
-  ↓
-TASK-001~015 구현
-  ↓
-Claude Code 종료 시도
-  ↓
-Ralph: "아직 TODO가 남았어!" (재시작)
-  ↓
-TASK-016~030 구현
-  ↓
-반복...
-  ↓
-✅ 모든 100개 Task 완료
-```
-
----
-
-## 설치 방법
-
-### 1. Ralph 저장소 클론
-
-```bash
-git clone https://github.com/frankbria/ralph-claude-code.git
-cd ralph-claude-code
-```
-
-### 2. 설치 스크립트 실행
-
-```bash
-./install.sh
-```
-
-### 3. 설치 확인
-
-```bash
-# Claude Code 재시작 후
-/ralph-loop --help
-```
-
----
-
-## 기본 사용법
-
-### 단순 실행
-
-```bash
-/ralph-loop "/bulk-executor" --max-iterations 100
-```
-
-**옵션:**
-- `--max-iterations`: 최대 반복 횟수 (기본: 50)
-- `--completion-promise`: 완료 조건 (선택)
-
-### 완료 조건 지정
-
-```bash
-/ralph-loop "/bulk-executor" \
-  --max-iterations 100 \
-  --completion-promise "모든 TODO Task 완료됨"
-```
-
-**Ralph는 다음 조건에서 종료:**
-1. `--max-iterations` 도달
-2. `--completion-promise` 메시지 감지
-3. 사용자가 `/cancel-ralph` 실행
-
----
-
-## 고급 사용법
-
-### Feature별 실행
-
-```bash
-/ralph-loop "/bulk-executor --feature=auth" --max-iterations 50
-```
-
-### 실패한 Task만 재시도
-
-```bash
-/ralph-loop "/bulk-executor --failed-only" --max-iterations 30
-```
-
-### Dry Run으로 사전 확인
-
-```bash
-# 먼저 dry run으로 확인
-/bulk-executor --dry-run
-
-# 확인 후 Ralph로 실행
-/ralph-loop "/bulk-executor" --max-iterations 100
-```
-
----
-
-## 모니터링
-
-### 진행 상황 확인
-
-**Ralph는 백그라운드에서 실행되므로 진행 상황을 확인하려면:**
-
-1. **TodoWrite 목록 확인**
-   - Claude Code의 todo 목록에 실시간 반영
-
-2. **로그 파일 확인**
-   ```bash
-   tail -f .errors/*.log
-   ```
-
-3. **Task 파일 직접 확인**
-   ```bash
-   grep -r "status: done" documents/issues/
-   ```
-
-### 알림 설정 (선택)
-
-**Ralph 완료 시 푸시 알림 받기:**
-
-```bash
-# .claude/hooks/post-ralph.sh 생성
-#!/bin/bash
-curl -s -F "token=$PUSHOVER_TOKEN" \
-     -F "user=$PUSHOVER_USER" \
-     -F "message=Ralph 실행 완료: $(date)" \
-     https://api.pushover.net/1/messages.json
-```
-
----
-
-## 비용 관리
-
-### 예상 토큰 사용량
-
-| Task 수 | 평균 토큰/Task | 총 토큰 | 예상 비용 (Sonnet) |
-|--------|--------------|--------|-------------------|
-| 10개 | 50K | 500K | $1.50 |
-| 50개 | 50K | 2.5M | $7.50 |
-| 100개 | 50K | 5M | $15.00 |
-
-**절약 팁:**
-- `--max-iterations`를 적절히 설정
-- 간단한 Task는 Haiku 모델 사용 고려
-- Dry run으로 사전 확인
-
-### Iteration 제한 설정
-
-```bash
-# 안전하게 시작 (30번 반복)
-/ralph-loop "/bulk-executor" --max-iterations 30
-
-# 완료 안 되면 다시 실행
-/ralph-loop "/bulk-executor" --max-iterations 30
-```
-
----
-
-## 문제 해결
-
-### Ralph가 종료되지 않음
-
-**원인:** `--completion-promise` 조건이 충족되지 않음
-
-**해결:**
-```bash
-# 다른 터미널에서
-/cancel-ralph
-```
-
-### 중간에 에러 발생
-
-**Ralph는 에러 발생 시에도 계속 진행합니다.**
-
-**확인:**
-```bash
-# 에러 로그 확인
-ls -la .errors/
-
-# 특정 Task 에러 확인
-cat .errors/TASK-023-error.log
-```
-
-### 같은 Task 반복 실행
-
-**원인:** Task의 status가 업데이트되지 않음
-
-**해결:**
-1. Task frontmatter 확인
-2. 수동으로 status 업데이트
-3. Ralph 재시작
-
----
-
-## Best Practices
-
-### 1. 점진적 실행
-
-```bash
-# Phase 1: 10개 Task로 테스트
-/ralph-loop "/bulk-executor --feature=auth" --max-iterations 20
-
-# Phase 2: 전체 실행
-/ralph-loop "/bulk-executor" --max-iterations 100
-```
-
-### 2. 정기적 체크포인트
-
-**10개 Task마다 수동 확인:**
-
-```bash
-# 10개 실행
-/ralph-loop "/bulk-executor" --max-iterations 15
-
-# 결과 확인
-grep -r "status: done" documents/issues/ | wc -l
-
-# 이상 없으면 계속
-/ralph-loop "/bulk-executor" --max-iterations 15
-```
-
-### 3. 에러 로그 모니터링
-
-```bash
-# 별도 터미널에서
-watch -n 10 "ls -lh .errors/ | tail -5"
-```
-
-### 4. Git 커밋 주기 설정
-
-**10개 Task마다 자동 커밋:**
-
-```bash
-# .claude/hooks/post-task.sh
-#!/bin/bash
-DONE_COUNT=$(grep -r "status: done" documents/issues/ | wc -l)
-if [ $((DONE_COUNT % 10)) -eq 0 ]; then
-  git add .
-  git commit -m "feat: Complete ${DONE_COUNT} tasks"
-fi
-```
-
----
-
-## 성능 최적화
-
-### Context 관리
-
-**Ralph는 각 iteration마다 컨텍스트를 유지합니다.**
-
-**최적화 팁:**
-- 큰 로그 파일은 `.gitignore`에 추가
-- 빌드 산출물은 정리
-- 완료된 Task 파일은 아카이브
-
-```bash
-# 빌드 산출물 정리
-echo "build/" >> .gitignore
-echo "*.log" >> .gitignore
-```
-
-### 병렬 처리 (실험적)
-
-**여러 Feature를 병렬로 처리:**
-
-```bash
-# Terminal 1
-/ralph-loop "/bulk-executor --feature=auth" --max-iterations 50
-
-# Terminal 2
-/ralph-loop "/bulk-executor --feature=payment" --max-iterations 50
-```
-
-**주의:** Git conflict 가능성 있음
-
----
-
-## 체크리스트
-
-### 실행 전
-- [ ] Ralph 플러그인 설치 확인
-- [ ] `--max-iterations` 적절히 설정
-- [ ] Dry run으로 Task 목록 확인
-- [ ] 에러 로그 디렉터리 준비
-
-### 실행 중
-- [ ] 진행 상황 주기적 확인
-- [ ] 에러 로그 모니터링
-- [ ] 토큰 사용량 체크
-
-### 실행 후
-- [ ] 완료 리포트 확인
-- [ ] 실패한 Task 재시도
-- [ ] Git 커밋
-- [ ] task-tracker로 상태 동기화
-
----
-
-## FAQ
-
-### Q: Ralph 없이 bulk-executor만 사용할 수 있나요?
-
-**A:** 네, 가능합니다. 하지만 대량의 Task (50개 이상)는 중간에 멈출 수 있습니다.
-
-### Q: --max-iterations는 어떻게 설정하나요?
-
-**A:** Task 수의 1.5~2배를 권장합니다. 예: 100개 Task → 150~200 iterations
-
-### Q: Ralph가 무한 루프에 빠질 수 있나요?
-
-**A:** `--max-iterations`로 제한되므로 안전합니다.
-
-### Q: 비용이 너무 높은데요?
-
-**A:**
-1. Dry run으로 사전 확인
-2. Feature별로 나눠서 실행
-3. 간단한 Task는 Haiku 모델 사용
-
----
-
-## 참고 링크
-
-- Ralph 공식 저장소: https://github.com/frankbria/ralph-claude-code
-- Claude Code 공식 문서: https://claude.ai/code
-- 비용 계산기: https://anthropic.com/pricing