muno-claude-plugin 1.11.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -184,21 +184,24 @@ Task Level (단위 테스트)
184
184
  **호출 조건:** "Epic 생성해줘", "Story 만들어줘", "백로그 작성" 등의 요청 시 자동 호출
185
185
 
186
186
  **입력:** PRD 문서
187
- **출력:** `backlogs/<feature>/` 디렉토리
187
+ **출력:** `documents/issues/{feature}/` 디렉토리
188
188
 
189
189
  **사용 예시:**
190
190
  ```
191
- @documents/prd/cart-prd.md 를 기반으로 Epic과 Story를 생성해주세요.
191
+ @documents/request/cart-prd.md 를 기반으로 Epic과 Story를 생성해주세요.
192
192
  ```
193
193
 
194
194
  **생성 구조:**
195
195
  ```
196
- backlogs/cart-feature/
197
- ├── index.md # 전체 백로그 개요
198
- ├── EPIC-001-cart.md # Epic 정의
199
- ├── STORY-001-add-item.md # User Story (AC 포함)
200
- ├── STORY-002-remove-item.md
201
- └── ...
196
+ documents/issues/cart/
197
+ ├── README.md # Epic 개요 (Epic이 있는 경우)
198
+ ├── stories/
199
+ ├── STORY-001-add-item.md # User Story (AC 포함)
200
+ ├── STORY-002-remove-item.md
201
+ └── ...
202
+ └── tasks/ # task-generator가 생성
203
+ └── STORY-{id}/
204
+ └── TASK-{seq}.md
202
205
  ```
203
206
 
204
207
  **User Story 포함 내용:**
@@ -267,21 +270,20 @@ backlogs/cart-feature/
267
270
  **호출 조건:** "태스크 생성해줘", "구현 작업 분해", "Task 만들어줘" 등의 요청 시 자동 호출
268
271
 
269
272
  **입력:** Story + LLD
270
- **출력:** `.tasks/<story-id>/` 디렉토리
273
+ **출력:** `documents/issues/{feature}/tasks/STORY-{id}/` 디렉토리
271
274
 
272
275
  **사용 예시:**
273
276
  ```
274
- @backlogs/cart-feature/STORY-001-add-item.md
275
- @documents/lld/cart-lld.md
277
+ @documents/issues/cart/stories/STORY-001-add-item.md
278
+ @documents/system-design/features/cart/lld.md
276
279
 
277
280
  구현 태스크를 생성해주세요.
278
281
  ```
279
282
 
280
283
  **생성 구조:**
281
284
  ```
282
- .tasks/STORY-001/
283
- ├── index.md # 태스크 목록 및 의존성
284
- ├── TASK-001-entity.md # 엔티티 구현
285
+ documents/issues/cart/tasks/STORY-001/
286
+ ├── TASK-001-entity.md
285
287
  ├── TASK-002-repository.md
286
288
  ├── TASK-003-service.md
287
289
  ├── TASK-004-controller.md
@@ -329,6 +331,72 @@ test-cases/STORY-001/
329
331
 
330
332
  ---
331
333
 
334
+ ### bulk-executor
335
+
336
+ **모든 TODO 상태 Task를 한 번에 순차 실행**
337
+
338
+ **호출 조건:** "100개 task 실행", "모든 task 구현", "bulk 실행", "전체 task 처리" 등의 요청 시 자동 호출
339
+
340
+ **입력:** documents/issues/ 디렉토리의 Task 파일들
341
+ **출력:** 구현 완료된 코드 + 완료 리포트
342
+
343
+ **사용 예시:**
344
+ ```
345
+ documents/issues/ 에 있는 모든 TODO 상태 task를 실행해줘.
346
+ ```
347
+
348
+ **동작 과정:**
349
+ 1. `documents/issues/**/tasks/**/*.md` 검색
350
+ 2. Frontmatter에서 `status: todo` 필터링
351
+ 3. `dependencies` 순서로 정렬
352
+ 4. 각 Task 순차 실행:
353
+ - Task 문서 읽기
354
+ - 코드 구현 (Write/Edit)
355
+ - 테스트 실행 (Bash)
356
+ - Frontmatter status 업데이트 (todo → done)
357
+ 5. 완료 리포트 생성
358
+
359
+ **자동 트리거되는 Subagent:**
360
+ - ✅ `unit-test-generator` - Task 구현 전 테스트 생성 (TDD)
361
+ - ✅ `code-reviewer` - 코드 작성 완료 후 리뷰
362
+ - ✅ `task-tracker` - Task 완료 시 상태 추적
363
+
364
+ **Ralph와 함께 사용하기:**
365
+
366
+ 대량의 Task (50개 이상)를 중단 없이 처리하려면 Ralph Wiggum 플러그인과 함께 사용하세요:
367
+
368
+ ```bash
369
+ # Ralph 설치 (한 번만)
370
+ git clone https://github.com/frankbria/ralph-claude-code.git
371
+ cd ralph-claude-code
372
+ ./install.sh
373
+
374
+ # Ralph로 bulk-executor 실행
375
+ /ralph-loop "/bulk-executor" --max-iterations 100
376
+ ```
377
+
378
+ **Ralph가 필요한 이유:**
379
+ - Claude Code는 작업 완료 시 자동 종료
380
+ - Ralph는 종료를 감지하고 자동으로 재시작
381
+ - 100개 Task도 중단 없이 처리 가능
382
+
383
+ **고급 옵션:**
384
+ ```bash
385
+ # Feature별 실행
386
+ /bulk-executor --feature=auth
387
+
388
+ # 실패한 Task만 재실행
389
+ /bulk-executor --failed-only
390
+
391
+ # Dry run (테스트 실행)
392
+ /bulk-executor --dry-run
393
+ ```
394
+
395
+ **참고 문서:**
396
+ - [Ralph 연동 가이드](templates/skills/bulk-executor/reference/ralph-guide.md)
397
+
398
+ ---
399
+
332
400
  ### app-design
333
401
 
334
402
  **UI/UX 디자인 자동 생성**
@@ -889,16 +957,31 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
889
957
  상태 자동 업데이트
890
958
  ```
