maskweaver 0.8.6 → 0.8.7

package/assets/commands/weave-approve-plan.md

@@ -1,57 +1,57 @@
----
-description: 구현 전 계획 승인 게이트 통과
----
-
-# /weave-approve-plan - 계획 승인
-
-## 개요
-
-`/weave-approve-plan`은 **구현 시작 전 필수 승인 단계**입니다.
-
-- 현재 active plan을 승인 상태로 전환
-- 기본적으로 `tasks/plan-notes.md` 지시문을 먼저 자동 반영(refine) 시도
-  - 변경이 반영되면 승인 단계는 일시 중단되고, 검토 후 다시 approve 실행
-- 필요 시 plan 메모를 승인 코멘트로 함께 기록
-- 승인 전에는 `weave craft`/`weave flow` 실행이 차단됩니다
-
----
-
-## 사용법
-
-```txt
-/weave-approve-plan
-```
-
-짧은 리뷰 코멘트를 함께 남기려면:
-
-```txt
-weave command=approve-plan planReview="API signature는 변경하지 않는다"
-```
-
-자동 note 반영을 끄고 바로 승인하려면:
-
-```txt
-weave command=approve-plan applyNotes=false
-```
-
----
-
-## 내부 호출
-
-```txt
-weave command=approve-plan
-```
-
----
-
-## 다음 단계
-
-```txt
-weave command=craft
-```
-
-또는 원커맨드로 이어서 진행:
-
-```txt
-weave command=flow
-```
+---
+description: 구현 전 계획 승인 게이트 통과
+---
+
+# /weave-approve-plan - 계획 승인
+
+## 개요
+
+`/weave-approve-plan`은 **구현 시작 전 필수 승인 단계**입니다.
+
+- 현재 active plan을 승인 상태로 전환
+- 기본적으로 `tasks/plan-notes.md` 지시문을 먼저 자동 반영(refine) 시도
+  - 변경이 반영되면 승인 단계는 일시 중단되고, 검토 후 다시 approve 실행
+- 필요 시 plan 메모를 승인 코멘트로 함께 기록
+- 승인 전에는 `weave craft`/`weave flow` 실행이 차단됩니다
+
+---
+
+## 사용법
+
+```txt
+/weave-approve-plan
+```
+
+짧은 리뷰 코멘트를 함께 남기려면:
+
+```txt
+weave command=approve-plan planReview="API signature는 변경하지 않는다"
+```
+
+자동 note 반영을 끄고 바로 승인하려면:
+
+```txt
+weave command=approve-plan applyNotes=false
+```
+
+---
+
+## 내부 호출
+
+```txt
+weave command=approve-plan
+```
+
+---
+
+## 다음 단계
+
+```txt
+weave command=craft
+```
+
+또는 원커맨드로 이어서 진행:
+
+```txt
+weave command=flow
+```

package/assets/commands/weave-craft.md

@@ -1,43 +1,43 @@
----
-description: Phase 실행 준비 (실행 컨텍스트 생성)
----
-
-# /weave-craft - Phase 실행 준비
-
-## 개요
-
-`/weave-craft`는 활성 플랜의 Phase를 실행 가능한 상태로 준비합니다.
-
-- 대상 phase 자동 선택(또는 직접 지정)
-- phase 상태/실행 계획 로드
-- 구현에 필요한 다음 액션 안내
-
-> 이 명령은 과거 자동 루프를 돌리지 않습니다.
-
-## 사용법
-
-```txt
-/weave-craft $ARGUMENTS
-```
-
-- `$ARGUMENTS` = 선택적 Phase ID (`P1`, `P2` 등)
-
-예시:
-
-```txt
-/weave-craft
-/weave-craft P1
-```
-
-## 내부 호출
-
-```txt
-weave command=craft phaseId="$ARGUMENTS"
-```
-
-## 권장 흐름
-
-1. `weave command=craft`로 phase 실행 컨텍스트 준비
-2. 코드 구현/위임 수행
-3. `weave command=verify`로 검증
-4. `weave command=approve-plan`으로 phase 확정
+---
+description: Phase 실행 준비 (실행 컨텍스트 생성)
+---
+
+# /weave-craft - Phase 실행 준비
+
+## 개요
+
+`/weave-craft`는 활성 플랜의 Phase를 실행 가능한 상태로 준비합니다.
+
+- 대상 phase 자동 선택(또는 직접 지정)
+- phase 상태/실행 계획 로드
+- 구현에 필요한 다음 액션 안내
+
+> 이 명령은 과거 자동 루프를 돌리지 않습니다.
+
+## 사용법
+
+```txt
+/weave-craft $ARGUMENTS
+```
+
+- `$ARGUMENTS` = 선택적 Phase ID (`P1`, `P2` 등)
+
+예시:
+
+```txt
+/weave-craft
+/weave-craft P1
+```
+
+## 내부 호출
+
+```txt
+weave command=craft phaseId="$ARGUMENTS"
+```
+
+## 권장 흐름
+
+1. `weave command=craft`로 phase 실행 컨텍스트 준비
+2. 코드 구현/위임 수행
+3. `weave command=verify`로 검증
+4. `weave command=approve-plan`으로 phase 확정

