maskweaver 0.7.35 → 0.8.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.
Files changed (41) hide show
  1. package/README.ko.md +37 -19
  2. package/README.md +36 -18
  3. package/assets/commands/weave-approve-plan.md +57 -0
  4. package/assets/commands/weave-flow.md +27 -3
  5. package/assets/commands/weave-help.md +15 -7
  6. package/assets/commands/weave-prepare.md +9 -5
  7. package/assets/commands/weave-refine-plan.md +60 -0
  8. package/assets/commands/weave-research.md +49 -0
  9. package/assets/commands/weave-task-auto.md +2 -0
  10. package/assets/commands/weave-task.md +6 -0
  11. package/dist/plugin/tools/slashcommand.d.ts.map +1 -1
  12. package/dist/plugin/tools/slashcommand.js +65 -9
  13. package/dist/plugin/tools/slashcommand.js.map +1 -1
  14. package/dist/plugin/tools/weave.d.ts +12 -1
  15. package/dist/plugin/tools/weave.d.ts.map +1 -1
  16. package/dist/plugin/tools/weave.js +796 -45
  17. package/dist/plugin/tools/weave.js.map +1 -1
  18. package/dist/version.d.ts +1 -1
  19. package/dist/version.js +1 -1
  20. package/dist/weave/index.d.ts +2 -0
  21. package/dist/weave/index.d.ts.map +1 -1
  22. package/dist/weave/index.js +2 -0
  23. package/dist/weave/index.js.map +1 -1
  24. package/dist/weave/phase-manager.d.ts.map +1 -1
  25. package/dist/weave/phase-manager.js +44 -2
  26. package/dist/weave/phase-manager.js.map +1 -1
  27. package/dist/weave/stages/index.d.ts +4 -0
  28. package/dist/weave/stages/index.d.ts.map +1 -1
  29. package/dist/weave/stages/index.js +2 -0
  30. package/dist/weave/stages/index.js.map +1 -1
  31. package/dist/weave/stages/refine.d.ts +17 -0
  32. package/dist/weave/stages/refine.d.ts.map +1 -0
  33. package/dist/weave/stages/refine.js +369 -0
  34. package/dist/weave/stages/refine.js.map +1 -0
  35. package/dist/weave/stages/research.d.ts +22 -0
  36. package/dist/weave/stages/research.d.ts.map +1 -0
  37. package/dist/weave/stages/research.js +108 -0
  38. package/dist/weave/stages/research.js.map +1 -0
  39. package/dist/weave/types.d.ts +7 -0
  40. package/dist/weave/types.d.ts.map +1 -1
  41. package/package.json +8 -8
package/README.ko.md CHANGED
@@ -172,8 +172,11 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
172
172
  | 명령어 | 설명 |
173
173
  |--------|------|
174
174
  | `/weave init` | Weave 초기화 (프로젝트당 1회) |
175
- | `/weave prepare [docs]` | (수동 경로) baseline spec + phase plan 한 번에 생성 |
176
- | `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> craft -> task auto |
175
+ | `/weave research [docs]` | 문서를 깊게 읽고 `tasks/research.md` 생성 |
176
+ | `/weave prepare [docs]` | (수동 경로) research + baseline spec + phase plan 생성 |
177
+ | `/weave refine-plan` | `tasks/plan-notes.md` 지시문을 active plan에 반영 |
178
+ | `/weave approve-plan` | 구현 전 사람이 계획 승인(게이트) |
179
+ | `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> approve-plan gate -> craft -> task auto |
177
180
  | `/weave spec [docs]` | baseline spec만 생성 (선택) |
178
181
  | `/weave design [docs]` | 요구사항 분석 → Phase 계획 생성 (`/weave plan`은 별칭/호환) |
179
182
  | `/weave craft [P#]` | Phase 실행 계획 생성/실행 (phase 생략 시 자동 선택) |
@@ -193,24 +196,30 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
193
196
  0. INIT (1회): /weave init
194
197
 
195
198
  1. 원커맨드(권장): /weave flow docs/
