maskweaver 0.8.0 → 0.8.2

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.
Files changed (39) hide show
  1. package/README.ko.md +19 -36
  2. package/README.md +20 -37
  3. package/assets/commands/weave-approve-plan.md +1 -1
  4. package/assets/commands/weave-craft.md +6 -6
  5. package/assets/commands/weave-design.md +5 -2
  6. package/assets/commands/weave-flow.md +5 -16
  7. package/assets/commands/weave-help.md +9 -19
  8. package/assets/commands/weave-prepare.md +3 -3
  9. package/assets/commands/weave-research.md +4 -2
  10. package/dist/plugin/index.d.ts.map +1 -1
  11. package/dist/plugin/index.js +18 -0
  12. package/dist/plugin/index.js.map +1 -1
  13. package/dist/plugin/tools/slashcommand.d.ts.map +1 -1
  14. package/dist/plugin/tools/slashcommand.js +12 -11
  15. package/dist/plugin/tools/slashcommand.js.map +1 -1
  16. package/dist/plugin/tools/weave.d.ts +7 -17
  17. package/dist/plugin/tools/weave.d.ts.map +1 -1
  18. package/dist/plugin/tools/weave.js +264 -145
  19. package/dist/plugin/tools/weave.js.map +1 -1
  20. package/dist/weave/phase-manager.d.ts +5 -0
  21. package/dist/weave/phase-manager.d.ts.map +1 -1
  22. package/dist/weave/phase-manager.js +25 -0
  23. package/dist/weave/phase-manager.js.map +1 -1
  24. package/dist/weave/stages/execute.js +7 -7
  25. package/dist/weave/stages/execute.js.map +1 -1
  26. package/dist/weave/stages/plan.d.ts +8 -0
  27. package/dist/weave/stages/plan.d.ts.map +1 -1
  28. package/dist/weave/stages/plan.js +161 -2
  29. package/dist/weave/stages/plan.js.map +1 -1
  30. package/dist/weave/stages/research.d.ts.map +1 -1
  31. package/dist/weave/stages/research.js +431 -4
  32. package/dist/weave/stages/research.js.map +1 -1
  33. package/dist/weave/types.d.ts +6 -0
  34. package/dist/weave/types.d.ts.map +1 -1
  35. package/package.json +1 -1
  36. package/assets/commands/wave-task-auto.md +0 -15
  37. package/assets/commands/weave-approve.md +0 -70
  38. package/assets/commands/weave-task-auto.md +0 -48
  39. package/assets/commands/weave-task.md +0 -88
package/README.ko.md CHANGED
@@ -172,18 +172,15 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
172
172
  | 명령어 | 설명 |
173
173
  |--------|------|
174
174
  | `/weave init` | Weave 초기화 (프로젝트당 1회) |
175
- | `/weave research [docs]` | 문서를 깊게 읽고 `tasks/research.md` 생성 |
176
- | `/weave prepare [docs]` | (수동 경로) research + baseline spec + phase plan 생성 |
175
+ | `/weave research [docs]` | 문서 + 워크스페이스 맥락을 깊게 읽고 `tasks/research.md` 생성 |
176
+ | `/weave prepare [docs]` | (수동 경로) research + baseline spec + phase plan 생성 (큰 계획은 자동 분할) |
177
177
  | `/weave refine-plan` | `tasks/plan-notes.md` 지시문을 active plan에 반영 |
178
178
  | `/weave approve-plan` | 구현 전 사람이 계획 승인(게이트) |
179
- | `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> approve-plan gate -> craft -> task auto |
179
+ | `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> approve-plan gate -> craft auto-loop + auto finalize |
180
180
  | `/weave spec [docs]` | baseline spec만 생성 (선택) |
