doc

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.