maskweaver 0.9.3 → 0.9.4

package/assets/commands/weave-interview.md

@@ -1,121 +1,23 @@
 ---
-description: 코드베이스 맵 결과를 바탕으로 사용자 요구사항 인터뷰 수행
+description: Ask clarifying questions until requirements and structural changes are clear
 ---
 
-# /weave-interview - 요구사항 인터뷰
+# /weave-interview
 
-## 개요
+Use codebase context and optional requirement documents to ask the questions needed before planning.
 
-`/weave-map` 분석 결과를 바탕으로 **사용자와의 멀티스텝 인터뷰**를 수행합니다.  
-코드베이스의 현재 상태와 구조적 변경 가능성을 파악하고, 명확해질 때까지 질문을 반복합니다.
+Use the `weave` tool:
 
-**사용법**:
-- `/weave-interview` — 기본 인터뷰 (코드베이스 맵 기반)
-- `/weave-interview docs/` — 문서 경로를 함께 참조하며 인터뷰
-
----
-
-## 데이터 로드 방법 (필수)
-
-```
-1. .opencode/weave/maps/map-result.yaml 로드 (map 먼저 실행되어 있어야 함)
-2. map 결과가 없으면: 자동으로 기본 map 분석 수행 후 진행
-3. (선택) docsPath의 문서 로드
-4. 코드베이스 기술 스택 및 구조적 이슈 확인
-```
-
----
-
-## 입력
-
-```yaml
-docsPath: "docs/"    # (선택) 요구사항 문서 경로
-```
-
----
-
-## 동작 흐름
-
-```
-1. 코드베이스 맵 결과 로드 (없으면 자동 생성)
-2. 구조적 변경 감지 (structural changes)
-   - 현재 상태 vs 제안된 변경
-   - Breaking change 여부
-   - 영향받는 파일 목록
-3. 사용자에게 질문 생성
-   - 변경 영역에 대한 의도 확인
-   - 우선순위 및 범위 조정
-4. 충분한 명확성 달성 시 인터뷰 종료
-   - 종료 기준: 모든 structural changes에 대해 agreed 상태
-```
-
----
-
-## 출력 예시
-
-### 인터뷰 진행 중
-
-```markdown
-## 🎤 Weave Interview
-
-**기반 맵**: `map-20250428-a1b2`
-**프로젝트 타입**: TypeScript / React
-
-### 감지된 구조적 변경
-
-1. **Auth 모듈 분리**
-   - 현재: `src/lib/auth.ts` (단일 파일)
-   - 제안: `src/auth/` 디렉토리로 분리
-   - 영향: 8개 파일
-   - Breaking: ❌ 아니오
-
-2. **Prisma → Drizzle 마이그레이션**
-   - 현재: Prisma ORM
-   - 제안: Drizzle ORM으로 전환
-   - 영향: 15개 파일
-   - Breaking: ⚠️ 예 (DB 스키마 변경)
-
----
-
-### 질문
-
-> **Q1**: Auth 모듈 분리는 단순 코드 구조 개선인가요, 아니면 새로운 인증 기능(예: OAuth) 추가를 위한 준비인가요?
->
-> 답변 후 다음 질문으로 진행합니다.
-```
-
-### 인터뷰 완료
-
-```markdown
-## ✅ Interview Complete
-
-**모든 구조적 변경이 명확해졌습니다.**
-
-| 변경 영역 | 상태 | 결정 |
-|-----------|------|------|
-| Auth 모듈 분리 | ✅ Agreed | 디렉토리 분리 + OAuth 확장 준비 |
-| Prisma → Drizzle | ⏳ Pending | Phase 2로 연기 (현재는 Prisma 유지) |
-
-### 다음 단계
-- `/weave-design` — 결정사항을 바탕으로 계획 수립
-- `/weave-prepare` — research + spec + plan 한 번에 생성
+```txt
+weave command=interview
+weave command=interview docsPath="docs/"
 ```
 
----
-
-## 아티팩트 저장 위치
-
-인터뷰 결과는 `.opencode/weave/interviews/`에 저장됩니다:
-
-```
-.opencode/weave/interviews/
-└── interview-{id}.yaml    # 질문-답변 기록 및 structural changes 상태
-```
-
----
+## Goal
 
-## 관련 명령어
+- Identify unclear requirements.
+- Detect structural changes that need explicit agreement.
+- Separate must-have scope from later work.
+- Produce enough clarity for `/weave-prepare`.
 
-- `/weave-map` — 코드베이스 맵 생성 (인터뷰 선행 조건)
-- `/weave-design` — 인터뷰 결과를 바탕으로 계획 수립
-- `/weave-prepare` — 전체 워크플로우 한 번에 실행
+Use this before planning when requirements are fuzzy, architectural impact is likely, or multiple stakeholders need their assumptions surfaced.

package/assets/commands/weave-map.md

@@ -1,109 +1,23 @@
 ---
-description: 코드베이스 구조를 분석하고 지식 그래프(knowledge graph) 생성
+description: Analyze codebase structure via GDC and optional Graphify
 ---
 
-# /weave-map - 코드베이스 맵 분석
+# /weave-map
 
-## 개요
+Map the current codebase before requirements interviews or planning.
 
-현재 프로젝트의 코드베이스 구조를 분석하여 **기술 스택 자동 감지**, **디렉토리 구조 분석**, **GDC 그래프 연동** 결과를 생성합니다.  
-`deep` 옵션 사용 시 `graphify-windows` 스킬을 활용한 딥 그래프 분석도 수행합니다.
+Use the `weave` tool:
 
-**사용법**:
-- `/weave-map` — 기본 코드베이스 분석
-- `/weave-map --deep` — 심층 그래프 분석 (graphify-windows)
-
----
-
-## 데이터 로드 방법 (필수)
-
-```
-1. 프로젝트 루트의 package.json, tsconfig.json, Cargo.toml, go.mod 등 탐지
-2. GDC 설정 확인 (.gdc/config.yaml 또는 .opencode/gdc/)
-3. GDC 활성화 시: gdc graph + gdc stats 명령 실행
-4. deep 옵션 시: graphify-windows 스킬 실행
-```
-
----
-
-## 입력
-
-```yaml
-deep: false      # (선택) true 시 graphify-windows 딥 분석 실행
-```
-
----
-
-## 출력 예시
-
-### 기본 분석
-
-```markdown
-## 🗺️ Codebase Map
-
-**프로젝트 타입**: TypeScript / Node.js
-**기술 스택**: React, Next.js, Prisma, Tailwind
-
-### 디렉토리 구조
-```
-src/
-├── app/           # Next.js App Router
-├── components/    # React 컴포넌트
-├── lib/           # 유틸리티
-└── db/            # Prisma 스키마
+```txt
+weave command=map
+weave command=map deep=true
 ```
 
-### GDC 그래프
-- **노드**: 42개
-- **엣지**: 78개
-- **커버리지**: 85% 구현, 60% 테스트
-
-### 주요 의존성
-- next: ^14.0
-- react: ^18.2
-- @prisma/client: ^5.0
-```
-
-### 심층 분석 (deep)
-
-```markdown
-## 🗺️ Codebase Map (Deep)
-
-**그래프 분석 완료**
-
-### 커뮤니티 클러스터
-| 클러스터 | 파일 수 | 핵심 엔티티 |
-|----------|--------|------------|
-| C1 | 12 | User, Auth, Session |
-| C2 | 8 | Post, Comment, Feed |
-| C3 | 6 | Payment, Subscription |
-
-### 구조적 이슈
-- ⚠️ 순환 의존성: `src/lib/api.ts` ↔ `src/lib/auth.ts`
-- ⚠️ 고립 노드: `src/utils/legacy-helpers.ts` (참조 없음)
-
-### 추천 리팩토링
-1. `api.ts`와 `auth.ts` 순환 의존성 해소
-2. `legacy-helpers.ts` 제거 또는 통합
-```
-
----
-
-## 아티팩트 저장 위치
-
-분석 결과는 `.opencode/weave/maps/`에 저장됩니다:
-
-```
-.opencode/weave/maps/
-├── map-report.yaml          # 구조 분석 요약
-├── map-result.yaml          # GDC 연동 결과
-└── graphify-report.html     # deep 분석 시 생성
-```
-
----
+## Behavior
 
