/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

Output

Created: docs/{project}/{slug}.md
Status: draft
Sections: {filled}/{total}