maskweaver 0.8.5 → 0.8.7

package/assets/commands/weave-init.md

@@ -30,13 +30,13 @@ description: Weave 워크플로우 초기화 (프로젝트별 1회)
 
 만약 `.ignore` 파일이 이미 있다면, `!.opencode/weave/` 줄만 추가합니다 (중복 방지).
 
-### 2. 디렉토리 구조 생성
+### 2. 디렉토리 구조 생성
 
 ```bash
 mkdir -p .opencode/weave/plans
 ```
 
-### 3. `state.yaml` 초기화
+### 3. `state.yaml` 초기화
 
 `.opencode/weave/state.yaml` 파일을 생성합니다:
 
@@ -46,26 +46,26 @@ mkdir -p .opencode/weave/plans
 active_plan: null
 ```
 
-### 4. 기존 PLAN.yaml 마이그레이션 (해당 시)
+### 4. 기존 PLAN.yaml 마이그레이션 (해당 시)
 
 만약 `.opencode/weave/PLAN.yaml` (구버전 단일 플랜)이 존재하면:
-1. 기존 PLAN을 읽어 multi-plan 포맷으로 저장
-2. `state.yaml`의 `active_plan`을 해당 플랜으로 설정
-3. 기존 PLAN.yaml 삭제 (가능한 경우)
-
-### 5. GDC 연동 점검 및 그래프 동기화
-
-`weave init`은 GDC 연동 상태를 확인합니다.
-
-- `.gdc` 워크스페이스 미감지 시:
-  - 안내 메시지 출력 (`gdc init --language <lang>`)
-- 감지 + 연동 활성화 시:
-  - `gdc version --machine`
-  - `gdc sync --machine`
-  - `gdc check --machine`
-  - `gdc stats --machine`
-
-이 단계는 **정보 제공 및 부트스트랩 목적**이며, 실패해도 Weave 초기화 자체는 완료됩니다.
+1. 기존 PLAN을 읽어 multi-plan 포맷으로 저장
+2. `state.yaml`의 `active_plan`을 해당 플랜으로 설정
+3. 기존 PLAN.yaml 삭제 (가능한 경우)
+
+### 5. GDC 연동 점검 및 그래프 동기화
+
+`weave init`은 GDC 연동 상태를 확인합니다.
+
+- `.gdc` 워크스페이스 미감지 시:
+  - 안내 메시지 출력 (`gdc init --language <lang>`)
+- 감지 + 연동 활성화 시:
+  - `gdc version --machine`
+  - `gdc sync --machine`
+  - `gdc check --machine`
+  - `gdc stats --machine`
+
+이 단계는 **정보 제공 및 부트스트랩 목적**이며, 실패해도 Weave 초기화 자체는 완료됩니다.
 
 ---
 
@@ -79,9 +79,9 @@ active_plan: null
 - `.opencode/weave/state.yaml` — 플랜 상태 추적
 - `.opencode/weave/plans/` — 플랜 저장 디렉토리
 
-### 다음 단계
-프로젝트 계획을 세우려면:
-`weave command=prepare docsPath="docs/"`
+### 다음 단계
+프로젝트 계획을 세우려면:
+`weave command=prepare docsPath="docs/"`
 ```
 
 ---

package/assets/commands/weave-plan.md

@@ -1,15 +1,15 @@
----
-description: /weave-design의 별칭(호환용)
----
-
-# /weave-plan - /weave-design 별칭
-
-이 커맨드는 `/weave-design`과 동일합니다.
-
-```txt
-/weave-design [docs-path]
-```
-
-권장 사용:
-
-- 새 기본 경로: `/weave-prepare [docs-path]` → `weave craft P1`
+---
+description: /weave-design의 별칭(호환용)
+---
+
+# /weave-plan - /weave-design 별칭
+
+이 커맨드는 `/weave-design`과 동일합니다.
+
+```txt
+/weave-design [docs-path]
+```
+
+권장 사용:
+
+- 새 기본 경로: `/weave-prepare [docs-path]` → `weave craft P1`

package/assets/commands/weave-prepare.md