196
- - 실행: prepare -> craft -> task auto
199
+ - 실행: prepare -> approve-plan gate -> craft -> task auto
197
200
 
198
201
  (또는 수동 경로)
199
202
 
200
203
  2. PLAN (수동): /weave prepare docs/
201
- - 또는: /weave spec docs/ → /weave design docs/
204
+ - 또는: /weave research docs/ → /weave spec docs/ → /weave design docs/
202
205
 
203
- 3. CRAFT: /weave craft
204
- - Phase 실행 계획(execution plan) 생성 (tasks + 추천 마스크/에이전트 티어)
206
+ 3. REFINE (선택): /weave refine-plan
207
+ - tasks/plan-notes.md 기반 계획 정제
205
208
 
206
- 4. TASK LOOP: /weave task ... (또는 /weave-task-auto)
207
- - PASS 옵션: quick verify + 원자 커밋
208
- - FAIL → 에러 기록 → 글로벌 지식 검색 → 재시도 (최대 5회)
209
+ 4. APPROVAL GATE: /weave approve-plan
210
+ - craft/task 실행 필수 승인
209
211
 
210
- 5. APPROVE: /weave approve
211
- - (기본) verify 실행 Phase를 completed로 변경
212
+ 5. CRAFT: /weave craft
213
+ - Phase 실행 계획(execution plan) 생성 (tasks + 추천 마스크/에이전트 티어)
212
214
 
213
- 6. HANDOFF: 유저가 UX/의도 확인 다음 Phase로 진행
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
223
  ```
215
224
 
216
225
  #### 다층 AI 검증 시스템
@@ -359,19 +368,22 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
359
368
  /weave flow docs/
360
369
  ```
361
370
 
362
- 한 번에 `prepare -> craft -> task auto`까지 실행합니다.
371
+ 한 번에 `prepare -> approve-plan gate -> craft -> task auto`까지 실행합니다.
363
372
 
364
- 수동 happy path (spec + plan 한 번에):
373
+ 수동 happy path (research + spec + plan 한 번에):
365
374
 
366
375
  ```bash
367
376
  /weave prepare docs/
377
+ /weave approve-plan
368
378
  ```
369
379
 
370
- 또는 spec과 plan을 분리해서 실행:
380
+ 또는 전체 파이프라인을 분리해서 실행:
371
381
 
372
382
  ```bash
383
+ /weave research docs/
373
384
  /weave spec docs/
374
385
  /weave design docs/
386
+ /weave approve-plan
375
387
  ```
376
388
 
377
389
  AI가 수행하는 작업:
@@ -397,7 +409,13 @@ AI 인사이트가 포함된 현대적 감정 일기 앱 구축
397
409
  이 계획이 괜찮으세요? 변경이 필요하면 말씀해주세요.
398
410
  ```
399
411
 
400
- ### 2단계: Phase 실행 계획 생성 (Craft)
412
+ ### 2단계: 계획 승인(필수)
413
+
414
+ ```bash
415
+ /weave approve-plan
416
+ ```
417
+
418
+ ### 3단계: Phase 실행 계획 생성 (Craft)
401
419
 
402
420
  승인 후 실행 시작:
403
421
 
@@ -407,7 +425,7 @@ AI 인사이트가 포함된 현대적 감정 일기 앱 구축
407
425
 
408
426
  `/weave craft`는 Phase를 실행하기 위한 실행 계획을 생성/표시합니다(phase 미지정 시 다음 phase 자동 선택). 이후 실제 진행/상태 업데이트는 `weave command=task ...` 루프로 굴립니다.
409
427
 
410
- ### 3단계: Task 루프
428
+ ### 4단계: Task 루프
411
429
 
412
430
  ```txt
413
431
  weave command=task phaseId="P1" taskAction=list
@@ -429,7 +447,7 @@ weave command=task phaseId="P1" taskAction=auto verify=true verifyMode="quick"
429
447
  weave command=flow
