/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

1. Check Existing

- Search docs/{project}/.md for similar titles (or docs/general/.md if no project) - If found: Offer to edit or create new

1. Gather Context

- Search for related decisions/blockers

1. Interactive Drafting

- Prompt for each major section: - Problem statement - Goals / Non-goals - Requirements (P0/P1/P2) - Technical approach - Or accept full content at once

1. 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

1. Update References

- Add to project index if exists

1. 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.