181
- | `/weave design [docs]` | 요구사항 분석 → Phase 계획 생성 (`/weave plan`은 별칭/호환) |
182
- | `/weave craft [P#]` | Phase 실행 계획 생성/실행 (phase 생략 자동 선택) |
183
- | `/weave task ...` | Task 루프 (start/fail/retry/pass/auto) + 옵션 검증/커밋 |
184
- | `/weave-task-auto [P#|P#-T#]` | 인자 최소화 자동 루프 (기본 quick verify) |
181
+ | `/weave design [docs]` | 요구사항 분석 → Phase 계획 생성 (`/weave plan`은 별칭/호환, 큰 계획은 자동 분할) |
182
+ | `/weave craft [P#]` | Phase 실행 계획 생성/실행 + 자동 task loop + 목표 체크 + auto finalize |
185
183
  | `/weave verify` | 빌드/테스트 검증 실행 (자동 감지) |
186
- | `/weave approve [P#]` | (기본)검증 후 Phase 완료 처리 (phase 생략 시 자동 선택) |
187
184
  | `/weave worktree ...` | git worktree 기반 병렬 작업 관리 |
188
185
  | `/weave status` | 프로젝트 진행 상황 및 통계 확인 |
189
186
  | `/weave help` | 도움말 표시 |
@@ -196,7 +193,7 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
196
193
  0. INIT (1회): /weave init
197
194
 
198
195
  1. 원커맨드(권장): /weave flow docs/
199
- - 실행: prepare -> approve-plan gate -> craft -> task auto
196
+ - 실행: prepare -> approve-plan gate -> craft auto-loop
200
197
 
201
198
  (또는 수동 경로)
202
199
 
@@ -207,19 +204,14 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
207
204
  - tasks/plan-notes.md 기반 계획 정제
208
205
 
209
206
  4. APPROVAL GATE: /weave approve-plan
210
- - craft/task 실행 전 필수 승인
207
+ - craft 실행 전 필수 승인
211
208
 
212
209
  5. CRAFT: /weave craft
213
- - Phase 실행 계획(execution plan) 생성 (tasks + 추천 마스크/에이전트 티어)
210
+ - Phase 실행 계획 생성 + 자동 task loop 실행
211
+ - PASS/FAIL/재시도/re-plan은 craft 루프에서 처리
212
+ - 마지막에 phase 목표 체크 + full verify + 완료 처리를 자동 수행
214
213
 
215
- 6. TASK LOOP: /weave task ... (또는 /weave-task-auto)
216
- - PASS → 옵션: quick verify + 원자 커밋
217
- - FAIL → 에러 기록 → 글로벌 지식 검색 → 재시도 (최대 5회)
218
-
219
- 7. APPROVE: /weave approve
220
- - (기본) verify 실행 후 Phase를 completed로 변경
221
-
222
- 8. HANDOFF: 유저가 UX/의도 확인 후 다음 Phase로 진행
214
+ 6. HANDOFF: 유저가 UX/의도 확인 다음 Phase로 진행
223
215
  ```
224
216
 
225
217
  #### 다층 AI 검증 시스템
@@ -368,7 +360,7 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
368
360
  /weave flow docs/
369
361
  ```
370
362
 
371
- 한 번에 `prepare -> approve-plan gate -> craft -> task auto`까지 실행합니다.
363
+ 한 번에 `prepare -> approve-plan gate -> craft auto-loop`까지 실행합니다.
372
364
 
373
365
  수동 happy path (research + spec + plan 한 번에):
374
366
 
@@ -423,35 +415,26 @@ AI 인사이트가 포함된 현대적 감정 일기 앱 구축
423
415
  /weave craft