package/assets/commands/weave-design.md

@@ -6,11 +6,11 @@ description: 요구사항 분석 및 Phase 계획 수립 (멀티 플랜)
 
 ## 개요
 
-유저의 요구사항 문서를 분석하고, Phase별 실행 계획을 수립합니다.
-**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
-
-큰 계획(phase/시간 규모가 큰 경우)은 자동으로 여러 shard plan 파일로 분할되며,
-각 shard는 독립적으로 세부 설계(task/checklist)를 갖습니다.
+유저의 요구사항 문서를 분석하고, Phase별 실행 계획을 수립합니다.
+**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
+
+큰 계획(phase/시간 규모가 큰 경우)은 자동으로 여러 shard plan 파일로 분할되며,
+각 shard는 독립적으로 세부 설계(task/checklist)를 갖습니다.
 
 **입력 방식**: 
 - 정확한 경로: `docs/`, `wiki/spec.md`
@@ -193,65 +193,65 @@ Mask Weaver:
 
 ---
 
-### Step 5: APPROVE
-
-**플랜 파일 생성**: `.opencode/weave/plans/{plan-name}.yaml`
-
-> ⚠️ **YAML 작성 규칙 (반드시 준수)**
->
-> `done_when`, `vision` 등 **긴 문자열 값**은 반드시 아래 규칙을 따릅니다:
->
-> | 상황 | 사용할 표기법 | 예시 |
-> |------|-------------|------|
-> | 한 줄로 끝나는 짧은 값 | double-quote (`"`) | `done_when: "로그인 기능 동작"` |
-> | 여러 줄 또는 긴 값 | block scalar (`\|`) | 아래 예시 참고 |
-> | ❌ 절대 금지 | 여러 줄에 걸친 double-quote | `done_when: "1단계...\n2단계..."` |
->
-> ```yaml
-> # ✅ 올바른 예시 - 짧은 값
-> done_when: "유저가 감정을 선택할 수 있다"
->
-> # ✅ 올바른 예시 - 긴 값 (block scalar)
-> done_when: |
->   1. 유저가 감정을 선택할 수 있다
->   2. 선택한 감정이 저장된다
->   3. 저장 확인 메시지가 표시된다
->
-> # ❌ 잘못된 예시 - 닫는 따옴표가 다른 줄에 있음 (YAML 파싱 실패!)
-> done_when: "1. 유저가 감정을 선택할 수 있다
->   2. 선택한 감정이 저장된다
->   3. 저장 확인 메시지가 표시된다"
-> ```
->
-> **핵심 원칙**: `"` 로 시작했으면 **같은 줄에서** `"` 로 닫아야 합니다. 줄바꿈이 필요하면 `|` 를 사용하세요.
-
-```yaml
-plan_name: "emotion-diary"
-project_name: "감정 일기 앱"
-created_at: "2026-02-06"
-status: "active"     # active | paused | completed | archived
-
-vision: |
-  [전체 비전]
-
-architecture:
-  frontend: "[...]"
-  backend: "[...]"
-  database: "[...]"
-
-phases:
-  - id: "P1"
-    name: "[Phase 이름]"
-    status: "pending"    # pending | in_progress | completed
-    done_when: "[짧으면 한 줄 double-quote, 길면 | 블록 스칼라 사용]"
-    started_at: null
-    completed_at: null
-    masks_used: []
-    checklist:
-      - "[체크 항목 1]"
-      - "[체크 항목 2]"
-    tasks: []
-```
+### Step 5: APPROVE
+
+**플랜 파일 생성**: `.opencode/weave/plans/{plan-name}.yaml`
+
+> ⚠️ **YAML 작성 규칙 (반드시 준수)**
+>
+> `done_when`, `vision` 등 **긴 문자열 값**은 반드시 아래 규칙을 따릅니다:
+>
+> | 상황 | 사용할 표기법 | 예시 |
+> |------|-------------|------|
+> | 한 줄로 끝나는 짧은 값 | double-quote (`"`) | `done_when: "로그인 기능 동작"` |
+> | 여러 줄 또는 긴 값 | block scalar (`\|`) | 아래 예시 참고 |
+> | ❌ 절대 금지 | 여러 줄에 걸친 double-quote | `done_when: "1단계...\n2단계..."` |
+>
+> ```yaml
+> # ✅ 올바른 예시 - 짧은 값
+> done_when: "유저가 감정을 선택할 수 있다"
+>
+> # ✅ 올바른 예시 - 긴 값 (block scalar)
+> done_when: |
+>   1. 유저가 감정을 선택할 수 있다
+>   2. 선택한 감정이 저장된다
+>   3. 저장 확인 메시지가 표시된다
+>
+> # ❌ 잘못된 예시 - 닫는 따옴표가 다른 줄에 있음 (YAML 파싱 실패!)
+> done_when: "1. 유저가 감정을 선택할 수 있다
+>   2. 선택한 감정이 저장된다
+>   3. 저장 확인 메시지가 표시된다"
+> ```
+>
+> **핵심 원칙**: `"` 로 시작했으면 **같은 줄에서** `"` 로 닫아야 합니다. 줄바꿈이 필요하면 `|` 를 사용하세요.
+
+```yaml
+plan_name: "emotion-diary"
+project_name: "감정 일기 앱"
+created_at: "2026-02-06"
+status: "active"     # active | paused | completed | archived
+
+vision: |
+  [전체 비전]
+
+architecture:
+  frontend: "[...]"
+  backend: "[...]"
+  database: "[...]"
+
+phases:
+  - id: "P1"
+    name: "[Phase 이름]"
+    status: "pending"    # pending | in_progress | completed
+    done_when: "[짧으면 한 줄 double-quote, 길면 | 블록 스칼라 사용]"
+    started_at: null
+    completed_at: null
+    masks_used: []
+    checklist:
+      - "[체크 항목 1]"
+      - "[체크 항목 2]"
+    tasks: []
+```
 
 **state.yaml 업데이트**:
 

