maskweaver 0.8.6 → 0.8.8

package/README.ko.md

@@ -24,10 +24,10 @@
 - **전문가 페르소나 (Masks)**: 전설적인 개발자들의 철학을 담은 표준 YAML 프로필.
 - **스마트 위임**: OpenCode에 최적화된 멀티 에이전트 워크플로우.
 - **프로젝트 메모리**: 코드베이스 전체에 대한 하이브리드 의미론적 검색.
-- **🆕 Weave 워크플로우**: AI 자체 검증이 포함된 Phase 기반 개발.
-- **🔗 GDC 통합**: Graph-Driven Codebase 지원으로 리서치 품질 향상 및 설계 시점 검증 게이트 추가.
-
----
+- **🆕 Weave 워크플로우**: AI 자체 검증이 포함된 Phase 기반 개발.
+- **🔗 GDC 통합**: Graph-Driven Codebase 지원으로 리서치 품질 향상 및 설계 시점 검증 게이트 추가.
+
+---
 
 ## 왜 Maskweaver인가요?
 
@@ -59,59 +59,59 @@ npm install maskweaver
 bun add maskweaver
 ```
 
-### OpenCode 플러그인 설정
+### OpenCode 플러그인 설정
 
 OpenCode 설정에 추가하면 끝!
 
-**전역** (`~/.config/opencode/opencode.json`):
-```json
-{
-  "plugin": ["maskweaver"]
-}
-```
-
-**또는 프로젝트별** (프로젝트 루트의 `opencode.json`):
-```json
-{
-  "plugin": ["maskweaver"]
-}
-```
-
-> 참고: OpenCode는 npm 패키지를 이름으로 설치합니다. `maskweaver`를 사용하세요 (`maskweaver/plugin` 아님).
+**전역** (`~/.config/opencode/opencode.json`):
+```json
+{
+  "plugin": ["maskweaver"]
+}
+```
+
+**또는 프로젝트별** (프로젝트 루트의 `opencode.json`):
+```json
+{
+  "plugin": ["maskweaver"]
+}
+```
+
+> 참고: OpenCode는 npm 패키지를 이름으로 설치합니다. `maskweaver`를 사용하세요 (`maskweaver/plugin` 아님).
 
 OpenCode가 시작 시 자동으로 `~/.cache/opencode/node_modules/`에 플러그인을 설치합니다.
 
-**Windows:** `%USERPROFILE%\.config\opencode\opencode.json`
-
-### 완료 알림 소리 (선택)
-
-Maskweaver는 생성이 끝나서 세션이 idle 상태가 되면(`session.idle`) 알림 소리를 재생할 수 있습니다.
-
-`.opencode/maskweaver.json`(프로젝트) 또는 `~/.config/opencode/maskweaver.json`(전역)에 설정하세요:
-
-```jsonc
-{
-  "notifications": {
-    "completionSound": {
-      "enabled": true
-    }
-  }
-}
-```
-
-끄려면:
-
-```jsonc
-{
-  "notifications": {
-    "completionSound": {
-      "enabled": false
-    }
-  }
-}
-```
-
-### 설치된 버전 확인
+**Windows:** `%USERPROFILE%\.config\opencode\opencode.json`
+
+### 완료 알림 소리 (선택)
+
+Maskweaver는 생성이 끝나서 세션이 idle 상태가 되면(`session.idle`) 알림 소리를 재생할 수 있습니다.
+
+`.opencode/maskweaver.json`(프로젝트) 또는 `~/.config/opencode/maskweaver.json`(전역)에 설정하세요:
+
+```jsonc
+{
+  "notifications": {
+    "completionSound": {
+      "enabled": true
+    }
+  }
+}
+```
+
+끄려면:
+
+```jsonc
+{
+  "notifications": {
+    "completionSound": {
+      "enabled": false
+    }
+  }
+}
+```
+
+### 설치된 버전 확인
 
 Maskweaver 버전을 확인하는 여러 방법:
 
@@ -190,58 +190,58 @@ profile:
 | `@dummy-human` | 균형 | 💰💰 | 코드 작성, 리뷰, 일반 작업 |
 | `@dummy-premium` | 강력 | 💰💰💰 | 아키텍처, 복잡한 디버깅 |
 
-### 🧵 Weave 워크플로우
+### 🧵 Weave 워크플로우
 
 **Phase 기반 개발** — "AI가 검증하고, 유저가 확인한다"
 
-Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가능한 Phase로 나누고, 전문가 마스크를 자동 선택하며, 유저 전달 전 구조화된 검증 단계를 제공합니다.
-
-#### 명령어
-
-| 명령어 | 설명 |
-|--------|------|
-| `/weave init` | Weave 초기화 (프로젝트당 1회) |
-| `/weave research [docs]` | 문서 + 워크스페이스 맥락을 깊게 읽고 `tasks/research.md` 생성 |
-| `/weave prepare [docs]` | (수동 경로) research + baseline spec + phase plan 생성 (큰 계획은 자동 분할) |
-| `/weave refine-plan` | `tasks/plan-notes.md` 지시문을 active plan에 반영 |
-| `/weave approve-plan` | 구현 전 사람이 계획 승인(게이트) |
-| `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> auto-approve -> craft -> verify -> finalize |
-| `/weave spec [docs]` | baseline spec만 생성 (선택) |
-| `/weave design [docs]` | 요구사항 분석 → Phase 계획 생성 (`/weave plan`은 별칭/호환, 큰 계획은 자동 분할) |
-| `/weave craft [P#]` | Phase 실행 컨텍스트/가이드 생성 |
-| `/weave verify` | 빌드/테스트 검증 실행 (자동 감지) |
-| `/weave worktree ...` | git worktree 기반 병렬 작업 관리 |
-| `/weave status` | 프로젝트 진행 상황 및 통계 확인 |
-| `/weave help` | 도움말 표시 |
-
-> Tip: OpenCode 채팅에서는 `/weave ...` 형태로 실행하고, 내부적으로는 `weave command=...` 도구 호출로 매핑됩니다.
-
-#### 워크플로우
-
-```
-0. INIT (1회): /weave init
-       ↓
-1. 원커맨드(권장): /weave flow docs/
-    - 실행: prepare -> auto-approve -> craft -> verify -> finalize
-       ↓
-   (또는 수동 경로)
-       ↓
-2. PLAN (수동): /weave prepare docs/
-    - 또는: /weave research docs/ → /weave spec docs/ → /weave design docs/
-       ↓
-3. REFINE (선택): /weave refine-plan
-    - tasks/plan-notes.md 기반 계획 정제
-       ↓
-4. APPROVAL GATE: /weave approve-plan
-    - craft 실행 전 필수 승인
-       ↓
-5. CRAFT: /weave craft
-     - Phase 실행 계획과 다음 액션 안내 생성
-     - 구현/검증 후 approve-plan으로 phase 완료 처리
-     - `/weave verify`로 빌드/테스트 검증 가능
-       ↓
-6. HANDOFF: 유저가 UX/의도 확인 후 다음 Phase로 진행
-```
+Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가능한 Phase로 나누고, 전문가 마스크를 자동 선택하며, 유저 전달 전 구조화된 검증 단계를 제공합니다.
+
+#### 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `/weave init` | Weave 초기화 (프로젝트당 1회) |
+| `/weave research [docs]` | 문서 + 워크스페이스 맥락을 깊게 읽고 `tasks/research.md` 생성 |
+| `/weave prepare [docs]` | (수동 경로) research + baseline spec + phase plan 생성 (큰 계획은 자동 분할) |
+| `/weave refine-plan` | `tasks/plan-notes.md` 지시문을 active plan에 반영 |
+| `/weave approve-plan` | 구현 전 사람이 계획 승인(게이트) |
+| `/weave flow [docs]` | (권장) 원커맨드 경로: prepare -> auto-approve -> craft -> verify -> finalize |
+| `/weave spec [docs]` | baseline spec만 생성 (선택) |
+| `/weave design [docs]` | 요구사항 분석 → Phase 계획 생성 (`/weave plan`은 별칭/호환, 큰 계획은 자동 분할) |
+| `/weave craft [P#]` | Phase 실행 컨텍스트/가이드 생성 |
+| `/weave verify` | 빌드/테스트 검증 실행 (자동 감지) |
+| `/weave worktree ...` | git worktree 기반 병렬 작업 관리 |
+| `/weave status` | 프로젝트 진행 상황 및 통계 확인 |
+| `/weave help` | 도움말 표시 |
+
+> Tip: OpenCode 채팅에서는 `/weave ...` 형태로 실행하고, 내부적으로는 `weave command=...` 도구 호출로 매핑됩니다.
+
+#### 워크플로우
+
+```
+0. INIT (1회): /weave init
+       ↓
+1. 원커맨드(권장): /weave flow docs/
+    - 실행: prepare -> auto-approve -> craft -> verify -> finalize
+       ↓
+   (또는 수동 경로)
+       ↓
+2. PLAN (수동): /weave prepare docs/
+    - 또는: /weave research docs/ → /weave spec docs/ → /weave design docs/
+       ↓
+3. REFINE (선택): /weave refine-plan
+    - tasks/plan-notes.md 기반 계획 정제
+       ↓
+4. APPROVAL GATE: /weave approve-plan
+    - craft 실행 전 필수 승인
+       ↓
+5. CRAFT: /weave craft
+     - Phase 실행 계획과 다음 액션 안내 생성
+     - 구현/검증 후 approve-plan으로 phase 완료 처리
+     - `/weave verify`로 빌드/테스트 검증 가능
+       ↓
+6. HANDOFF: 유저가 UX/의도 확인 후 다음 Phase로 진행
+```
 
 #### 다층 AI 검증 시스템
 