424
416
  ```
425
417
 
426
- `/weave craft`는 Phase를 실행하기 위한 실행 계획을 생성/표시합니다(phase 미지정 시 다음 phase 자동 선택). 이후 실제 진행/상태 업데이트는 `weave command=task ...` 루프로 굴립니다.
427
-
428
- ### 4단계: Task 루프
429
-
430
- ```txt
431
- weave command=task phaseId="P1" taskAction=list
432
- weave command=task phaseId="P1" taskAction=next
433
- weave command=task phaseId="P1" taskAction=start taskId="P1-T1"
434
- weave command=task phaseId="P1" taskAction=pass taskId="P1-T1" verify=true verifyMode="quick"
435
- weave command=task phaseId="P1" taskAction=fail taskId="P1-T1" taskError="<error message>"
436
- ```
418
+ `/weave craft`는 실행 계획을 생성한 자동 task loop를 즉시 실행합니다(phase 미지정 시 다음 phase 자동 선택). 구현 반영 같은 명령을 다시 실행하면 이어서 진행됩니다.
437
419
 
438
- 입력을 줄이고 자동으로 굴리려면:
420
+ ### 4단계: Craft 루프 이어서 진행
439
421
 
440
422
  ```txt
441
- weave command=task phaseId="P1" taskAction=auto verify=true verifyMode="quick"
423
+ weave command=craft phaseId="P1"
424
+ weave command=craft phaseId="P1" taskId="P1-T1"
442
425
  ```
443
426
 
444
- 같은 흐름을 원커맨드로 이어서 실행하려면:
427
+ 원커맨드로 계속 이어서 진행하려면:
445
428
 
446
429
  ```txt
447
430
  weave command=flow
448
431
  ```
449
432
 
450
- ### 5단계: 검증 및 Phase 완료 처리
433
+ ### 5단계: 자동 완료 처리
451
434
 
452
435
  ```txt
453
436
  weave command=verify
454
- weave command=approve
437
+ weave command=craft
455
438
  ```
456
439
 
457
440
  진행 상황 출력:
package/README.md CHANGED
@@ -191,18 +191,15 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
191
191
  | Command | Description |
192
192
  |---------|-------------|
193
193
  | `/weave init` | Initialize Weave (once per repo) |
194
- | `/weave research [docs]` | Deep-read docs and generate persistent `tasks/research.md` |
195
- | `/weave prepare [docs]` | (Manual path) Generate research + baseline spec + phase plan |
194
+ | `/weave research [docs]` | Deep-read docs + workspace context and generate persistent `tasks/research.md` |
195
+ | `/weave prepare [docs]` | (Manual path) Generate research + baseline spec + phase plan (auto-split if oversized) |
196
196
  | `/weave refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
197
197
  | `/weave approve-plan` | Explicit human approval gate before implementation |
198
- | `/weave flow [docs]` | (Recommended) One-command path: prepare -> approve-plan gate -> craft -> task auto |
198
+ | `/weave flow [docs]` | (Recommended) One-command path: prepare -> approve-plan gate -> craft auto-loop + auto finalize |
199
199
  | `/weave spec [docs]` | Generate baseline spec only (optional) |
200
- | `/weave design [docs]` | Analyze requirements → Generate phase plan (`/weave plan` is an alias) |
201
- | `/weave craft [P#]` | Generate/run execution plan (auto-select next phase if omitted) |
202
- | `/weave task ...` | Drive task loop (start/fail/retry/pass/auto) + optional verify/commit |
203
- | `/weave-task-auto [P#|P#-T#]` | Minimal-args auto task loop (quick verify by default) |
200
+ | `/weave design [docs]` | Analyze requirements → Generate phase plan (`/weave plan` alias, auto-split if oversized) |
201
+ | `/weave craft [P#]` | Generate/run execution plan + auto task loop + goal check + auto finalize |
204
202
  | `/weave verify` | Run build/test verification (auto-detect) |
205
- | `/weave approve [P#]` | Verify (default) + mark phase complete (auto phase if omitted) |
206
203
  | `/weave worktree ...` | Manage git worktrees for parallel work |
207
204
  | `/weave status` | View project progress and stats |
208
205
  | `/weave help` | Show documentation |
@@ -215,7 +212,7 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
215
212
  0. INIT (once): /weave init
216
213
 
217
214
  1. ONE-COMMAND (recommended): /weave flow docs/