891
959
 
892
- ### 문서 저장 위치
893
-
894
- | 산출물 | 위치 |
895
- |--------|------|
896
- | PRD | `documents/prd/<feature>-prd.md` |
897
- | HLD | `documents/hld/<feature>-hld.md` |
898
- | LLD | `documents/lld/<feature>-lld.md` |
899
- | Epic/Story | `backlogs/<feature>/` |
900
- | Task | `.tasks/<story-id>/` |
901
- | TC | `test-cases/<story-id>/` |
960
+ ### 문서 저장 위치 (Feature 기반 구조)
961
+
962
+ ```
963
+ documents/
964
+ ├── request/
965
+ │ └── <feature>-prd.md # PRD
966
+ ├── issues/
967
+ │ ├── <feature>/ # Feature별 그룹화
968
+ │ │ ├── README.md # Epic 개요 (선택)
969
+ │ │ ├── stories/
970
+ │ │ │ └── STORY-<id>-<name>.md # Story
971
+ │ │ └── tasks/
972
+ │ │ └── STORY-<id>/ # Story별 Task 그룹화
973
+ │ │ └── TASK-<id>.md # Task
974
+ │ └── standalone/ # Epic/Feature 없는 독립 작업
975
+ │ ├── stories/
976
+ │ └── tasks/
977
+ ├── system-design/
978
+ │ └── features/<feature>/
979
+ │ ├── hld.md # HLD
980
+ │ └── lld.md # LLD
981
+ └── test/
982
+ ├── acceptance/AT-<id>.md # Acceptance Test
983
+ └── unit/UT-<id>.md # Unit Test
984
+ ```
902
985
 
903
986
  ---
904
987
 
@@ -915,29 +998,30 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
915
998
  - 세션 관리
916
999
 
917
1000
  # 2. Epic/Story 생성 (epic-story-generator 스킬이 자동 호출됨)
918
- @documents/prd/auth-prd.md 기반으로 Epic과 Story를 생성해주세요.
1001
+ @documents/request/auth-prd.md 기반으로 Epic과 Story를 생성해주세요.
919
1002
 
920
1003
  # 3. TC 생성 (tc-generator 스킬이 자동 호출됨)
921
1004
  # → 이후 tc-reviewer, acceptance-test-generator 서브에이전트가 자동 실행됨
922
- @backlogs/auth/STORY-001-email-login.md 에 대한 테스트 케이스를 작성해주세요.
1005
+ @documents/issues/auth/stories/STORY-001-email-login.md 에 대한 테스트 케이스를 작성해주세요.
923
1006
 
924
1007
  # 4. HLD 생성 (hld-generator 스킬이 자동 호출됨)
925
- @backlogs/auth/STORY-001-email-login.md 의 HLD를 작성해주세요.
1008
+ @documents/issues/auth/stories/STORY-001-email-login.md 의 HLD를 작성해주세요.
926
1009
 
