maskweaver 0.9.3 → 0.9.5

package/assets/commands/weave-agents.md

@@ -1,62 +1,22 @@
 ---
-description: 에이전트 파일 동기화 및 설정 초기화
+description: Sync generated agent files and initialize runtime configuration
 ---
 
-# /weave-agents - 에이전트 및 설정 관리
+# /weave-agents
 
-## 개요
+Manage the agent files that Maskweaver exposes to opencode.
 
-에이전트 파일과 설정 파일을 관리합니다. 기존 `sync-agents`와 `init-config`를 통합한 명령어입니다.
+Use the `weave` tool:
 
-| 플래그 | 설명 | 대응 기존 명령어 |
-|--------|------|-----------------|
-| `sync` | 설정 기준으로 더미 에이전트 파일 강제 재생성 | `weave sync-agents` |
-| `init` | 기본 설정 파일(maskweaver.config.json) 생성 | `weave init-config` |
-
----
-
-## 사용법
-
-```bash
-# 에이전트 파일 동기화
-/weave-agents --sync
-
-# 기본 설정 파일 생성
-/weave-agents --init
-
-# 동시 실행
-/weave-agents --sync --init
-```
-
----
-
-## 입력
-
-```yaml
-sync: true   # (선택) 에이전트 파일 강제 재생성
-init: true   # (선택) 기본 설정 파일 생성 (기존 파일 덮어쓰지 않음)
-```
-
----
-
-## 출력 예시
-
-### 동기화
-
-```markdown
-## 🔄 Agent Sync
-
-✅ Updated: `.opencode/agents/dummy-human-1.md`
-✅ Updated: `.opencode/agents/dummy-human-2.md`
-
-> ⚠️ **Important:** You may need to restart OpenCode for the updated agent files to take effect.
+```txt
+weave command=agents sync=true
+weave command=agents init=true
 ```
 
-### 설정 초기화
+## Modes
 
-```markdown
-## 📝 Config Initialization
+- `sync=true`: regenerate `.opencode/agents/*.md` from the configured dummy-human pool.
+- `init=true`: create the default runtime and plugin configuration files when they do not exist.
+- `sync=true init=true`: initialize config and refresh generated agent files in one pass.
 
-✅ Created runtime config: maskweaver.config.json
-✅ Created plugin config: .opencode/maskweaver.json
-```
+Prefer this command when agent markdown files are missing, stale, or out of sync with `maskweaver.config.json`.

package/assets/commands/weave-approve.md

@@ -1,61 +1,22 @@
 ---
-description: Plan 승인 게이트 통과 (구현 전 필수)
+description: Approve the plan or finalize a crafted phase
 ---
 
-# /weave-approve - Plan 승인 게이트
+# /weave-approve
 
-## 개요
+Pass the approval gate before implementation, or finalize a phase after craft and verify have completed.
 
-구현 전 **반드시 통과해야 하는 승인 게이트**입니다. Plan을 검토하고 승인하거나, 이미 craft 완료된 Phase를 최종 확정(finalize)합니다.
+Use the `weave` tool:
 
-**이전 명령어**: `approve-plan` (v0.9까지 alias로 동작)
-
----
-
-## 사용법
-
-```bash
-# Plan 승인 (가장 일반적)
-/weave-approve
-
-# Craft 완료된 Phase 최종 확정
-/weave-approve P1
+```txt
+weave command=approve
+weave command=approve phaseId="P1"
 ```
 
----
-
-## 입력
-
-```yaml
-phaseId: "P1"          # (선택) 최종 확정할 Phase ID. 미지정 시 Plan 승인
-planReview: "..."      # (선택) Plan 검토 요약
-applyNotes: true       # (선택) plan-notes 자동 반영 여부 (기본: true)
-```
-
----
+## Behavior
 
-## 동작 흐름
+- Without `phaseId`, approve the active plan so implementation can begin.
+- With `phaseId`, finalize the crafted phase after verification.
+- `applyNotes=true` applies structured notes before approval when plan notes are present.
 
-```
-1. 활성 Plan 로드
-2. phaseId 미지정 → Plan 승인
-   └─ applyNotes=true → plan-notes 자동 반영 후 승인
-3. phaseId 지정 → Phase 최종 확정 (finalize)
-   └─ verify → 통과 시 완료 처리
-```
-
----
-
-## 출력 예시
-
-### Plan 승인
-
-```markdown
-## ✅ Plan Approved
-
-- Plan: `.opencode/weave/plans/emotion-diary.yaml`
-- Approved at: 2025-04-28T10:30:00.000Z
-- Review note: Approved without additional notes.
-
-다음 단계: `weave command=craft phaseId="P1"`
-```
+Do not treat approval as a substitute for verification. Use `/weave-verify` or `/build` for evidence before finalizing work.

package/assets/commands/weave-archive.md

@@ -0,0 +1,21 @@
+---
+description: Archive the verified active change artifact
+---
+
+# /weave-archive
+
+Archive the active change after implementation has been verified and the phase or plan no longer needs to stay active.
+
+Use the `weave` tool:
+
+```txt
+weave command=archive
+```
+
+## When To Use
+
+- The active change has passed build/test verification.
+- The user has accepted the implementation result.
+- The plan should be preserved for history but removed from the active workflow.
+
+Do not archive unverified work. Run `/weave-verify` or `/build` first and keep the verification result in the change record.