430
448
  ```
431
449
 
432
- ### 4단계: 검증 및 Phase 완료 처리
450
+ ### 5단계: 검증 및 Phase 완료 처리
433
451
 
434
452
  ```txt
435
453
  weave command=verify
@@ -455,7 +473,7 @@ weave command=approve
455
473
  - 수정: useEffect 의존성 배열 추가
456
474
  ```
457
475
 
458
- ### 5단계: 핸드오프 & 검증
476
+ ### 6단계: 핸드오프 & 검증
459
477
 
460
478
  모든 검증이 통과되면:
461
479
 
package/README.md CHANGED
@@ -191,8 +191,11 @@ 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 prepare [docs]` | (Manual path) Generate baseline spec + phase plan |
195
- | `/weave flow [docs]` | (Recommended) One-command path: prepare -> craft -> task auto |
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 |
196
+ | `/weave refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
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 |
196
199
  | `/weave spec [docs]` | Generate baseline spec only (optional) |
197
200
  | `/weave design [docs]` | Analyze requirements → Generate phase plan (`/weave plan` is an alias) |
198
201
  | `/weave craft [P#]` | Generate/run execution plan (auto-select next phase if omitted) |
@@ -212,24 +215,30 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
212
215
  0. INIT (once): /weave init
213
216
 
214
217
  1. ONE-COMMAND (recommended): /weave flow docs/
215
- - runs: prepare -> craft -> task auto
218
+ - runs: prepare -> approve-plan gate -> craft -> task auto
216
219
 
217
220
  (or manual path)
218
221
 
219
222
  2. PLAN (manual path): /weave prepare docs/
220
- - or: /weave spec docs/ → /weave design docs/
223
+ - or: /weave research docs/ → /weave spec docs/ → /weave design docs/
221
224
 
222
- 3. CRAFT: /weave craft
223
- - Generates an execution plan (tasks + suggested masks/agent tiers)
225
+ 3. REFINE (optional): /weave refine-plan
226
+ - apply annotation notes from tasks/plan-notes.md
224
227
 
225
- 4. TASK LOOP: /weave task ... (or /weave-task-auto)
226
- - PASS optional quick verify + optional atomic commit
227
- - FAIL → record error → search Global Knowledge → retry (max 5)
228
+ 4. APPROVAL GATE: /weave approve-plan
229
+ - required before craft/task execution
228
230
 
229
- 5. APPROVE: /weave approve
230
- - Runs verification (full by default) and marks the phase completed
231
+ 5. CRAFT: /weave craft
232
+ - Generates an execution plan (tasks + suggested masks/agent tiers)
231
233
 
232
- 6. HANDOFF: You validate UX/intent and move to next phase
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
242
  ```
234
243
 
235
244
  #### Multi-Layer AI Verification
@@ -378,19 +387,22 @@ Fastest path (one command):
378
387
  /weave flow docs/
379
388
  ```
380
389
 
381
- This runs `prepare -> craft -> task auto` in one shot.
390
+ This runs `prepare -> approve-plan gate -> craft -> task auto` in one shot.
382
391
 
383
- Manual happy path (spec + plan in one command):
392
+ Manual happy path (research + spec + plan in one command):
384
393
 
385
394
  ```bash
386
395
  /weave prepare docs/
396
+ /weave approve-plan
387
397
  ```
388
398
 
389
- Or run spec and plan separately:
399
+ Or run the full pipeline separately:
390
400
 
391
401
  ```bash
402
+ /weave research docs/
392
403
  /weave spec docs/
393
404
  /weave design docs/
405
+ /weave approve-plan
394
406
  ```
395
407
 
396
408
  The AI will:
@@ -416,7 +428,13 @@ Build a modern emotion diary app with AI-powered insights
416
428
  Is this plan okay? Let me know if changes are needed.
417
429
  ```
418
430
 
419
- ### Step 2: Craft a Phase (Auto-select if omitted)
431
+ ### Step 2: Approve the Plan (Required)
432
+
433
+ ```bash
434
+ /weave approve-plan
435
+ ```
436
+
437
+ ### Step 3: Craft a Phase (Auto-select if omitted)
420
438
 
421
439
  Start with the first phase:
422
440
 
@@ -426,7 +444,7 @@ Start with the first phase:
426
444
 
427
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.
428
446
 
429
- ### Step 3: Drive the Task Loop
447
+ ### Step 4: Drive the Task Loop
430
448
 
431
449
  ```txt
432
450
  weave command=task phaseId="P1" taskAction=list
@@ -448,7 +466,7 @@ You can also continue everything with one command:
448
466
  weave command=flow
449
467
  ```
450
468
 
451
- ### Step 4: Verify and Approve the Phase
469
+ ### Step 5: Verify and Approve the Phase
452
470
 
453
471
  ```txt
454
472
  weave command=verify
@@ -0,0 +1,57 @@
1
+ ---
2
+ description: 구현 전 계획 승인 게이트 통과
3
+ ---
4
+
5
+ # /weave-approve-plan - 계획 승인
6
+
7
+ ## 개요
8
+
9
+ `/weave-approve-plan`은 **구현 시작 전 필수 승인 단계**입니다.
10
+
11
+ - 현재 active plan을 승인 상태로 전환
12
+ - 기본적으로 `tasks/plan-notes.md` 지시문을 먼저 자동 반영(refine) 시도
13
+ - 변경이 반영되면 승인 단계는 일시 중단되고, 검토 후 다시 approve 실행
14
+ - 필요 시 plan 메모를 승인 코멘트로 함께 기록
15
+ - 승인 전에는 `weave craft`/`weave flow`/`weave task auto`가 차단됩니다
16
+
17
+ ---
18
+
19
+ ## 사용법
20
+
21
+ ```txt
22
+ /weave-approve-plan
23
+ ```
24
+
25
+ 짧은 리뷰 코멘트를 함께 남기려면:
26
+
27
+ ```txt
28
+ weave command=approve-plan planReview="API signature는 변경하지 않는다"
29
+ ```
30
+
31
+ 자동 note 반영을 끄고 바로 승인하려면:
32
+
33
+ ```txt
34
+ weave command=approve-plan applyNotes=false
35
+ ```
36
+
37
+ ---
38
+
39
+ ## 내부 호출
40
+
41
+ ```txt
42
+ weave command=approve-plan
43
+ ```
44
+
45
+ ---
46
+
47
+ ## 다음 단계
48
+
49
+ ```txt
50
+ weave command=craft
51
+ ```
52
+
53
+ 또는 원커맨드로 이어서 진행:
54
+
55
+ ```txt
56
+ weave command=flow
57
+ ```
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: 원커맨드 실행 (prepare -> craft -> task auto)
2
+ description: 원커맨드 실행 (prepare -> approve-plan gate -> craft -> task auto)
3
3
  ---
4
4
 
5
5
  # /weave-flow - 원커맨드 실행
@@ -8,11 +8,17 @@ description: 원커맨드 실행 (prepare -> craft -> task auto)
8
8
 
9
9
  `/weave-flow`는 Weave의 기본 경로를 한 번에 실행합니다.
10
10
 
11
- - `prepare` (필요 시): spec + plan 생성
11
+ - `prepare` (필요 시): research + spec + plan 생성
12
+ - `refine-plan` (선택): `tasks/plan-notes.md` 지시문 반영
13
+ - `plan gate`: 실행 전 계획 품질 점검 (task 분해/테스트/검증 커버리지)
14
+ - `approval gate`: `approve-plan` 전에는 구현 단계로 내려가지 않음
12
15
  - `craft`: 실행 대상 phase 준비
13
16
  - `task auto`: 현재 task 자동 루프 진입
17
+ - `task auto` 내 반복 실패 시 re-plan 서브태스크 자동 생성
18
+ - (옵션) `approve`: 모든 task가 끝나면 full verify + phase approve
14
19
 
15
- > 목표: 유저가 명령을 여러 번 기억하지 않고, 한 번의 호출로 바로 실행 흐름에 진입하도록 합니다.
20
+ > 목표: 유저가 명령을 여러 번 기억하지 않고, 한 번의 호출로 실행 흐름에 진입하되,
21
+ > 구현 전 승인 게이트는 반드시 지키도록 합니다.
16
22
 
17
23
  ---
18
24
 
@@ -44,6 +50,24 @@ weave command=flow
44
50
 
45
51
  기본 검증 모드는 quick입니다(`verifyMode="quick"`).
46
52
 
53
+ > 참고: plan이 아직 승인되지 않았다면 flow는 approval gate에서 멈추고
54
+ > `weave command=approve-plan` 실행을 안내합니다.
55
+
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
+ ## 산출물
67
+
68
+ - `tasks/todo.md`: 현재 plan/phase/task 체크리스트 + 최근 리뷰
69
+ - `tasks/lessons.md`: 실패 패턴과 재발 방지 규칙 기록
70
+
47
71
  ---
48
72
 
49
73
  ## 다음 단계
@@ -42,9 +42,12 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
42
42
  | 명령어 | 설명 |
43
43
  |--------|------|
44
44
  | `/weave-init` | Weave 초기화 (프로젝트당 1회) |
45
+ | `/weave-research [docs]` | 문서를 깊게 읽고 `tasks/research.md` 생성 |
45
46
  | `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
46
- | `/weave-prepare [docs]` | **spec + plan을 한 번에 생성** (vNext 기본 경로) |
47
- | `/weave-flow [docs]` | **원커맨드** prepare craft task auto 실행 |
47
+ | `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (vNext 기본 경로) |
48
+ | `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
49
+ | `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
50
+ | `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft → task auto |
48
51
  | `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성) |
