feat: add file upload for materials (PDF/DOCX) with ingestion pipeline

.opencode/commands/weave-help.md

@@ -0,0 +1,158 @@
+---
+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
+```