package/assets/commands/weave-flow.md

@@ -1,48 +1,48 @@
----
-description: 원커맨드 실행 (prepare -> auto-approve -> craft -> verify -> finalize)
----
-
-# /weave-flow - 원커맨드 실행
-
-## 개요
-
-`/weave-flow`는 Weave 기본 경로를 한 번에 실행합니다.
-
-- `prepare` (필요 시): research + spec + plan 생성
-- `refine-plan` (선택): `tasks/plan-notes.md` 지시문 반영
-- `plan gate`: 실행 전 계획 품질 점검 (구현/테스트/검증 커버리지, 실패 시 경고 후 계속 진행)
-- `auto-approve`: flow가 승인 단계를 자동 통과
-- `craft`: 실행 대상 phase의 실행 컨텍스트를 준비
-- `verify`: 기본 quick 검증 실행
-- `finalize`: 검증 통과 시 phase 완료 처리
-
-## 사용법
-
-```txt
-/weave-flow $ARGUMENTS
-```
-
-- 문서 경로를 넘기면 prepare부터 시작
-- 비우면 기존 active plan 재사용
-
-## 내부 호출
-
-```txt
-weave command=flow docsPath="$ARGUMENTS"
-```
-
-또는:
-
-```txt
-weave command=flow
-```
-
-## 산출물
-
-- `tasks/todo.md`: 현재 plan/phase 체크리스트 + 최근 리뷰
-- `tasks/lessons.md`: 실패 패턴과 재발 방지 규칙 기록
-
-## 다음 단계
-
-- 검증 실패 시 수정 후 `/weave-flow` 또는 `weave command=verify` 재실행
-- 진행 상황 확인: `weave command=status`
+---
+description: 원커맨드 실행 (prepare -> auto-approve -> craft -> verify -> finalize)
+---
+
+# /weave-flow - 원커맨드 실행
+
+## 개요
+
+`/weave-flow`는 Weave 기본 경로를 한 번에 실행합니다.
+
+- `prepare` (필요 시): research + spec + plan 생성
+- `refine-plan` (선택): `tasks/plan-notes.md` 지시문 반영
+- `plan gate`: 실행 전 계획 품질 점검 (구현/테스트/검증 커버리지, 실패 시 경고 후 계속 진행)
+- `auto-approve`: flow가 승인 단계를 자동 통과
+- `craft`: 실행 대상 phase의 실행 컨텍스트를 준비
+- `verify`: 기본 quick 검증 실행
+- `finalize`: 검증 통과 시 phase 완료 처리
+
+## 사용법
+
+```txt
+/weave-flow $ARGUMENTS
+```
+
+- 문서 경로를 넘기면 prepare부터 시작
+- 비우면 기존 active plan 재사용
+
+## 내부 호출
+
+```txt
+weave command=flow docsPath="$ARGUMENTS"
+```
+
+또는:
+
+```txt
+weave command=flow
+```
+
+## 산출물
+
+- `tasks/todo.md`: 현재 plan/phase 체크리스트 + 최근 리뷰
+- `tasks/lessons.md`: 실패 패턴과 재발 방지 규칙 기록
+
+## 다음 단계
+
+- 검증 실패 시 수정 후 `/weave-flow` 또는 `weave command=verify` 재실행
+- 진행 상황 확인: `weave command=status`