218
- - runs: prepare -> approve-plan gate -> craft -> task auto
215
+ - runs: prepare -> approve-plan gate -> craft auto-loop
219
216
 
220
217
  (or manual path)
221
218
 
@@ -226,19 +223,14 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
226
223
  - apply annotation notes from tasks/plan-notes.md
227
224
 
228
225
  4. APPROVAL GATE: /weave approve-plan
229
- - required before craft/task execution
226
+ - required before craft execution
230
227
 
231
228
  5. CRAFT: /weave craft
232
- - Generates an execution plan (tasks + suggested masks/agent tiers)
229
+ - Generates an execution plan + runs auto task loop
230
+ - PASS/FAIL/retry/re-plan are handled in the craft loop
231
+ - Final goal check + full verification + phase completion are automatic
233
232
 
234
- 6. TASK LOOP: /weave task ... (or /weave-task-auto)
235
- - PASS → optional quick verify + optional atomic commit
236
- - FAIL → record error → search Global Knowledge → retry (max 5)
237
-
238
- 7. APPROVE: /weave approve
239
- - Runs verification (full by default) and marks the phase completed
240
-
241
- 8. HANDOFF: You validate UX/intent and move to next phase
233
+ 6. HANDOFF: You validate UX/intent and move to next phase
242
234
  ```
243
235
 
244
236
  #### Multi-Layer AI Verification
@@ -387,7 +379,7 @@ Fastest path (one command):
387
379
  /weave flow docs/
388
380
  ```
389
381
 
390
- This runs `prepare -> approve-plan gate -> craft -> task auto` in one shot.
382
+ This runs `prepare -> approve-plan gate -> craft auto-loop` in one shot.
391
383
 
392
384
  Manual happy path (research + spec + plan in one command):
393
385
 
@@ -442,35 +434,26 @@ Start with the first phase:
442
434
  /weave craft
443
435
  ```
444
436
 
445
- `/weave craft` returns an execution plan the Mask Weaver can delegate/execute. Use `/weave task` (or `/weave-task-auto`) to drive the task loop and keep the plan state updated.
446
-
447
- ### Step 4: Drive the Task Loop
448
-
449
- ```txt
450
- weave command=task phaseId="P1" taskAction=list
451
- weave command=task phaseId="P1" taskAction=next
452
- weave command=task phaseId="P1" taskAction=start taskId="P1-T1"
453
- weave command=task phaseId="P1" taskAction=pass taskId="P1-T1" verify=true verifyMode="quick"
454
- weave command=task phaseId="P1" taskAction=fail taskId="P1-T1" taskError="<error message>"
455
- ```
437
+ `/weave craft` returns an execution plan and immediately runs the auto task loop. Re-run `/weave craft` after implementation updates to continue the same phase.
456
438
 
457
- One-shot auto loop (less manual typing):
439
+ ### Step 4: Continue the Craft Loop
458
440
 
459
441
  ```txt
460
- weave command=task phaseId="P1" taskAction=auto verify=true verifyMode="quick"
442
+ weave command=craft phaseId="P1"
443
+ weave command=craft phaseId="P1" taskId="P1-T1"
461
444
  ```
462
445
 
463
- You can also continue everything with one command:
446
+ One-command resume:
464
447
 
465
448
  ```txt
466
449
  weave command=flow
467
450
  ```
468
451
 
469
- ### Step 5: Verify and Approve the Phase
452
+ ### Step 5: Auto Finalization
470
453
 
471
454
  ```txt
472
455
  weave command=verify
473
- weave command=approve
456
+ weave command=craft
474
457
  ```
475
458
 
476
459
  Progress output:
@@ -492,7 +475,7 @@ Progress output:
492
475
  - Fix: Added useEffect dependency array
493
476
  ```
494
477
 
495
- ### Step 5: Handoff & Validate
478
+ ### Step 6: Handoff & Validate
496
479
 
497
480
  When all verifications pass:
498
481
 