49
52
  | `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
50
53
  | `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 (id 생략 시 다음 Phase 자동 선택) |
@@ -64,9 +67,13 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
64
67
  ```
65
68
  /weave-init ← 프로젝트 초기화 (1회)
66
69
 
67
- /weave-flow docs/ ← (원커맨드) prepare→craft→task auto
70
+ /weave-flow docs/ ← (원커맨드) prepare→approve-plan gate→craft→task auto
68
71
 
69
- /weave-prepare docs/ ← (수동 경로) spec+plan 한 번에 생성
72
+ /weave-prepare docs/ ← (수동 경로) research+spec+plan 한 번에 생성
73
+
74
+ /weave-refine-plan ← (선택) plan-notes 기반 자동 정제
75
+
76
+ /weave-approve-plan ← 구현 전 계획 승인 (필수)
70
77
 
71
78
  /weave-craft ← 다음 Phase 자동 선택 실행
72
79
  /weave-task-auto ← 현재 task 반자동 루프
@@ -140,9 +147,10 @@ Phase 실행 시 자동 검증:
140
147
  # 2. (추천) spec + plan을 한 번에 생성
141
148
  /weave-prepare wiki/
142
149
 
143
- # 3. 피드백 승인
144
- "좋아, 진행해"
145
-
150
+ # 3. 계획 검토 승인 게이트 통과
151
+ /weave-refine-plan # (선택) notes 반영
152
+ /weave-approve-plan
153
+
146
154
  # 4. 다음 Phase 자동 선택 실행
147
155
  /weave-craft
148
156
 
@@ -1,22 +1,23 @@
1
1
  ---
2
- description: spec + plan을 한 번에 생성 (vNext 기본 경로)
2
+ description: research + spec + plan을 한 번에 생성 (vNext 기본 경로)
3
3
  ---
4
4
 
5
5
  # /weave-prepare - spec + plan 통합
6
6
 
7
7
  ## 개요
8
8
 
9
- `/weave-spec`와 `/weave-design`을 **한 번에** 이어서 수행합니다.
9
+ `/weave-research` + `/weave-spec` + `/weave-design`을 **한 번에** 이어서 수행합니다.
10
10
 
11
+ - 문서를 깊게 읽어 **research.md** 아티팩트를 생성합니다
11
12
  - 문서에서 요구사항을 추출해 **baseline spec**을 생성합니다
12
13
  - 같은 입력으로 Phase 기반 **plan**을 생성합니다
13
- - 마지막에 다음 실행 명령(`weave craft P1`)까지 안내합니다
14
+ - 마지막에 승인 단계(`weave approve-plan`) 안내합니다
14
15
 
15
16
  > 목적: 작은 기능마다 spec/plan을 두 번 돌리는 마찰을 줄이고,
16
- > "바로 craft로 수 있는" 기본 경로(happy path)를 제공합니다.
17
+ > "리서치-계획-승인"을 빠르게 통과할 수 있는 기본 경로(happy path)를 제공합니다.
17
18
 
18
19
  > 더 단순한 원커맨드가 필요하면 `/weave-flow [docs]`를 사용하세요
19
- > (`prepare -> craft -> task auto`를 한 번에 실행).
20
+ > (`prepare -> approve-plan gate -> craft -> task auto`를 한 번에 실행).
20
21
 
21
22
  ---
22
23
 
@@ -49,6 +50,7 @@ weave command=prepare docsPath="$ARGUMENTS" projectName="My Project" planName="e
49
50
 
50
51
  ## 생성되는 산출물(기본)
51
52
 
53
+ - Research: `tasks/research.md`
52
54
  - Spec: `.opencode/weave/specs/{planName}.yaml`
53
55
  - Plan: `.opencode/weave/plans/{planName}.yaml` (weave-init 기반 멀티플랜 모드)
54
56
 
@@ -61,5 +63,7 @@ weave command=prepare docsPath="$ARGUMENTS" projectName="My Project" planName="e
61
63
  준비가 끝나면:
62
64
 
63
65
  ```txt
