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

.opencode/commands/weave-prepare.md

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