@@ -1,69 +1,69 @@
----
-description: research + spec + plan을 한 번에 생성 (vNext 기본 경로)
----
-
-# /weave-prepare - spec + plan 통합
-
-## 개요
-
-`/weave-research` + `/weave-spec` + `/weave-design`을 **한 번에** 이어서 수행합니다.
-
-- 문서를 깊게 읽어 **research.md** 아티팩트를 생성합니다
-- 문서에서 요구사항을 추출해 **baseline spec**을 생성합니다
-- 같은 입력으로 Phase 기반 **plan**을 생성합니다 (큰 계획은 shard plan 파일로 자동 분할)
-- 마지막에 승인 단계(`weave approve-plan`)를 안내합니다
-
-> 목적: 작은 기능마다 spec/plan을 두 번 돌리는 마찰을 줄이고,
-> "리서치-계획-승인"을 빠르게 통과할 수 있는 기본 경로(happy path)를 제공합니다.
-
-> 더 단순한 원커맨드가 필요하면 `/weave-flow [docs]`를 사용하세요
-> (`prepare -> auto-approve -> craft -> verify -> finalize`를 한 번에 실행).
-
----
-
-## 사용법
-
-**사용법**: `/weave-prepare $ARGUMENTS`
-- `$ARGUMENTS` = 문서 경로 (예: `docs/`, `wiki/spec.md`)
-
-예시:
-- `/weave-prepare docs/`
-- `/weave-prepare wiki/spec.md`
-
----
-
-## 실행
-
-아래 weave tool 호출을 수행합니다:
-
-```txt
-weave command=prepare docsPath="$ARGUMENTS"
-```
-
-옵션(필요 시):
-
-```txt
-weave command=prepare docsPath="$ARGUMENTS" projectName="My Project" planName="emotion-diary"
-```
-
----
-
-## 생성되는 산출물(기본)
-
-- Research: `tasks/research.md`
-- Spec: `.opencode/weave/specs/{planName}.yaml`
-- Plan: `.opencode/weave/plans/{planName}.yaml` 또는 `.opencode/weave/plans/{planName}-s*.yaml`
-
-> 주의: `.opencode/`가 gitignore 대상일 수 있으므로, AI 도구가 파일을 읽을 수 있게 `/weave-init`의 `.ignore` 설정을 권장합니다.
-
----
-
-## 다음 단계
-
-준비가 끝나면:
-
-```txt
-weave command=refine-plan   # (선택) plan-notes 반영
-weave command=approve-plan
-weave craft P1
-```
+---
+description: research + spec + plan을 한 번에 생성 (vNext 기본 경로)
+---
+
+# /weave-prepare - spec + plan 통합
+
+## 개요
+
+`/weave-research` + `/weave-spec` + `/weave-design`을 **한 번에** 이어서 수행합니다.
+
+- 문서를 깊게 읽어 **research.md** 아티팩트를 생성합니다
+- 문서에서 요구사항을 추출해 **baseline spec**을 생성합니다
+- 같은 입력으로 Phase 기반 **plan**을 생성합니다 (큰 계획은 shard plan 파일로 자동 분할)
+- 마지막에 승인 단계(`weave approve-plan`)를 안내합니다
+
+> 목적: 작은 기능마다 spec/plan을 두 번 돌리는 마찰을 줄이고,
+> "리서치-계획-승인"을 빠르게 통과할 수 있는 기본 경로(happy path)를 제공합니다.
+
+> 더 단순한 원커맨드가 필요하면 `/weave-flow [docs]`를 사용하세요
+> (`prepare -> auto-approve -> craft -> verify -> finalize`를 한 번에 실행).
+
+---
+
+## 사용법
+
+**사용법**: `/weave-prepare $ARGUMENTS`
+- `$ARGUMENTS` = 문서 경로 (예: `docs/`, `wiki/spec.md`)
+
+예시:
+- `/weave-prepare docs/`
+- `/weave-prepare wiki/spec.md`
+
+---
+
+## 실행
+
+아래 weave tool 호출을 수행합니다:
+
+```txt
+weave command=prepare docsPath="$ARGUMENTS"
+```
+
+옵션(필요 시):
+
+```txt
+weave command=prepare docsPath="$ARGUMENTS" projectName="My Project" planName="emotion-diary"
+```
+
+---
+
+## 생성되는 산출물(기본)
+
+- Research: `tasks/research.md`
+- Spec: `.opencode/weave/specs/{planName}.yaml`
+- Plan: `.opencode/weave/plans/{planName}.yaml` 또는 `.opencode/weave/plans/{planName}-s*.yaml`
+
+> 주의: `.opencode/`가 gitignore 대상일 수 있으므로, AI 도구가 파일을 읽을 수 있게 `/weave-init`의 `.ignore` 설정을 권장합니다.
+
+---
+
+## 다음 단계
+
+준비가 끝나면:
+
+```txt
+weave command=refine-plan   # (선택) plan-notes 반영
+weave command=approve-plan
+weave craft P1
+```

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