927
1010
  # 5. LLD 생성 (lld-generator 스킬이 자동 호출됨)
928
- @backlogs/auth/STORY-001-email-login.md
929
- @documents/hld/auth-hld.md
1011
+ @documents/issues/auth/stories/STORY-001-email-login.md
1012
+ @documents/system-design/features/auth/hld.md
930
1013
  위 문서를 기반으로 LLD를 작성해주세요.
931
1014
 
932
1015
  # 6. Task 생성 (task-generator 스킬이 자동 호출됨)
933
1016
  # → 이후 unit-test-generator 서브에이전트가 자동으로 테스트 먼저 생성
934
- @backlogs/auth/STORY-001-email-login.md
935
- @documents/lld/auth-lld.md
1017
+ @documents/issues/auth/stories/STORY-001-email-login.md
1018
+ @documents/system-design/features/auth/lld.md
936
1019
  구현 태스크를 생성해주세요.
937
1020
 
938
1021
  # 7. 구현 시작 (Developer 페르소나 활성화 - Command 사용)
939
1022
  /dev
940
- TASK-001 구현을 시작하겠습니다. 테스트가 통과하도록 구현해주세요.
1023
+ @documents/issues/auth/tasks/STORY-001/TASK-001-entity.md 구현을 시작하겠습니다.
1024
+ 테스트가 통과하도록 구현해주세요.
941
1025
  ```
942
1026
 
943
1027
  ### Example 2: 버그 수정 (간단한 워크플로우)
package/bin/cli.js CHANGED
@@ -3,7 +3,7 @@
3
3
  const fs = require('fs');
4
4
  const path = require('path');
5
5
 
6
- const VERSION = '1.11.0';
6
+ const VERSION = '1.13.0';
7
7
  const PACKAGE_NAME = 'muno-claude-plugin';
8
8
 
9
9
  // ANSI colors
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "muno-claude-plugin",
3
- "version": "1.11.0",
3
+ "version": "1.13.0",
4
4
  "description": "Unleash Claude Code's full power - Complete development workflow with expert personas, TDD-based agents, and automated documentation",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
@@ -27,7 +27,7 @@
27
27
  "license": "MIT",
28
28
  "repository": {
29
29
  "type": "git",
30
- "url": "git+https://github.com/headcha/muno-claude-plugin.git"
30
+ "url": "git+https://github.com/musinsa/muno-claude-plugin.git"
31
31
  },
32
32
  "engines": {
33
33
  "node": ">=18.0.0"
@@ -107,8 +107,7 @@ TC 생성 및 리뷰 흐름:
107
107
 
108
108
  1. tc-generator 실행
109
109
  └─ Story AC 분석
110
- └─ AT 문서 생성 (documents/test/acceptance/AT-XXX.md)
111
- └─ UT 문서 생성 (documents/test/unit/UT-XXX.md)
110
+ └─ AT 문서 생성 (documents/test/acceptance/STORY-{id}/AT-XXX.md)
112
111
 
113
112
 
114
113
  2. tc-reviewer 자동 호출
@@ -129,7 +128,7 @@ TC 생성 및 리뷰 흐름:
129
128
  ## 입력: AT 문서 구조
130
129
 
131
130
  ```yaml
132
- # documents/test/acceptance/AT-001-create-chatroom.md
131
+ # documents/test/acceptance/STORY-001/AT-001.md
133
132
  ---
134
133
  id: AT-001
135
134
  title: 채팅방 생성 - Happy Path
@@ -246,8 +245,8 @@ status: ready
246
245
  ### Step 1: AT 분석
247
246
 
248
247
  ```
249
- 1. AT 문서 읽기 (documents/test/acceptance/AT-XXX.md)
250
- 2. 전체 AT 목록 확인
248
+ 1. AT 문서 읽기 (documents/test/acceptance/STORY-{id}/AT-XXX.md)
249
+ 2. Story별 AT 목록 확인
251
250
  3. 각 AT의 유형 파악 (integration, e2e, etc.)
252
251
  4. 우선순위 확인 (high, medium, low)
253
252
  ```
@@ -58,7 +58,7 @@ color: cyan
58
58
  ## PRD 작성 기준
59
59
 
60
60
  ```
61
- ┌─────────────────────────────────────────────────────────────────┐
61
+ ┌───그럼 ──────────────────────────────────────────────────────────────┐
62
62
  │ PRD는 "새로운 요구사항"에 작성 │
63
63
  ├─────────────────────────────────────────────────────────────────┤
64
64
  │ │