@@ -12,7 +12,7 @@ description: 구현 전 계획 승인 게이트 통과
12
12
  - 기본적으로 `tasks/plan-notes.md` 지시문을 먼저 자동 반영(refine) 시도
13
13
  - 변경이 반영되면 승인 단계는 일시 중단되고, 검토 후 다시 approve 실행
14
14
  - 필요 시 plan 메모를 승인 코멘트로 함께 기록
15
- - 승인 전에는 `weave craft`/`weave flow`/`weave task auto`가 차단됩니다
15
+ - 승인 전에는 `weave craft`/`weave flow` 실행이 차단됩니다
16
16
 
17
17
  ---
18
18
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Phase 실행 (Build + Self-Verify Loop with Mask auto-selection)
2
+ description: Phase 실행 (Build + Self-Verify Loop + 목표 체크 + auto finalize)
3
3
  ---
4
4
 
5
5
  # /weave-craft - Phase 실행
@@ -13,7 +13,7 @@ AI가 자동으로 검증 루프를 돌리고, 완료되면 유저에게 전달
13
13
  - `$ARGUMENTS` = 선택적 Phase ID (예: `P1`, `P2`)
14
14
  - 비우면 다음 실행 가능한 Phase를 자동 선택합니다.
15
15
 
16
- > prepare부터 task auto까지 한 번에 실행하려면 `/weave-flow [docs]`를 사용하세요.
16
+ > prepare부터 craft auto-loop까지 한 번에 실행하려면 `/weave-flow [docs]`를 사용하세요.
17
17
 
18
18
  **Maskweaver 통합**:
19
19
  - **Masks**: Task별 전문가 마스크 자동 선택
@@ -77,8 +77,8 @@ AI가 자동으로 검증 루프를 돌리고, 완료되면 유저에게 전달
77
77
  │ ├─ 최소 구현 (Green)
78
78
  │ ├─ 정리 (Refactor)
79
79
  │ └─ AI 자동 검증 → PASS/FAIL
80
- │ ├─ PASS → `weave task ... taskAction=pass`로 상태 업데이트 (옵션: quick verify/commit)
81
- │ └─ FAIL → `weave task ... taskAction=fail`로 기록 글로벌 지식 검색 → 수정 → 재검증
80
+ │ ├─ PASS → `weave craft ...` 재실행으로 상태 업데이트 (옵션: quick verify/commit)
81
+ │ └─ FAIL → 실패 기록 + 글로벌 지식 검색 → 수정 → `weave craft ...` 재실행
82
82
  └─ 5회 초과 → 유저에게 도움 요청
83
83
 
84
84
  4. UPDATE PLAN (Phase 상태 업데이트)
@@ -86,8 +86,8 @@ AI가 자동으로 검증 루프를 돌리고, 완료되면 유저에게 전달
86
86
  5. USER HANDOFF (검증 완료 → 유저 테스트)