@@ -1,59 +1,59 @@
----
-description: plan-notes 지시문을 active plan에 자동 반영
----
-
-# /weave-refine-plan - 계획 정제(Annotation Cycle)
-
-## 개요
-
-`/weave-refine-plan`은 `tasks/plan-notes.md`의 지시문을 읽어서 active plan YAML에 자동 반영합니다.
-
-- 구현 전에 계획을 여러 번 정제하는 annotation cycle용
-- 반영이 일어나면 plan 승인 상태를 자동으로 해제
-- 반영 후에는 `weave approve-plan`을 다시 실행해야 구현 가능
-
----
-
-## 기본 사용법
-
-```txt
-/weave-refine-plan
-```
-
-내부 호출:
-
-```txt
-weave command=refine-plan
-```
-
-노트 파일 경로를 바꾸려면:
-
-```txt
-weave command=refine-plan notesPath="tasks/my-plan-notes.md"
-```
-
----
-
-## 노트 문법 (예시)
-
-`tasks/plan-notes.md`에 아래처럼 작성:
-
-```txt
-@plan vision: 로그인 이후 대시보드 흐름을 단순화한다
-@arch frontend: React + Vite + TanStack Query
-
-@phase P1 done_when: 유저가 이메일/비밀번호로 로그인할 수 있다
-@phase P1 add_checklist: 로그인 실패 메시지가 명확히 보인다
-
-@phase add P4: 운영 모니터링 | done=로그/메트릭 대시보드가 동작한다 | hours=3
-@phase remove P7
-```
-
----
-
-## 다음 단계
-
-```txt
-weave command=approve-plan
-weave command=craft
-```
+---
+description: plan-notes 지시문을 active plan에 자동 반영
+---
+
+# /weave-refine-plan - 계획 정제(Annotation Cycle)
+
+## 개요
+
+`/weave-refine-plan`은 `tasks/plan-notes.md`의 지시문을 읽어서 active plan YAML에 자동 반영합니다.
+
+- 구현 전에 계획을 여러 번 정제하는 annotation cycle용
+- 반영이 일어나면 plan 승인 상태를 자동으로 해제
+- 반영 후에는 `weave approve-plan`을 다시 실행해야 구현 가능
+
+---
+
+## 기본 사용법
+
+```txt
+/weave-refine-plan
+```
+
+내부 호출:
+
+```txt
+weave command=refine-plan
+```
+
+노트 파일 경로를 바꾸려면:
+
+```txt
+weave command=refine-plan notesPath="tasks/my-plan-notes.md"
+```
+
+---
+
+## 노트 문법 (예시)
+
+`tasks/plan-notes.md`에 아래처럼 작성:
+
+```txt
+@plan vision: 로그인 이후 대시보드 흐름을 단순화한다
+@arch frontend: React + Vite + TanStack Query
+
+@phase P1 done_when: 유저가 이메일/비밀번호로 로그인할 수 있다
+@phase P1 add_checklist: 로그인 실패 메시지가 명확히 보인다
+
+@phase add P4: 운영 모니터링 | done=로그/메트릭 대시보드가 동작한다 | hours=3
+@phase remove P7
+```
+
+---
+
+## 다음 단계
+
+```txt
+weave command=approve-plan
+weave command=craft
+```

package/assets/commands/weave-repair.md