package/assets/commands/weave-help.md

@@ -1,31 +1,31 @@
----
-description: Weave 워크플로우 도움말
----
-
-# /weave-help - Weave 워크플로우 도움말
-
-## Weave란?
-
-Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
-"AI가 검증하고, 유저가 확인한다"
-
-**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
-
----
-
-## 버전 확인
-
-설치된 Maskweaver 버전을 확인하는 방법:
-
-| 방법 | 명령어 |
-|------|--------|
-| CLI | `maskweaver --version` 또는 `maskweaver -V` |
-| npm | `npm list maskweaver` |
-| 채팅 내 | `maskweaver_status` 도구 사용 |
-| Weave | `/weave help` |
-| Node.js | `import { VERSION } from 'maskweaver'` |
-
----
+---
+description: Weave 워크플로우 도움말
+---
+
+# /weave-help - Weave 워크플로우 도움말
+
+## Weave란?
+
+Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
+"AI가 검증하고, 유저가 확인한다"
+
+**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
+
+---
+
+## 버전 확인
+
+설치된 Maskweaver 버전을 확인하는 방법:
+
+| 방법 | 명령어 |
+|------|--------|
+| CLI | `maskweaver --version` 또는 `maskweaver -V` |
+| npm | `npm list maskweaver` |
+| 채팅 내 | `maskweaver_status` 도구 사용 |
+| Weave | `/weave help` |
+| Node.js | `import { VERSION } from 'maskweaver'` |
+
+---
 
 ## 핵심 철학
 
@@ -37,49 +37,49 @@ Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
 
 ---
 
-## 명령어 목록
-
-| 명령어 | 설명 |
-|--------|------|
-| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
-| `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
-| `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
-| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
-| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
-| `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
-| `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft |
-| `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성, 큰 계획은 자동 분할) |
-| `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
-| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
-| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
-| `/weave-switch [plan]` | 활성 플랜 전환 / 아카이브 |
-| `/weave-worktree` | git worktree 기반 병렬 작업(기능/Phase) 관리 |
-| `/weave-verify` | 빌드/테스트 검증 실행(프로젝트 유형 자동 감지) |
-| `/weave-help` | 이 도움말 |
+## 명령어 목록
+
+| 명령어 | 설명 |
+|--------|------|
+| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
+| `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
+| `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
+| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
+| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
+| `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
+| `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft |
+| `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성, 큰 계획은 자동 분할) |
+| `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
+| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
+| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
+| `/weave-switch [plan]` | 활성 플랜 전환 / 아카이브 |
+| `/weave-worktree` | git worktree 기반 병렬 작업(기능/Phase) 관리 |
+| `/weave-verify` | 빌드/테스트 검증 실행(프로젝트 유형 자동 감지) |
+| `/weave-help` | 이 도움말 |
 
 ---
 