87
87
  ```
88
88
 
89
- > 참고: Phase 완료 처리는 `weave approve`가 담당합니다.
90
- > 기본적으로 full verify 수행하고, 통과해야 Phase를 completed 바꿉니다.
89
+ > 참고: task loop 완료 `weave craft`가 phase 목표를 마지막으로 확인하고,
90
+ > full verify까지 통과하면 phase자동으로 completed 처리합니다.
91
91
 
92
92
  ---
93
93
 
@@ -6,8 +6,11 @@ description: 요구사항 분석 및 Phase 계획 수립 (멀티 플랜)
6
6
 
7
7
  ## 개요
8
8
 
9
- 유저의 요구사항 문서를 분석하고, Phase별 실행 계획을 수립합니다.
10
- **멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
9
+ 유저의 요구사항 문서를 분석하고, Phase별 실행 계획을 수립합니다.
10
+ **멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
11
+
12
+ 큰 계획(phase/시간 규모가 큰 경우)은 자동으로 여러 shard plan 파일로 분할되며,
13
+ 각 shard는 독립적으로 세부 설계(task/checklist)를 갖습니다.
11
14
 
12
15
  **입력 방식**:
13
16
  - 정확한 경로: `docs/`, `wiki/spec.md`
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: 원커맨드 실행 (prepare -> approve-plan gate -> craft -> task auto)
2
+ description: 원커맨드 실행 (prepare -> approve-plan gate -> craft auto-loop + auto finalize)
3
3
  ---
4
4
 
5
5
  # /weave-flow - 원커맨드 실행
@@ -12,10 +12,9 @@ description: 원커맨드 실행 (prepare -> approve-plan gate -> craft -> task
12
12
  - `refine-plan` (선택): `tasks/plan-notes.md` 지시문 반영
13
13
  - `plan gate`: 실행 전 계획 품질 점검 (task 분해/테스트/검증 커버리지)
14
14
  - `approval gate`: `approve-plan` 전에는 구현 단계로 내려가지 않음
15
- - `craft`: 실행 대상 phase 준비
16
- - `task auto`: 현재 task 자동 루프 진입
17
- - `task auto` 반복 실패 re-plan 서브태스크 자동 생성
18
- - (옵션) `approve`: 모든 task가 끝나면 full verify + phase approve
15
+ - `craft`: 실행 대상 phase 준비 + 자동 task 루프 실행
16
+ - `craft auto-loop` 반복 실패 시 re-plan 서브태스크 자동 생성
17
+ - `craft` 마지막에 phase 목표 체크 + full verify + auto finalize
19
18
 
20
19
  > 목표: 유저가 명령을 여러 번 기억하지 않고, 한 번의 호출로 실행 흐름에 진입하되,
21
20
  > 구현 전 승인 게이트는 반드시 지키도록 합니다.
@@ -53,16 +52,6 @@ weave command=flow
53
52
  > 참고: plan이 아직 승인되지 않았다면 flow는 approval gate에서 멈추고
54
53
  > `weave command=approve-plan` 실행을 안내합니다.
55
54
 
56
- 모든 task 완료 후 자동 approve를 원하면:
57
-
58
- ```txt
59
- weave command=flow autoApprove=true
60
- ```
61
-
62
- `autoApprove=true`면 내부적으로 `weave approve`(full verify)를 실행합니다.
63
-
64
- ---
65
-
66
55
  ## 산출물
67
56
 
68
57
  - `tasks/todo.md`: 현재 plan/phase/task 체크리스트 + 최근 리뷰
@@ -73,4 +62,4 @@ weave command=flow autoApprove=true
73
62
  ## 다음 단계
74
63
 
75
64
  - 구현을 반영한 뒤 `/weave-flow`를 다시 실행하면 같은 phase/task에서 이어서 진행합니다.
76
- - 모든 task가 끝나면 `/weave-approve`로 완료 처리하세요.
65
+ - 모든 task가 끝나면 craft가 자동으로 finalize를 수행합니다.
@@ -42,22 +42,19 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
42
42
  | 명령어 | 설명 |
43
43
  |--------|------|
44
44
  | `/weave-init` | Weave 초기화 (프로젝트당 1회) |
45
- | `/weave-research [docs]` | 문서를 깊게 읽고 `tasks/research.md` 생성 |
45
+ | `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
46
46
  | `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
47
- | `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (vNext 기본 경로) |
47
+ | `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** ( 계획은 자동 분할) |
48
48
  | `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
49
49
  | `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
50
- | `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft task auto |
51
- | `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성) |
50
+ | `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft auto-loop + auto finalize |
51
+ | `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성, 큰 계획은 자동 분할) |
52
52
  | `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
53
- | `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 (id 생략 다음 Phase 자동 선택) |
53
+ | `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 + 자동 task loop + 목표 체크 + auto finalize |
54
54
  | `/weave-status` | 전체 플랜 목록 + 진행 상황 |
55
55
  | `/weave-switch [plan]` | 활성 플랜 전환 / 아카이브 |
