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.
- package/README.ko.md +19 -36
- package/README.md +20 -37
- package/assets/commands/weave-approve-plan.md +1 -1
- package/assets/commands/weave-craft.md +6 -6
- package/assets/commands/weave-design.md +5 -2
- package/assets/commands/weave-flow.md +5 -16
- package/assets/commands/weave-help.md +9 -19
- package/assets/commands/weave-prepare.md +3 -3
- package/assets/commands/weave-research.md +4 -2
- package/dist/plugin/index.d.ts.map +1 -1
- package/dist/plugin/index.js +18 -0
- package/dist/plugin/index.js.map +1 -1
- package/dist/plugin/tools/slashcommand.d.ts.map +1 -1
- package/dist/plugin/tools/slashcommand.js +12 -11
- package/dist/plugin/tools/slashcommand.js.map +1 -1
- package/dist/plugin/tools/weave.d.ts +7 -17
- package/dist/plugin/tools/weave.d.ts.map +1 -1
- package/dist/plugin/tools/weave.js +264 -145
- package/dist/plugin/tools/weave.js.map +1 -1
- package/dist/weave/phase-manager.d.ts +5 -0
- package/dist/weave/phase-manager.d.ts.map +1 -1
- package/dist/weave/phase-manager.js +25 -0
- package/dist/weave/phase-manager.js.map +1 -1
- package/dist/weave/stages/execute.js +7 -7
- package/dist/weave/stages/execute.js.map +1 -1
- package/dist/weave/stages/plan.d.ts +8 -0
- package/dist/weave/stages/plan.d.ts.map +1 -1
- package/dist/weave/stages/plan.js +161 -2
- package/dist/weave/stages/plan.js.map +1 -1
- package/dist/weave/stages/research.d.ts.map +1 -1
- package/dist/weave/stages/research.js +431 -4
- package/dist/weave/stages/research.js.map +1 -1
- package/dist/weave/types.d.ts +6 -0
- package/dist/weave/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/assets/commands/wave-task-auto.md +0 -15
- package/assets/commands/weave-approve.md +0 -70
- package/assets/commands/weave-task-auto.md +0 -48
- 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]` |
|
|
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
|
|
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 실행 계획 생성/실행
|
|
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
|
|
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
|
|
207
|
+
- craft 실행 전 필수 승인
|
|
211
208
|
↓
|
|
212
209
|
5. CRAFT: /weave craft
|
|
213
|
-
- Phase 실행 계획
|
|
210
|
+
- Phase 실행 계획 생성 + 자동 task loop 실행
|
|
211
|
+
- PASS/FAIL/재시도/re-plan은 craft 루프에서 처리
|
|
212
|
+
- 마지막에 phase 목표 체크 + full verify + 완료 처리를 자동 수행
|
|
214
213
|
↓
|
|
215
|
-
6.
|
|
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
|
|
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`는
|
|
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=
|
|
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단계:
|
|
433
|
+
### 5단계: 자동 완료 처리
|
|
451
434
|
|
|
452
435
|
```txt
|
|
453
436
|
weave command=verify
|
|
454
|
-
weave command=
|
|
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
|
|
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`
|
|
201
|
-
| `/weave craft [P#]` | Generate/run execution plan
|
|
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
|
|
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
|
|
226
|
+
- required before craft execution
|
|
230
227
|
↓
|
|
231
228
|
5. CRAFT: /weave craft
|
|
232
|
-
- Generates an execution plan
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
|
|
439
|
+
### Step 4: Continue the Craft Loop
|
|
458
440
|
|
|
459
441
|
```txt
|
|
460
|
-
weave command=
|
|
442
|
+
weave command=craft phaseId="P1"
|
|
443
|
+
weave command=craft phaseId="P1" taskId="P1-T1"
|
|
461
444
|
```
|
|
462
445
|
|
|
463
|
-
|
|
446
|
+
One-command resume:
|
|
464
447
|
|
|
465
448
|
```txt
|
|
466
449
|
weave command=flow
|
|
467
450
|
```
|
|
468
451
|
|
|
469
|
-
### Step 5:
|
|
452
|
+
### Step 5: Auto Finalization
|
|
470
453
|
|
|
471
454
|
```txt
|
|
472
455
|
weave command=verify
|
|
473
|
-
weave command=
|
|
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
|
|
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
|
|
15
|
+
- 승인 전에는 `weave craft`/`weave flow` 실행이 차단됩니다
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Phase 실행 (Build + Self-Verify Loop
|
|
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부터
|
|
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
|
|
81
|
-
│ └─ 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
|
-
> 참고:
|
|
90
|
-
>
|
|
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
|
|
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
|
-
- `
|
|
17
|
-
- `
|
|
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가 끝나면
|
|
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]` |
|
|
45
|
+
| `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
|
|
46
46
|
| `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
|
|
47
|
-
| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (
|
|
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
|
|
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 실행
|
|
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
|
|
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.
|
|
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
|
-
#
|
|
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
|
|
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`
|
|
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:
|
|
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;
|
|
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"}
|
package/dist/plugin/index.js
CHANGED
|
@@ -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
|
}
|