package/assets/commands/weave-build.md

@@ -1,99 +1,30 @@
 ---
-description: 자율 빌드 루프 실행 및 관리 (run, status, stop, list, resume, sync)
+description: Run, resume, stop, list, or inspect autonomous build loops
 ---
 
-# /weave-build - 자율 빌드 루프 실행 및 관리
+# /weave-build
 
-## 개요
+Run the Maskweaver autonomous build loop for approved phases, or manage an existing build loop.
 
-승인된 플랜의 지정된 Phase(들)를 **자율 빌드 루프**로 실행하거나, 기존 빌드의 상태를 확인/관리합니다.
+Use the `weave` tool:
 
-| 서브 액션 | 설명 | 대응 기존 명령어 |
-|-----------|------|-----------------|
-| `run` (기본) | 활성 Phase를 Ralph-loop로 자율 실행 | `weave build`, `weave loop-run` |
-| `status` | 특정 빌드/루프의 상태 확인 | `weave loop-status` |
-| `stop` | 실행 중인 빌드/루프 중단 요청 | `weave loop-stop` |
-| `list` | 모든 빌드/루프 목록 조회 | `weave loop-list` |
-| `resume` | 중단(blocked)된 빌드 재개 | `weave build-resume` |
-| `sync` | 위임된 squad 결과 동기화 | `weave loop-sync` |
-
----
-
-## 사용법
-
-```bash
-# 자율 빌드 시작 (기본)
-/weave-build
-/weave-build P1,P2
-
-# 빌드 상태 확인
-/weave-build --status build-20250428-a1b2
-
-# 빌드 중단
-/weave-build --stop build-20250428-a1b2
-
-# 빌드 목록
-/weave-build --list
-
-# 중단 빌드 재개
-/weave-build --resume build-20250428-a1b2
-
-# 위임 결과 동기화
-/weave-build --sync build-20250428-a1b2
+```txt
+weave command=build
+weave command=build action=run phaseIds="P1,P2"
+weave command=build action=status buildId="build-20250428-a1b2"
+weave command=build action=stop buildId="build-20250428-a1b2"
+weave command=build action=list
+weave command=build action=resume buildId="build-20250428-a1b2"
+weave command=build action=sync buildId="build-20250428-a1b2"
 ```
 
----
-
-## 입력
-
-```yaml
-action: run | status | stop | list | resume | sync   # (선택) 서브 액션. 기본값: run
-phaseIds: "P1,P2"                                     # (선택, action=run) 쉼표로 구분된 Phase ID
-buildId: "build-xxx"                                  # (선택, action=status/stop/resume/sync) 대상 빌드 ID
-maxRetries: 3                                         # (선택, action=run) 태스크당 최대 재시도
-maxIterations: 1                                      # (선택) 최대 반복 횟수
-maxNoProgress: 1                                      # (선택) 무진행 허용 횟수
-```
-
----
-
-## 출력 예시
-
-### 성공 (run)
-
-```markdown
-## ✅ Build Complete
-
-**Build ID**: `build-20250428-a1b2`
-**Plan**: `emotion-diary`
-**Phases**: P1, P2
-
-| Phase | 상태 | 소요 시간 |
-|-------|------|----------|
-| P1 | ✅ 완료 | 12분 |
-| P2 | ✅ 완료 | 8분 |
-```
-
-### 일부 실패 (blocked)
-
-```markdown
-## ⚠️ Build Blocked
-
-**Build ID**: `build-20250428-c3d4`
-**Plan**: `emotion-diary`
-
-| Phase | 상태 | 실패 원인 |
-|-------|------|----------|
-| P1 | ✅ 완료 | - |
-| P2 | 🚫 blocked | 타입 검증 실패 (3회 재시도 소진) |
-
-**다음 동작**: `weave build action=resume buildId="build-20250428-c3d4"`
-```
-
----
+## Actions
 
-## 관련 명령어
+- `run`: execute selected phases, or the next approved work when phase IDs are omitted.
+- `status`: inspect one build loop.
+- `stop`: request a running loop to stop.
+- `list`: show known build loops.
+- `resume`: continue a blocked or stopped build.
+- `sync`: import squad/runtime results into the build record.
 
-- `/weave-craft [phaseId]` — 단일 Phase 수동 실행 준비
-- `/weave-verify` — 현재 워크트리 검증
-- `/weave-status` — 전체 진행 상황
+The short `/build` command is also installed for opencode users who expect build to appear as a direct command.

package/assets/commands/weave-craft.md

@@ -1,43 +1,22 @@
----
-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: Prepare execution context for a phase
+---
+
+# /weave-craft
+
+Prepare one approved phase for implementation.
+
+Use the `weave` tool:
+
+```txt
+weave command=craft
+weave command=craft phaseId="P1"
+```
+
+## Behavior
+
+- Selects the next runnable phase when `phaseId` is omitted.
+- Loads plan, spec, masks, and execution context for the chosen phase.
+- Gives the implementer the bounded task context needed to start work.
+
+After implementation, run `/weave-verify` or `/build` before using `/weave-approve` to finalize the phase.

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.