56
56
  | `/weave-worktree` | git worktree 기반 병렬 작업(기능/Phase) 관리 |
57
- | `/weave-task` | Task 루프(start/fail/retry/pass/auto) + 옵션 검증/커밋 |
58
- | `/weave-task-auto [P#|P#-T#]` | 인자 최소화 자동 루프(quick verify 기본) |
59
57
  | `/weave-verify` | 빌드/테스트 검증 실행(프로젝트 유형 자동 감지) |
60
- | `/weave-approve [P#]` | Phase 승인(phase 생략 시 자동 선택, 검증 후 완료 처리) |
61
58
  | `/weave-help` | 이 도움말 |
62
59
 
63
60
  ---
@@ -67,7 +64,7 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
67
64
  ```
68
65
  /weave-init ← 프로젝트 초기화 (1회)
69
66
 
70
- /weave-flow docs/ ← (원커맨드) prepare→approve-plan gate→craft→task auto
67
+ /weave-flow docs/ ← (원커맨드) prepare→approve-plan gate→craft auto-loop
71
68
 
72
69
  /weave-prepare docs/ ← (수동 경로) research+spec+plan 한 번에 생성
73
70
 
@@ -75,8 +72,7 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
75
72
 
76
73
  /weave-approve-plan ← 구현 전 계획 승인 (필수)
77
74
 
78
- /weave-craft ← 다음 Phase 자동 선택 실행
79
- /weave-task-auto ← 현재 task 반자동 루프
75
+ /weave-craft ← 다음 Phase 자동 선택 실행 + 자동 task loop
80
76
 
81
77
  /weave-design wiki/new-feat ← 두 번째 플랜 추가 (또는 prepare)
82
78
 
@@ -154,15 +150,9 @@ Phase 실행 시 자동 검증:
154
150
  # 4. 다음 Phase 자동 선택 실행
155
151
  /weave-craft
156
152
 
157
- # 5. Task 반자동 루프 (구현 후 반복)
158
- /weave-task-auto
159
-
160
- # 6. 승인 (phase 생략 가능)
161
- /weave-approve
162
-
163
- # 7. 새 기능 추가? 새 플랜!
153
+ # 5. 기능 추가? 플랜!
164
154
  /weave-design docs/new-feature
165
155
 
166
- # 8. 플랜 사이 전환
156
+ # 6. 플랜 사이 전환
167
157
  /weave-switch emotion-diary
168
158
  ```
@@ -10,14 +10,14 @@ description: research + spec + plan을 한 번에 생성 (vNext 기본 경로)
10
10
 
11
11
  - 문서를 깊게 읽어 **research.md** 아티팩트를 생성합니다
12
12
  - 문서에서 요구사항을 추출해 **baseline spec**을 생성합니다
13
- - 같은 입력으로 Phase 기반 **plan**을 생성합니다
13
+ - 같은 입력으로 Phase 기반 **plan**을 생성합니다 (큰 계획은 shard plan 파일로 자동 분할)
14
14
  - 마지막에 승인 단계(`weave approve-plan`)를 안내합니다
15
15
 
16
16
  > 목적: 작은 기능마다 spec/plan을 두 번 돌리는 마찰을 줄이고,
17
17
  > "리서치-계획-승인"을 빠르게 통과할 수 있는 기본 경로(happy path)를 제공합니다.
18
18
 
19
19
  > 더 단순한 원커맨드가 필요하면 `/weave-flow [docs]`를 사용하세요
20
- > (`prepare -> approve-plan gate -> craft -> task auto`를 한 번에 실행).
20
+ > (`prepare -> approve-plan gate -> craft auto-loop`를 한 번에 실행).
21
21
 
22
22
  ---
23
23
 
@@ -52,7 +52,7 @@ weave command=prepare docsPath="$ARGUMENTS" projectName="My Project" planName="e
52
52
 
53
53
  - Research: `tasks/research.md`
