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.
- package/README.ko.md +37 -19
- package/README.md +36 -18
- package/assets/commands/weave-approve-plan.md +57 -0
- package/assets/commands/weave-flow.md +27 -3
- package/assets/commands/weave-help.md +15 -7
- package/assets/commands/weave-prepare.md +9 -5
- package/assets/commands/weave-refine-plan.md +60 -0
- package/assets/commands/weave-research.md +49 -0
- package/assets/commands/weave-task-auto.md +2 -0
- package/assets/commands/weave-task.md +6 -0
- package/dist/plugin/tools/slashcommand.d.ts.map +1 -1
- package/dist/plugin/tools/slashcommand.js +65 -9
- package/dist/plugin/tools/slashcommand.js.map +1 -1
- package/dist/plugin/tools/weave.d.ts +12 -1
- package/dist/plugin/tools/weave.d.ts.map +1 -1
- package/dist/plugin/tools/weave.js +796 -45
- package/dist/plugin/tools/weave.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/dist/weave/index.d.ts +2 -0
- package/dist/weave/index.d.ts.map +1 -1
- package/dist/weave/index.js +2 -0
- package/dist/weave/index.js.map +1 -1
- package/dist/weave/phase-manager.d.ts.map +1 -1
- package/dist/weave/phase-manager.js +44 -2
- package/dist/weave/phase-manager.js.map +1 -1
- package/dist/weave/stages/index.d.ts +4 -0
- package/dist/weave/stages/index.d.ts.map +1 -1
- package/dist/weave/stages/index.js +2 -0
- package/dist/weave/stages/index.js.map +1 -1
- package/dist/weave/stages/refine.d.ts +17 -0
- package/dist/weave/stages/refine.d.ts.map +1 -0
- package/dist/weave/stages/refine.js +369 -0
- package/dist/weave/stages/refine.js.map +1 -0
- package/dist/weave/stages/research.d.ts +22 -0
- package/dist/weave/stages/research.d.ts.map +1 -0
- package/dist/weave/stages/research.js +108 -0
- package/dist/weave/stages/research.js.map +1 -0
- package/dist/weave/types.d.ts +7 -0
- package/dist/weave/types.d.ts.map +1 -1
- 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
|
|
176
|
-
| `/weave
|
|
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
|
-
|
|
199
|
+
- 실행: prepare -> approve-plan gate -> craft -> task auto
|
|
197
200
|
↓
|
|
198
201
|
(또는 수동 경로)
|
|
199
202
|
↓
|
|
200
203
|
2. PLAN (수동): /weave prepare docs/
|
|
201
|
-
|
|
204
|
+
- 또는: /weave research docs/ → /weave spec docs/ → /weave design docs/
|
|
202
205
|
↓
|
|
203
|
-
3.
|
|
204
|
-
|
|
206
|
+
3. REFINE (선택): /weave refine-plan
|
|
207
|
+
- tasks/plan-notes.md 기반 계획 정제
|
|
205
208
|
↓
|
|
206
|
-
4.
|
|
207
|
-
|
|
208
|
-
- FAIL → 에러 기록 → 글로벌 지식 검색 → 재시도 (최대 5회)
|
|
209
|
+
4. APPROVAL GATE: /weave approve-plan
|
|
210
|
+
- craft/task 실행 전 필수 승인
|
|
209
211
|
↓
|
|
210
|
-
5.
|
|
211
|
-
|
|
212
|
+
5. CRAFT: /weave craft
|
|
213
|
+
- Phase 실행 계획(execution plan) 생성 (tasks + 추천 마스크/에이전트 티어)
|
|
212
214
|
↓
|
|
213
|
-
6.
|
|
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
|
-
또는
|
|
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단계:
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
|
195
|
-
| `/weave
|
|
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
|
-
|
|
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
|
-
|
|
223
|
+
- or: /weave research docs/ → /weave spec docs/ → /weave design docs/
|
|
221
224
|
↓
|
|
222
|
-
3.
|
|
223
|
-
-
|
|
225
|
+
3. REFINE (optional): /weave refine-plan
|
|
226
|
+
- apply annotation notes from tasks/plan-notes.md
|
|
224
227
|
↓
|
|
225
|
-
4.
|
|
226
|
-
-
|
|
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.
|
|
230
|
-
|
|
231
|
+
5. CRAFT: /weave craft
|
|
232
|
+
- Generates an execution plan (tasks + suggested masks/agent tiers)
|
|
231
233
|
↓
|
|
232
|
-
6.
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
9
|
+
`/weave-research` + `/weave-spec` + `/weave-design`을 **한 번에** 이어서 수행합니다.
|
|
10
10
|
|
|
11
|
+
- 문서를 깊게 읽어 **research.md** 아티팩트를 생성합니다
|
|
11
12
|
- 문서에서 요구사항을 추출해 **baseline spec**을 생성합니다
|
|
12
13
|
- 같은 입력으로 Phase 기반 **plan**을 생성합니다
|
|
13
|
-
- 마지막에
|
|
14
|
+
- 마지막에 승인 단계(`weave approve-plan`)를 안내합니다
|
|
14
15
|
|
|
15
16
|
> 목적: 작은 기능마다 spec/plan을 두 번 돌리는 마찰을 줄이고,
|
|
16
|
-
> "
|
|
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
|
+
```
|
|
@@ -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;
|
|
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"}
|