@@ -1,70 +1,70 @@
----
-description: 깨진 YAML 플랜 파일을 스캔하고 자동 수복
----
-
-# /weave-repair - YAML 자동 수복
-
-## 개요
-
-Weave 플랜 YAML 파일의 손상을 감지하고 자동으로 수복합니다.
-
-**사용법**:
-- `/weave-repair` — 전체 플랜 파일 스캔 및 수복
-- `/weave-repair $ARGUMENTS` — 특정 파일만 수복 (예: `holon-x-openclaw-evolution-v3`)
-
----
-
-## 실행 절차
-
-### 1단계: 플랜 파일 스캔
-
-```
-1. .opencode/weave/state.yaml 확인
-2. .opencode/weave/plans/ 디렉토리의 모든 .yaml 파일 목록 확인
-3. .opencode/weave/PLAN.yaml (레거시) 확인
-```
-
-### 2단계: weave tool로 수복 실행
-
-`weave command=repair`를 호출하여 자동 수복을 실행합니다.
-
-### 3단계: 결과 보고
-
-수복 결과를 유저에게 보여줍니다:
-- **OK**: 정상 파일
-- **FIXED**: 자동 수복 성공 (무엇을 고쳤는지 표시)
-- **FAIL**: 자동 수복 불가 (유저에게 복구 옵션 안내)
-
----
-
-## 자동 수복 가능한 문제
-
-| 문제 | 예시 | 수복 방법 |
-|------|------|----------|
-| 닫히지 않은 따옴표 | `done_when: "1. fs.edit가 SecurityHook에` | 내부 따옴표 이스케이프 후 닫기 |
-| 탭 문자 | 들여쓰기에 탭 사용 | 스페이스 2칸으로 변환 |
-| 줄바꿈 문제 | CR+LF 혼합 | LF로 통일 |
-| 백업 복원 | 파싱 완전 실패 | `.bak` 파일에서 복원 |
-
----
-
-## 자동 수복 불가한 경우
-
-수복이 불가능한 파일이 있으면 유저에게 다음 옵션을 안내합니다:
-
-1. **원본 요구사항이 있다면**: `/weave-design`으로 플랜 재생성
-2. **`.corrupted` 백업 확인**: plans 디렉토리에 백업 파일 존재 여부
-3. **수동 복구**: 유저가 플랜 내용을 기억하면 그 정보로 YAML 재구성
-
-**유저에게 물어볼 것**:
-- 해당 플랜의 프로젝트 이름이 무엇이었는지
-- 어떤 Phase들이 있었는지
-- 각 Phase의 진행 상태 (완료/진행중/대기)
-
----
-
-## 참고
-
-- 수복 시 원본 파일은 `.corrupted` 확장자로 백업됩니다
-- 매 저장마다 `.bak` 백업이 자동 생성됩니다
-- `weave status`나 `weave craft` 실행 시에도 YAML 로드 실패하면 자동 수복을 시도합니다
+---
+description: 깨진 YAML 플랜 파일을 스캔하고 자동 수복
+---
+
+# /weave-repair - YAML 자동 수복
+
+## 개요
+
+Weave 플랜 YAML 파일의 손상을 감지하고 자동으로 수복합니다.
+
+**사용법**:
+- `/weave-repair` — 전체 플랜 파일 스캔 및 수복
+- `/weave-repair $ARGUMENTS` — 특정 파일만 수복 (예: `holon-x-openclaw-evolution-v3`)
+
+---
+
+## 실행 절차
+
+### 1단계: 플랜 파일 스캔
+
+```
+1. .opencode/weave/state.yaml 확인
+2. .opencode/weave/plans/ 디렉토리의 모든 .yaml 파일 목록 확인
+3. .opencode/weave/PLAN.yaml (레거시) 확인
+```
+
+### 2단계: weave tool로 수복 실행
+
+`weave command=repair`를 호출하여 자동 수복을 실행합니다.
+
+### 3단계: 결과 보고
+
+수복 결과를 유저에게 보여줍니다:
+- **OK**: 정상 파일
+- **FIXED**: 자동 수복 성공 (무엇을 고쳤는지 표시)
+- **FAIL**: 자동 수복 불가 (유저에게 복구 옵션 안내)
+
+---
+
+## 자동 수복 가능한 문제
+
+| 문제 | 예시 | 수복 방법 |
+|------|------|----------|
+| 닫히지 않은 따옴표 | `done_when: "1. fs.edit가 SecurityHook에` | 내부 따옴표 이스케이프 후 닫기 |
+| 탭 문자 | 들여쓰기에 탭 사용 | 스페이스 2칸으로 변환 |
+| 줄바꿈 문제 | CR+LF 혼합 | LF로 통일 |
+| 백업 복원 | 파싱 완전 실패 | `.bak` 파일에서 복원 |
+
+---
+
+## 자동 수복 불가한 경우
+
+수복이 불가능한 파일이 있으면 유저에게 다음 옵션을 안내합니다:
+
+1. **원본 요구사항이 있다면**: `/weave-design`으로 플랜 재생성
+2. **`.corrupted` 백업 확인**: plans 디렉토리에 백업 파일 존재 여부
+3. **수동 복구**: 유저가 플랜 내용을 기억하면 그 정보로 YAML 재구성
+
+**유저에게 물어볼 것**:
+- 해당 플랜의 프로젝트 이름이 무엇이었는지
+- 어떤 Phase들이 있었는지
+- 각 Phase의 진행 상태 (완료/진행중/대기)
+
+---
+
+## 참고
+
+- 수복 시 원본 파일은 `.corrupted` 확장자로 백업됩니다
+- 매 저장마다 `.bak` 백업이 자동 생성됩니다
+- `weave status`나 `weave craft` 실행 시에도 YAML 로드 실패하면 자동 수복을 시도합니다

