---
name: doc
description: Draft or edit a document — PRD, spec, design doc, technical brief. Use for "/doc project title" to create a new doc or edit existing.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet
user-invocable: true
---
# /doc — Document Drafting
Create or edit documents (specs, PRDs, design docs, etc.).
## Context
Today's date: `!date +%Y-%m-%d`
Existing docs: `!ls docs/*/*.md 2>/dev/null | tail -10`
Reference template: @_templates/doc.md
Config: @_core/config.yaml
Processing logic: @_core/PROCESSING.md
## Input
User input: $ARGUMENTS
## Processing Steps
1. **Parse Input**
- Extract project
- Extract title/feature name
2. **Check Existing**
- Search `docs/{project}/*.md` for similar titles (or `docs/general/*.md` if no project)
- If found: Offer to edit or create new
3. **Gather Context**
- Search for related decisions/blockers
4. **Interactive Drafting**
- Prompt for each major section:
- Problem statement
- Goals / Non-goals
- Requirements (P0/P1/P2)
- Technical approach
- Or accept full content at once
5. **Create Doc Note**
- If no project specified: write to `docs/general/{slug}.md`
- If project specified: write to `docs/{project}/{slug}.md`
- Apply template with gathered data
- Status: draft
- Add `## Links` section
6. **Update References**
- Add to project index if exists
7. **Append to Vault Log**
- Append entry to `01-index/_vault-log.md` (see `.claude/rules/vault-log.md`)
- Action: `doc`
- Details: doc title and status
## Output
```
Created: docs/{project}/{slug}.md
Status: draft
Sections: {filled}/{total}
```
## Export (Optional)
Supports `--docx`, `--pdf` flags. See `.claude/rules/export-formats.md` for layout specs and workflow. Complete normal processing first, then generate the formatted file.
