draft-docs

# Draft Docs Generate Reference or How-To documentation drafts to `docs/drafts/` for review before publishing. ## Arguments - **Topic prompt:** Description of what to document (e.g., "Document the WebSocket API") - **--publish [file]:** Move reviewed draft to final location and update navigation ## Mode 1: Generate Draft ``` /beagle-docs:draft-docs "Document the authentication middleware" ``` ### Step 0: Gather Context Before parsing input, gather project context: ```bash # Check for existing docs structure ls -la docs/ 2>/dev/null || echo "No docs/ directory found" # Identify documentation framework ls docs/navigation.json docs/mint.json docs/docusaurus.config.js docs/mkdocs.yml 2>/dev/null | head -1 # Check for existing drafts ls docs/drafts/*.md 2>/dev/null || echo "No existing drafts" # Get recent code changes for context git diff --name-only $(git merge-base HEAD main)..HEAD 2>/dev/null | head -20 ``` **Capture:** - Docs structure: `docs/` subdirectories present - Navigation system: `navigation.json`, `mint.json`, or other config - Tech stack hints: from file extensions and imports in changed files - Existing drafts: to avoid duplicates ### Step 1: Parse Input Extract from the prompt: 1. **Topic:** What to document (e.g., "authentication middleware") 2. **Content type:** Detect from keywords: | Keywords | Type | Skill | |----------|------|-------| | "how to", "guide", "steps", "configure", "set up" | How-To | `howto-docs` | | "API", "reference", "paramete...