Initial commit

commands/update-docs.md

@@ -0,0 +1,47 @@
+---
+description: Update or regenerate README and CLAUDE.md documentation for a plugin
+argument-hint: plugin-path
+---
+
+Update or regenerate comprehensive documentation for the plugin at $1 (or current directory if not specified).
+
+## Process
+
+1. **Read all plugin components:**
+   - plugin.json (metadata)
+   - All files in agents/, commands/, skills/, hooks/
+   - Existing README.md and CLAUDE.md (if present)
+
+2. **Analyze the plugin:**
+   - Core purpose and value proposition
+   - Features and capabilities
+   - Component architecture and relationships
+   - Usage patterns and workflows
+   - Development conventions and patterns
+
+3. **Generate/update README.md:**
+   - Plugin overview and description
+   - Features section (organize by component type)
+   - Installation instructions
+   - Quick start guide
+   - Usage examples for each component
+   - File structure reference
+   - Troubleshooting section
+   - Resources and links
+   - Follow existing Box Factory README patterns as reference
+
+4. **Generate/update CLAUDE.md:**
+   - Development philosophy and principles
+   - Component-specific patterns and conventions
+   - Decision frameworks (when to use what)
+   - Quality standards and checklists
+   - Anti-patterns (forbidden approaches)
+   - Architecture diagrams or patterns
+   - Follow existing Box Factory CLAUDE.md patterns as reference
+
+5. **Ensure quality:**
+   - Documentation matches actual implementation
+   - All components are documented
+   - Examples are accurate and tested
+   - Consistent tone and formatting
+   - No outdated or incorrect information