package/assets/commands/weave-research.md

@@ -1,51 +1,51 @@
----
-description: 문서 + 워크스페이스 맥락을 깊게 조사해 research.md 생성
----
-
-# /weave-research - 리서치 아티팩트 생성
-
-## 개요
-
-`/weave-research`는 요구사항 문서와 현재 워크스페이스를 함께 조사해, 리뷰 가능한 리서치 문서를 생성합니다.
-
-- 입력 문서를 분석해 핵심 기능/기술 신호를 추출
-- 워크스페이스에서 관련 구현/중복 신호/재사용 후보를 조사
-- 문제 재현 흐름(가능한 범위)과 전/후 맥락을 정리
-- 열려 있는 질문과 환경 리스크를 정리
-- `tasks/research.md`에 영속 아티팩트로 저장
-
-> 구현 전에 리서치를 먼저 고정해두면, 이후 plan 품질과 수정 비용이 크게 줄어듭니다.
-
----
-
-## 사용법
-
-```txt
-/weave-research $ARGUMENTS
-```
-
-`$ARGUMENTS`는 문서 경로입니다.
-
-예시:
-- `/weave-research docs/`
-- `/weave-research wiki/spec.md`
-
----
-
-## 내부 호출
-
-```txt
-weave command=research docsPath="$ARGUMENTS"
-```
-
----
-
-## 다음 단계
-
-리서치 완료 후 권장 순서:
-
-```txt
-weave command=prepare docsPath="$ARGUMENTS"
-weave command=approve-plan
-weave command=craft
-```
+---
+description: 문서 + 워크스페이스 맥락을 깊게 조사해 research.md 생성
+---
+
+# /weave-research - 리서치 아티팩트 생성
+
+## 개요
+
+`/weave-research`는 요구사항 문서와 현재 워크스페이스를 함께 조사해, 리뷰 가능한 리서치 문서를 생성합니다.
+
+- 입력 문서를 분석해 핵심 기능/기술 신호를 추출
+- 워크스페이스에서 관련 구현/중복 신호/재사용 후보를 조사
+- 문제 재현 흐름(가능한 범위)과 전/후 맥락을 정리
+- 열려 있는 질문과 환경 리스크를 정리
+- `tasks/research.md`에 영속 아티팩트로 저장
+
+> 구현 전에 리서치를 먼저 고정해두면, 이후 plan 품질과 수정 비용이 크게 줄어듭니다.
+
+---
+
+## 사용법
+
+```txt
+/weave-research $ARGUMENTS
+```
+
+`$ARGUMENTS`는 문서 경로입니다.
+
+예시:
+- `/weave-research docs/`
+- `/weave-research wiki/spec.md`
+
+---
+
+## 내부 호출
+
+```txt
+weave command=research docsPath="$ARGUMENTS"
+```
+
+---
+
+## 다음 단계
+
+리서치 완료 후 권장 순서:
+
+```txt
+weave command=prepare docsPath="$ARGUMENTS"
+weave command=approve-plan
+weave command=craft
+```