-## 멀티 플랜 워크플로우
+## 멀티 플랜 워크플로우
 
 ```
-/weave-init                    ← 프로젝트 초기화 (1회)
-    ↓
-/weave-flow docs/              ← (원커맨드) prepare→approve-plan gate→craft
-    ↓
-/weave-prepare docs/           ← (수동 경로) research+spec+plan 한 번에 생성
-    ↓
-/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
-    ↓
-/weave-approve-plan            ← 구현 전 계획 승인 (필수)
-    ↓
-/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
-    ↓
-/weave-design wiki/new-feat    ← 두 번째 플랜 추가 (또는 prepare)
-    ↓
-/weave-switch first-plan       ← 첫 번째 플랜으로 돌아가기
-    ↓
-/weave-status                  ← 전체 상황 확인
-```
+/weave-init                    ← 프로젝트 초기화 (1회)
+    ↓
+/weave-flow docs/              ← (원커맨드) prepare→approve-plan gate→craft
+    ↓
+/weave-prepare docs/           ← (수동 경로) research+spec+plan 한 번에 생성
+    ↓
+/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
+    ↓
+/weave-approve-plan            ← 구현 전 계획 승인 (필수)
+    ↓
+/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
+    ↓
+/weave-design wiki/new-feat    ← 두 번째 플랜 추가 (또는 prepare)
+    ↓
+/weave-switch first-plan       ← 첫 번째 플랜으로 돌아가기
+    ↓
+/weave-status                  ← 전체 상황 확인
+```
 
 ### 플랜 상태 흐름
 
@@ -93,19 +93,19 @@ active ──→ paused ──→ active (switch로 전환)
 
 ---
 
-## 파일 구조
-
-```
-.opencode/weave/
-├── state.yaml           ← 활성 플랜 추적
-├── specs/
-│   ├── emotion-diary.yaml    ← baseline spec 1
-│   └── todo-app.yaml         ← baseline spec 2
-└── plans/
-    ├── emotion-diary.yaml   ← 플랜 1
-    ├── todo-app.yaml        ← 플랜 2
-    └── auth-module.yaml     ← 플랜 3
-```
+## 파일 구조
+
+```
+.opencode/weave/
+├── state.yaml           ← 활성 플랜 추적
+├── specs/
+│   ├── emotion-diary.yaml    ← baseline spec 1
+│   └── todo-app.yaml         ← baseline spec 2
+└── plans/
+    ├── emotion-diary.yaml   ← 플랜 1
+    ├── todo-app.yaml        ← 플랜 2
+    └── auth-module.yaml     ← 플랜 3
+```
 
 ---
 
@@ -134,25 +134,25 @@ Phase 실행 시 자동 검증:
 
 ---
 
-## 빠른 시작
-
-```bash
-# 1. 초기화 (프로젝트당 1회)
-/weave-init
-
-# 2. (추천) spec + plan을 한 번에 생성
-/weave-prepare wiki/
-
-# 3. 계획 검토 후 승인 게이트 통과
-/weave-refine-plan   # (선택) notes 반영
-/weave-approve-plan
-
-# 4. 다음 Phase 자동 선택 실행
-/weave-craft
-
-# 5. 새 기능 추가? 새 플랜!
-/weave-design docs/new-feature
-
-# 6. 플랜 사이 전환
-/weave-switch emotion-diary
-```
+## 빠른 시작
+
+```bash
+# 1. 초기화 (프로젝트당 1회)
+/weave-init
+
+# 2. (추천) spec + plan을 한 번에 생성
+/weave-prepare wiki/
+
+# 3. 계획 검토 후 승인 게이트 통과
+/weave-refine-plan   # (선택) notes 반영
+/weave-approve-plan
+
+# 4. 다음 Phase 자동 선택 실행
+/weave-craft
+
+# 5. 새 기능 추가? 새 플랜!
+/weave-design docs/new-feature
+
+# 6. 플랜 사이 전환
+/weave-switch emotion-diary
+```