54
54
  - Spec: `.opencode/weave/specs/{planName}.yaml`
55
- - Plan: `.opencode/weave/plans/{planName}.yaml` (weave-init 기반 멀티플랜 모드)
55
+ - Plan: `.opencode/weave/plans/{planName}.yaml` 또는 `.opencode/weave/plans/{planName}-s*.yaml`
56
56
 
57
57
  > 주의: `.opencode/`가 gitignore 대상일 수 있으므로, AI 도구가 파일을 읽을 수 있게 `/weave-init`의 `.ignore` 설정을 권장합니다.
58
58
 
@@ -1,14 +1,16 @@
1
1
  ---
2
- description: 문서를 깊게 읽고 research.md 생성
2
+ description: 문서 + 워크스페이스 맥락을 깊게 조사해 research.md 생성
3
3
  ---
4
4
 
5
5
  # /weave-research - 리서치 아티팩트 생성
6
6
 
7
7
  ## 개요
8
8
 
9
- `/weave-research`는 요구사항 문서를 먼저 깊게 분석하고, 리뷰 가능한 리서치 문서를 생성합니다.
9
+ `/weave-research`는 요구사항 문서와 현재 워크스페이스를 함께 조사해, 리뷰 가능한 리서치 문서를 생성합니다.
10
10
 
11
11
  - 입력 문서를 분석해 핵심 기능/기술 신호를 추출
12
+ - 워크스페이스에서 관련 구현/중복 신호/재사용 후보를 조사
13
+ - 문제 재현 흐름(가능한 범위)과 전/후 맥락을 정리
12
14
  - 열려 있는 질문과 환경 리스크를 정리
13
15
  - `tasks/research.md`에 영속 아티팩트로 저장
14
16
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AASF,UAAU,aAAa;IACrB,MAAM,EAAE;QACN,GAAG,EAAE;YACH,GAAG,CAAC,KAAK,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;SACpG,CAAC;KACH,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oCAAoC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxG,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC,CAAC;AA2xBH,eAAO,MAAM,gBAAgB,EAAE,MAmc9B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AASF,UAAU,aAAa;IACrB,MAAM,EAAE;QACN,GAAG,EAAE;YACH,GAAG,CAAC,KAAK,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;SACpG,CAAC;KACH,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oCAAoC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxG,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC,CAAC;AA6yBH,eAAO,MAAM,gBAAgB,EAAE,MAmc9B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
@@ -33,6 +33,12 @@ import { createMaskSaveTool } from './tools/maskSave.js';
33
33
  import { createSquadTool } from './tools/squad.js';
34
34
  import { createWeaveTool } from './tools/weave.js';
35
35
  import { createSlashcommandTool } from './tools/slashcommand.js';
36
+ const REMOVED_WEAVE_COMMAND_FILES = [
37
+ 'weave-task.md',
38
+ 'weave-task-auto.md',
39
+ 'wave-task-auto.md',
40
+ 'weave-approve.md',
41
+ ];
36
42
  function getAssetsDir() {
37
43
  try {
38
44
  const __filename = fileURLToPath(import.meta.url);
@@ -122,6 +128,18 @@ function installAssets(projectDir) {
122
128
  if (fs.existsSync(commandsSrc)) {
123
129
  copyDirRecursive(commandsSrc, commandsDest, result, true);
124
130
  }
131
+ // Hard-remove deprecated weave commands to keep a craft-centric flow.
132
+ for (const commandFile of REMOVED_WEAVE_COMMAND_FILES) {
133
+ const legacyPath = path.join(commandsDest, commandFile);
134
+ if (!fs.existsSync(legacyPath))
135
+ continue;
136
+ try {
137
+ fs.unlinkSync(legacyPath);
138
+ }
139
+ catch (e) {
140
+ result.errors.push(`Failed to remove deprecated command ${commandFile}: ${e}`);
141
+ }
142
+ }
125
143
  }
126
144
  return result;
127
145
  }