---
description: Weave 워크플로우 도움말
---

# /weave-help - Weave 워크플로우 도움말

## Weave란?

Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
"AI가 검증하고, 유저가 확인한다"

**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.

---

## 버전 확인

설치된 Maskweaver 버전을 확인하는 방법:

| 방법 | 명령어 |
|------|--------|
| CLI | `maskweaver --version` 또는 `maskweaver -V` |
| npm | `npm list maskweaver` |
| 채팅 내 | `maskweaver_status` 도구 사용 |
| Weave | `/weave help` |
| Node.js | `import { VERSION } from 'maskweaver'` |

---

## 핵심 철학

```
1. 테스트 먼저 (Protect Before Change)
2. 작게 자주 (Small & Often)
3. 동작이 정답 (Working > Perfect)
```

---

## 명령어 목록

| 명령어 | 설명 |
|--------|------|
| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
| `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
| `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
| `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
| `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft |
| `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성, 큰 계획은 자동 분할) |
| `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
| `/weave-switch [plan]` | 활성 플랜 전환 / 아카이브 |
| `/weave-worktree` | git worktree 기반 병렬 작업(기능/Phase) 관리 |
| `/weave-verify` | 빌드/테스트 검증 실행(프로젝트 유형 자동 감지) |
| `/weave-help` | 이 도움말 |

---

## 멀티 플랜 워크플로우

```
/weave-init                    ← 프로젝트 초기화 (1회)
    ↓
/weave-flow docs/              ← (원커맨드) prepare→approve-plan gate→craft
    ↓
/weave-prepare docs/           ← (수동 경로) research+spec+plan 한 번에 생성
    ↓
/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
    ↓
/weave-approve-plan            ← 구현 전 계획 승인 (필수)
    ↓
/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
    ↓
/weave-design wiki/new-feat    ← 두 번째 플랜 추가 (또는 prepare)
    ↓
/weave-switch first-plan       ← 첫 번째 플랜으로 돌아가기
    ↓
/weave-status                  ← 전체 상황 확인
```

### 플랜 상태 흐름

```
active ──→ paused ──→ active (switch로 전환)
  │                      │
  └──→ completed ──→ archived (switch archive)
                         │
                         └──→ paused (switch unarchive)
```

---

## 파일 구조

```
.opencode/weave/
├── state.yaml           ← 활성 플랜 추적
├── specs/
│   ├── emotion-diary.yaml    ← baseline spec 1
│   └── todo-app.yaml         ← baseline spec 2
└── plans/
    ├── emotion-diary.yaml   ← 플랜 1
    ├── todo-app.yaml        ← 플랜 2
    └── auth-module.yaml     ← 플랜 3
```

---

## Maskweaver 통합 기능

### 마스크 자동 선택

작업 맥락에 따라 전문가 마스크가 자동 선택됩니다:
- 아키텍처 → Martin Fowler
- 테스트 → Kent Beck
- React → Dan Abramov
- 성능 → Linus Torvalds

### 글로벌 지식 공유

트러블슈팅 경험이 프로젝트 간 공유됩니다:
- 에러 발생 시 → 과거 솔루션 검색
- 해결 시 → 새 솔루션 기록

### 다층 자동 검증

Phase 실행 시 자동 검증:
1. TypeCheck → Lint → Build
2. Unit Tests → E2E Tests
3. Screenshot → A11y Check

---

## 빠른 시작

```bash
# 1. 초기화 (프로젝트당 1회)
/weave-init

# 2. (추천) spec + plan을 한 번에 생성
/weave-prepare wiki/

# 3. 계획 검토 후 승인 게이트 통과
/weave-refine-plan   # (선택) notes 반영
/weave-approve-plan

# 4. 다음 Phase 자동 선택 실행
/weave-craft

# 5. 새 기능 추가? 새 플랜!
/weave-design docs/new-feature

# 6. 플랜 사이 전환
/weave-switch emotion-diary
```