@@ -256,43 +256,43 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
 | 5️⃣ E2E Tests | 테스트 | **Playwright** |
 | 6️⃣ Screenshot | 시각 | Playwright / 브라우저 캡처 |
 | 7️⃣ API Check | API | `fetch` 헬스 체크 |
-| 8️⃣ A11y | 접근성 | `axe-core` |
-| 0️⃣ GDC Check | 설계 | `gdc check --machine` |
-
-#### GDC 통합 (Graph-Driven Codebase)
-
-Weave는 [GDC](https://github.com/ulgerang/gdc)(Graph-Driven Codebase)와 통합되어 리서치 품질을 향상시키고 설계 시점 검증 게이트를 추가합니다:
-
-**리서치 강화:**
-- `.gdc` 워크스페이스 자동 감지
-- GDC `stats`, `graph`, `check` 결과를 `tasks/research.md`에 포함
-- 그래프 엣지 기반 의존성 영향 범위(Blast Radius) 분석
-- 기능 키워드와 매칭된 재사용 후보 노드
-- 새 보고서 섹션: `GDC Node Coverage`, `Dependency Blast Radius`, `Existing Spec vs Implementation Drift`, `Candidate Reuse Nodes`
-
-**Pre-Verify 게이트:**
-GDC가 감지되면 `weave verify`와 `weave flow`가 자동으로 실행:
-1. `gdc sync --machine` - 스펙과 구현 동기화
-2. `gdc check --machine` - 스펙/구현 일치성 검증
-
-GDC check의 블로킹 에러는 검증을 중단시킵니다(`strictVerify` 모드로 설정 가능).
-
-**설정** (`maskweaver.config.json`):
-```json
-{
-  "gdc": {
-    "enabled": "auto",
-    "strictVerify": false,
-    "autoSyncOnPrepare": true
-  }
-}
-```
-
-- `enabled`: `true` | `false` | `"auto"` (기본값: `.gdc` 디렉터리 자동 감지)
-- `strictVerify`: `true`면 GDC check 실패 시 검증 차단; `false`면 경고 후 계속 진행
-- `autoSyncOnPrepare`: `weave prepare` 시 `gdc sync` 실행
-
-#### 마스크 자동 선택
+| 8️⃣ A11y | 접근성 | `axe-core` |
+| 0️⃣ GDC Check | 설계 | `gdc check --machine` |
+
+#### GDC 통합 (Graph-Driven Codebase)
+
+Weave는 [GDC](https://github.com/ulgerang/gdc)(Graph-Driven Codebase)와 통합되어 리서치 품질을 향상시키고 설계 시점 검증 게이트를 추가합니다:
+
+**리서치 강화:**
+- `.gdc` 워크스페이스 자동 감지
+- GDC `stats`, `graph`, `check` 결과를 `tasks/research.md`에 포함
+- 그래프 엣지 기반 의존성 영향 범위(Blast Radius) 분석
+- 기능 키워드와 매칭된 재사용 후보 노드
+- 새 보고서 섹션: `GDC Node Coverage`, `Dependency Blast Radius`, `Existing Spec vs Implementation Drift`, `Candidate Reuse Nodes`
+
+**Pre-Verify 게이트:**
+GDC가 감지되면 `weave verify`와 `weave flow`가 자동으로 실행:
+1. `gdc sync --machine` - 스펙과 구현 동기화
+2. `gdc check --machine` - 스펙/구현 일치성 검증
+
+GDC check의 블로킹 에러는 검증을 중단시킵니다(`strictVerify` 모드로 설정 가능).
+
+**설정** (`maskweaver.config.json`):
+```json
+{
+  "gdc": {
+    "enabled": "auto",
+    "strictVerify": false,
+    "autoSyncOnPrepare": true
+  }
+}
+```
+
+- `enabled`: `true` | `false` | `"auto"` (기본값: `.gdc` 디렉터리 자동 감지)
+- `strictVerify`: `true`면 GDC check 실패 시 검증 차단; `false`면 경고 후 계속 진행
+- `autoSyncOnPrepare`: `weave prepare` 시 `gdc sync` 실행
+
+#### 마스크 자동 선택
 
 AI가 각 작업에 가장 적합한 전문가를 자동으로 선택합니다:
 
@@ -396,51 +396,51 @@ import { MaskLoader } from 'maskweaver/core';
 import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 ```
 
-**모듈:**
-- `maskweaver/core` - 가면 로딩, 검증 (YAML/JSON)
-- `maskweaver/memory` - 임베딩 + 벡터 검색 (5개 프로바이더)
-- `maskweaver/context` - 기능 기반 작업 추적
-- `maskweaver/verify` - 교차 가면 코드 리뷰
-- `maskweaver/retrospect` - 세션 효과 분석
-- `maskweaver/weave` - Phase 기반 개발 워크플로우
-- `maskweaver/gdc` - GDC(Graph-Driven Codebase) 통합 유틸리티
-- `maskweaver/plugin` - OpenCode 플러그인 엔트리 포인트
+**모듈:**
+- `maskweaver/core` - 가면 로딩, 검증 (YAML/JSON)
+- `maskweaver/memory` - 임베딩 + 벡터 검색 (5개 프로바이더)
+- `maskweaver/context` - 기능 기반 작업 추적
+- `maskweaver/verify` - 교차 가면 코드 리뷰
+- `maskweaver/retrospect` - 세션 효과 분석
+- `maskweaver/weave` - Phase 기반 개발 워크플로우
+- `maskweaver/gdc` - GDC(Graph-Driven Codebase) 통합 유틸리티
+- `maskweaver/plugin` - OpenCode 플러그인 엔트리 포인트
 
 ---
 
-## 🧵 Weave 사용 가이드
-
-### 0단계: 초기화 (프로젝트당 1회)
-
-```bash
-/weave init
-```
-
-### 1단계: 플랜 생성 (Flow 권장)
-
-가장 빠른 원커맨드 경로:
-
-```bash
-/weave flow docs/
-```
-
-한 번에 `prepare -> auto-approve -> craft -> verify -> finalize`까지 실행합니다.
-
-수동 happy path (research + spec + plan 한 번에):
-
-```bash
-/weave prepare docs/
-/weave approve-plan
-```
-
-또는 전체 파이프라인을 분리해서 실행:
-
-```bash
-/weave research docs/
-/weave spec docs/
-/weave design docs/
-/weave approve-plan
-```
+## 🧵 Weave 사용 가이드
+
+### 0단계: 초기화 (프로젝트당 1회)
+
+```bash
+/weave init
+```
+
+### 1단계: 플랜 생성 (Flow 권장)
+
+가장 빠른 원커맨드 경로:
+
+```bash
+/weave flow docs/
+```
+
+한 번에 `prepare -> auto-approve -> craft -> verify -> finalize`까지 실행합니다.
+
+수동 happy path (research + spec + plan 한 번에):
+
+```bash
+/weave prepare docs/
+/weave approve-plan
+```
+
+또는 전체 파이프라인을 분리해서 실행:
+
+```bash
+/weave research docs/
+/weave spec docs/
+/weave design docs/
+/weave approve-plan
+```
 
 AI가 수행하는 작업:
 1. 경로 내 모든 문서 읽기
@@ -465,43 +465,43 @@ AI 인사이트가 포함된 현대적 감정 일기 앱 구축
 이 계획이 괜찮으세요? 변경이 필요하면 말씀해주세요.
 ```
 
-### 2단계: 계획 승인(필수)
-
-```bash
-/weave approve-plan
-```
-
-### 3단계: Phase 실행 계획 생성 (Craft)
-
-승인 후 실행 시작:
-
-```bash
-/weave craft
-```
-
-`/weave craft`는 phase 실행 컨텍스트를 생성합니다(phase 미지정 시 다음 phase 자동 선택). 구현 반영 후 같은 명령으로 계획을 다시 확인할 수 있습니다.
-
-### 4단계: 구현 진행
-
-```txt
-weave command=craft phaseId="P1"
-weave command=verify
-```
-
-원커맨드로 이어서 진행하려면:
-
-```txt
-weave command=flow
-```
-
-### 5단계: Phase 완료 처리
-
-```txt
-weave command=verify
-weave command=approve-plan
-```
-
-### 6단계: 핸드오프 & 검증
+### 2단계: 계획 승인(필수)
+
+```bash
+/weave approve-plan
+```
+
+### 3단계: Phase 실행 계획 생성 (Craft)
+
+승인 후 실행 시작:
+
+```bash
+/weave craft
+```
+
+`/weave craft`는 phase 실행 컨텍스트를 생성합니다(phase 미지정 시 다음 phase 자동 선택). 구현 반영 후 같은 명령으로 계획을 다시 확인할 수 있습니다.
+
+### 4단계: 구현 진행
+
+```txt
+weave command=craft phaseId="P1"
+weave command=verify
+```
+
+원커맨드로 이어서 진행하려면:
+
+```txt
+weave command=flow
+```
+
+### 5단계: Phase 완료 처리
+
+```txt
+weave command=verify
+weave command=approve-plan
+```
+
+### 6단계: 핸드오프 & 검증
 
 모든 검증이 통과되면:
 
@@ -530,7 +530,7 @@ http://localhost:5173
 **[승인]** **[변경 요청]** **[나중에]**
 ```
 
-### 6단계: 언제든지 상태 확인
+### 6단계: 언제든지 상태 확인
 
 ```bash
 /weave status