maskweaver 0.9.2 → 0.9.4

package/assets/commands/weave-help.md

@@ -1,114 +1,45 @@
 ---
-description: Weave 워크플로우 도움말
+description: Show weave workflow help
 ---
 
-# /weave-help - Weave 워크플로우 도움말
+# /weave-help
 
-> **Maskweaver v0.9.1**
+Weave is Maskweaver's phase-driven workflow for moving from requirements to verified implementation.
 
-## Weave란?
+## Main Flow
 
-Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
-"AI가 검증하고, 유저가 확인한다"
-
-**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
-
----
-
-## 버전 확인
-
-| 방법 | 명령어 |
-|------|--------|
-| CLI | `maskweaver --version` 또는 `maskweaver -V` |
-| npm | `npm list maskweaver` |
-| 채팅 내 | `maskweaver_status` 도구 사용 |
-| Weave | `/weave help` |
-
----
-
-## 핵심 철학
-
-```
-1. 테스트 먼저 (Protect Before Change)
-2. 작게 자주 (Small & Often)
-3. 동작이 정답 (Working > Perfect)
+```txt
+/weave-init
+/weave-map
+/weave-interview
+/weave-prepare
+/weave-refine-plan
+/weave-approve
+/weave-craft
+/build
+/weave-verify
+/weave-archive
 ```
 
----
-
-## 통합 후 명령어 목록 (v0.9+)
-
-| 명령어 | 설명 |
-|--------|------|
-| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
-| `/weave-map [deep]` | 코드베이스 구조 분석 + GDC 그래프 연동 |
-| `/weave-interview [docs]` | 코드베이스 맵 기반 멀티스텝 요구사항 인터뷰 |
-| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
-| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
-| `/weave-approve` | 구현 전 계획 승인 게이트 통과 |
-| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
-| `/weave-build [action]` | **자율 빌드 루프** — run, status, stop, list, resume, sync |
-| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
-| `/weave-worktree` | git worktree 기반 병렬 작업 관리 |
-| `/weave-verify` | 빌드/테스트 검증 실행 (프로젝트 유형 자동 감지) |
-| `/weave-archive` | 검증된 변경사항 아카이브 |
-| `/weave-troubleshoot [error]` | 글로벌 지식 검색 / 솔루션 기록 (`--record`) |
-| `/weave-repair` | plan YAML 자동 검사 및 수리 |
-| `/weave-agents [flags]` | 에이전트 동기화 (`--sync`) / 설정 초기화 (`--init`) |
-| `/weave-help` | 이 도움말 |
-
----
-
-## 워크플로우
-
-```
-/weave-init                    ← 프로젝트 초기화 (1회)
-    ↓
-/weave-prepare docs/           ← research + spec + plan 한 번에 생성
-    ↓
-/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
-    ↓
-/weave-approve                 ← 구현 전 계획 승인 (필수)
-    ↓
-/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
-    ↓
-/weave-build                   ← 자율 빌드 루프 실행
-    ↓
-/weave-verify                  ← 검증
-    ↓
-/weave-archive                 ← 아카이브
-```
-
----
-
-## 파일 구조
-
-```
-.opencode/weave/
-├── state.yaml           ← 활성 플랜 추적
-├── specs/
-│   └── *.yaml           ← baseline spec
-└── plans/
-    └── *.yaml           ← 플랜
-```
-
----
-
-## 마이그레이션 노트 (v0.9)
-
-| 기존 명령어 | 새 명령어 | 비고 |
-|-------------|-----------|------|
-| `approve-plan` | `approve` | alias로 v0.9까지 동작 |
-| `build-resume` | `build --resume` | alias로 v0.9까지 동작 |
-| `loop-run` | `build` | alias로 v0.9까지 동작 |
-| `loop-status` | `build --status` | alias로 v0.9까지 동작 |
-| `loop-stop` | `build --stop` | alias로 v0.9까지 동작 |
-| `loop-list` | `build --list` | alias로 v0.9까지 동작 |
-| `loop-sync` | `build --sync` | alias로 v0.9까지 동작 |
-| `record` | `troubleshoot --record` | alias로 v0.9까지 동작 |
-| `sync-agents` | `agents --sync` | alias로 v0.9까지 동작 |
-| `init-config` | `agents --init` | alias로 v0.9까지 동작 |
-| `research` | `prepare` | deprecated alias (v0.9 경고) |
-| `spec` | `prepare` | deprecated alias (v0.9 경고) |
-| `design` | `prepare` | deprecated alias (v0.9 경고) |
-| `flow` | `prepare` → `approve` → `craft` | deprecated alias (v0.9 경고) |
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `/weave-init` | Initialize workspace files and probe GDC integration |
+| `/weave-map` | Analyze codebase structure |
+| `/weave-interview` | Clarify requirements before planning |
+| `/weave-prepare` | Create research, spec, and plan artifacts |
+| `/weave-refine-plan` | Apply structured notes to the active plan |
+| `/weave-approve` | Approve a plan or finalize a verified phase |
+| `/weave-craft` | Prepare phase execution context |
+| `/build` | Run or manage the autonomous build loop |
+| `/weave-build` | Long-form build command |
+| `/weave-status` | View plan and phase progress |
+| `/weave-worktree` | Manage git worktrees for parallel work |
+| `/weave-verify` | Run build/test verification |
+| `/weave-archive` | Archive a verified active change |
+| `/weave-troubleshoot` | Search or record solution knowledge |
+| `/weave-repair` | Repair corrupted plan YAML |
+| `/weave-agents` | Sync generated agent files and config |
+
+Use `/build` for the common autonomous build path. Keep `/weave-*` for workflow commands so opencode built-in commands stay clear.

package/assets/commands/weave-init.md

@@ -1,108 +1,26 @@
----
-description: Weave 워크플로우 초기화 (프로젝트별 1회)
----
-
-# /weave-init - Weave 워크플로우 초기화
-
-## 개요
-
-현재 프로젝트에서 Weave 워크플로우를 사용할 수 있도록 초기화합니다.
-**프로젝트당 1회**만 실행하면 됩니다.
-
----
-
-## 수행 작업
-
-### 1. `.ignore` 파일 설정
-
-프로젝트 루트에 `.ignore` 파일을 생성/수정하여 `.opencode/weave/` 경로를 AI 도구가 탐색할 수 있도록 합니다.
-
-**왜 필요한가?**
-- `.gitignore`에 `.opencode/`가 있으면 ripgrep 기반 도구(glob, grep, list)가 PLAN 파일을 찾지 못합니다
-- `.ignore` 파일로 이 규칙을 덮어씌워 AI가 접근할 수 있게 합니다
-- Git 추적 상태는 변하지 않습니다 (`.gitignore`는 그대로)
-
-**생성할 내용**:
-```
-# Allow AI tools to access weave plans (overrides .gitignore)
-!.opencode/weave/
-```
-
-만약 `.ignore` 파일이 이미 있다면, `!.opencode/weave/` 줄만 추가합니다 (중복 방지).
-
-### 2. 디렉토리 구조 생성
-
-```bash
-mkdir -p .opencode/weave/plans
-```
-
-### 3. `state.yaml` 초기화
-
-`.opencode/weave/state.yaml` 파일을 생성합니다:
-
-```yaml
-# Weave Multi-Plan State
-# 이 파일은 활성 플랜을 추적합니다
-active_plan: null
-```
-
-### 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 초기화 자체는 완료됩니다.
-
----
-
-## 완료 메시지
-
-```markdown
-## ✅ Weave 초기화 완료!
-
-### 생성된 파일
-- `.ignore` — AI 도구 접근 허용 설정
-- `.opencode/weave/state.yaml` — 플랜 상태 추적
-- `.opencode/weave/plans/` — 플랜 저장 디렉토리
-
-### 다음 단계
-프로젝트 계획을 세우려면:
-`weave command=prepare docsPath="docs/"`
-```
-
----
-
-## 이미 초기화된 경우
-
-`.opencode/weave/state.yaml`이 이미 존재하면:
-
-```markdown
-ℹ️ 이미 Weave가 초기화되어 있습니다.
-
-활성 플랜: {active_plan 또는 "없음"}
-전체 플랜 수: {plans/ 내 yaml 파일 수}
-
-상태 확인: `/weave-status`
-```
-
----
-
-## 주의사항
-
-- `.ignore` 파일은 `.gitignore`와 **같은 레벨(프로젝트 루트)**에 생성합니다
-- `.ignore`는 Git이 아니라 ripgrep만 참조하므로 Git 추적에 영향 없음
-- `.ignore` 파일 자체는 `.gitignore`에 넣지 마세요 (AI가 읽어야 하므로)
+---
+description: Initialize weave workspace files and probe GDC integration
+---
+
+# /weave-init
+
+Initialize the Weave workspace for the current project.
+
+Use the `weave` tool:
+
+```txt
+weave command=init
+```
+
+## What It Creates
+
+- `.opencode/weave/state.yaml`
+- `.opencode/weave/plans/`
+- `.opencode/weave/specs/`
+- `.ignore` entry that lets AI tools read `.opencode/weave/` even when `.opencode/` is gitignored
+
+## GDC Probe
+
+When GDC is present, init probes the workspace and reports status. Missing or unavailable GDC should be reported as a setup hint, not as a failed Weave initialization.
+
+Run this once per project root. Worktrees should be created with `/weave-worktree` so Weave artifacts are bootstrapped correctly.

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`.