-## 관련 명령어
+- Detects project type and important configuration files.
+- Uses GDC when available for structural context.
+- Uses deeper Graphify analysis when `deep=true` and the environment supports it.
+- Saves map artifacts under `.opencode/weave/maps/`.
 
-- `/weave-interview` — 맵 결과를 바탕으로 사용자 인터뷰
-- `/weave-design` — 분석 결과를 바탕으로 계획 수립
-- `/weave-init` — weave 워크스페이스 초기화
+This command is for understanding structure. It should not replace builds, tests, or smoke checks.

package/assets/commands/weave-prepare.md

@@ -1,69 +1,23 @@
----
-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: Create research, spec, and phase plan artifacts from requirements
+---
+
+# /weave-prepare
+
+Create the planning artifacts needed for phase-driven implementation.
+
+Use the `weave` tool:
+
+```txt
+weave command=prepare docsPath="docs/"
+weave command=prepare docsPath="docs/" planName="emotion-diary"
+```
+
+## Outputs
+
+- Research notes from the provided documents or project context.
+- Baseline spec under `.opencode/weave/specs/`.
+- Phase plan under `.opencode/weave/plans/`.
+- Sharded plans when a plan is too large and `splitPlans=true`.
+
+After prepare, review the generated plan, optionally run `/weave-refine-plan`, then approve with `/weave-approve`.

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

@@ -1,59 +1,26 @@
----
-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: Apply structured plan-note directives to the active plan
+---
+
+# /weave-refine-plan
+
+Apply structured review notes to the active plan before approval.
+
+Use the `weave` tool:
+
+```txt
+weave command=refine-plan
+weave command=refine-plan notesPath="tasks/plan-notes.md"
+```
+
+## Note Examples
+
+```txt
+@plan vision: Keep the first release focused on login and dashboard.
+@phase P1 done_when: A user can sign in with email and password.
+@phase P1 add_checklist: Failed login shows a clear message.
+@phase add P4: Observability | done=errors are logged | hours=3
+@phase remove P7
+```
+
+Run `/weave-approve` again after changing the active plan.

package/assets/commands/weave-repair.md

@@ -1,70 +1,22 @@
----
-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: Scan and auto-repair corrupted plan YAML files
+---
+
+# /weave-repair
+
+Repair malformed Weave plan YAML when status, craft, or approve cannot load the plan.
+
+Use the `weave` tool:
+
+```txt
+weave command=repair
+```
+
+## Behavior
+
+- Scans `.opencode/weave/state.yaml` and plan files.
+- Reports files as OK, fixed, or failed.
+- Creates backups before risky repairs when supported.
+- Gives manual recovery guidance when automatic repair is not possible.
+
+Use this for artifact recovery only. Do not use it to rewrite requirements or change implementation scope.