66
+ weave command=refine-plan # (선택) plan-notes 반영
67
+ weave command=approve-plan
64
68
  weave craft P1
65
69
  ```
@@ -0,0 +1,60 @@
1
+ ---
2
+ description: plan-notes 지시문을 active plan에 자동 반영
3
+ ---
4
+
5
+ # /weave-refine-plan - 계획 정제(Annotation Cycle)
6
+
7
+ ## 개요
8
+
9
+ `/weave-refine-plan`은 `tasks/plan-notes.md`의 지시문을 읽어서 active plan YAML에 자동 반영합니다.
10
+
11
+ - 구현 전에 계획을 여러 번 정제하는 annotation cycle용
12
+ - 반영이 일어나면 plan 승인 상태를 자동으로 해제
13
+ - 반영 후에는 `weave approve-plan`을 다시 실행해야 구현 가능
14
+
15
+ ---
16
+
17
+ ## 기본 사용법
18
+
19
+ ```txt
20
+ /weave-refine-plan
21
+ ```
22
+
23
+ 내부 호출:
24
+
25
+ ```txt
26
+ weave command=refine-plan
27
+ ```
28
+
29
+ 노트 파일 경로를 바꾸려면:
30
+
31
+ ```txt
32
+ weave command=refine-plan notesPath="tasks/my-plan-notes.md"
33
+ ```
34
+
35
+ ---
36
+
37
+ ## 노트 문법 (예시)
38
+
39
+ `tasks/plan-notes.md`에 아래처럼 작성:
40
+
41
+ ```txt
42
+ @plan vision: 로그인 이후 대시보드 흐름을 단순화한다
43
+ @arch frontend: React + Vite + TanStack Query
44
+
45
+ @phase P1 done_when: 유저가 이메일/비밀번호로 로그인할 수 있다
46
+ @phase P1 add_task: 로그인 API 구현 | test=로그인 성공 시 200 반환 | retries=2
47
+ @phase P1 add_checklist: 로그인 실패 메시지가 명확히 보인다
48
+
49
+ @phase add P4: 운영 모니터링 | done=로그/메트릭 대시보드가 동작한다 | hours=3
50
+ @phase remove P7
51
+ ```
52
+
53
+ ---
54
+
55
+ ## 다음 단계
56
+
57
+ ```txt
58
+ weave command=approve-plan
59
+ weave command=craft
60
+ ```
@@ -0,0 +1,49 @@
1
+ ---
2
+ description: 문서를 깊게 읽고 research.md 생성
3
+ ---
4
+
5
+ # /weave-research - 리서치 아티팩트 생성
6
+
7
+ ## 개요
8
+
9
+ `/weave-research`는 요구사항 문서를 먼저 깊게 분석하고, 리뷰 가능한 리서치 문서를 생성합니다.
10
+
11
+ - 입력 문서를 분석해 핵심 기능/기술 신호를 추출
12
+ - 열려 있는 질문과 환경 리스크를 정리
13
+ - `tasks/research.md`에 영속 아티팩트로 저장
14
+
15
+ > 구현 전에 리서치를 먼저 고정해두면, 이후 plan 품질과 수정 비용이 크게 줄어듭니다.
16
+
17
+ ---
18
+
19
+ ## 사용법
20
+
21
+ ```txt
22
+ /weave-research $ARGUMENTS
23
+ ```
24
+
25
+ `$ARGUMENTS`는 문서 경로입니다.
26
+
27
+ 예시:
28
+ - `/weave-research docs/`
29
+ - `/weave-research wiki/spec.md`
30
+
31
+ ---
32
+
33
+ ## 내부 호출
34
+
35
+ ```txt
36
+ weave command=research docsPath="$ARGUMENTS"
37
+ ```
38
+
39
+ ---
40
+
41
+ ## 다음 단계
42
+
43
+ 리서치 완료 후 권장 순서:
44
+
45
+ ```txt
46
+ weave command=prepare docsPath="$ARGUMENTS"
47
+ weave command=approve-plan
48
+ weave command=craft
49
+ ```
@@ -5,6 +5,8 @@ description: Task 루프 자동 실행 (phase/task 인자 최소화)
5
5
  # /weave-task-auto - Task 자동 루프
6
6
 
7
7
  > 처음부터 한 번에 실행하려면 `/weave-flow [docs]`를 사용하세요.
8
+ >
9
+ > active plan이 승인되지 않았다면 먼저 `/weave-approve-plan`을 실행해야 합니다.
8
10
 
9
11
  ## 사용법
10
12
 
@@ -14,6 +14,9 @@ Weave phase의 task 상태를 업데이트합니다.
14
14
 
15
15
  이 커맨드는 `weave craft`가 만든 실행 계획을 "실제로 굴리는" 루프용입니다.
16
16
 
17
+ > 참고: active plan이 승인되지 않았다면(`weave approve-plan` 미실행)
18
+ > `start/pass/retry/auto` 액션은 차단됩니다.
19
+
17
20
  ---
18
21
 
19
22
  ## 기본 사용 패턴
@@ -40,6 +43,9 @@ weave command=task phaseId="P1" taskAction=auto verify=true verifyMode="quick"
40
43
  - 시작 직후에는 구현 대기 상태로 멈춥니다(코드 수정/에이전트 위임 후 재실행).
41
44
  - in_progress task에서는 quick verify를 실행하고 통과 시 pass 처리합니다.
42
45
  - 검증 실패/커밋 실패/변경 없음이면 해당 task에서 멈추고 다음 액션을 안내합니다.
46
+ - 같은 task 실패가 누적되면(retry 임계치) 자동으로 **re-plan 서브태스크를 생성**하고 루프를 이어갑니다.
47
+ - 상태 변화가 있을 때 `tasks/todo.md`를 동기화합니다.
48
+ - 실패 패턴은 `tasks/lessons.md`에 규칙으로 기록합니다.
43
49
 
44
50
  ### 3) 시작
45
51
 
@@ -1 +1 @@
1
- {"version":3,"file":"slashcommand.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/slashcommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkPxB,wBAAgB,sBAAsB;;;;;oBAkBpB;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,WAChB;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;EAiExC"}
1
+ {"version":3,"file":"slashcommand.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/slashcommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsSxB,wBAAgB,sBAAsB;;;;;oBAsBpB;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,WAChB;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;EAiExC"}