davila7--claude-code-templates/dashboard/public/component-content/commands/documentation/generate-api-documentation.json

{"content": "---\nallowed-tools: Read, Write, Edit, Bash\nargument-hint: [output-format] | --swagger-ui | --redoc | --postman | --insomnia | --multi-format\ndescription: Auto-generate API reference documentation with multiple output formats and automated deployment\n---\n\n# Automated API Documentation Generator\n\nAuto-generate API reference documentation: $ARGUMENTS\n\n## Current API Infrastructure\n\n- Code annotations: !`grep -r \"@api\\|@swagger\\|@doc\" src/ 2>/dev/null | wc -l` annotations found\n- API framework: @package.json or detect from imports\n- Existing specs: !`find . -name \"*spec*.yaml\" -o -name \"*spec*.json\" | head -3`\n- Documentation tools: !`grep -E \"swagger|redoc|postman\" package.json 2>/dev/null || echo \"None detected\"`\n- CI/CD pipeline: @.github/workflows/ (if exists)\n\n## Task\n\nSetup automated API documentation generation with modern tooling:\n\n1. **API Documentation Strategy Analysis**\n   - Analyze current API structure and endpoints\n   - Identify documentation requirements (REST, GraphQL, gRPC, etc.)\n   - Assess existing code annotations and documentation\n   - Determine documentation output formats and hosting requirements\n   - Plan documentation automation and maintenance strategy\n\n2. **Documentation Tool Selection**\n   - Choose appropriate API documentation tools:\n     - **OpenAPI/Swagger**: REST API documentation with Swagger UI\n     - **Redoc**: Modern OpenAPI documentation renderer\n     - **GraphQL**: GraphiQL, Apollo Studio, GraphQL Playground\n     - **Postman**: API documentation with collections\n     - **Insomnia**: API documentation and testing\n     - **API Blueprint**: Markdown-based API documentation\n     - **JSDoc/TSDoc**: Code-first documentation generation\n   - Consider factors: API type, team workflow, hosting, interactivity\n\n3. **Code Annotation and Schema Definition**\n   - Add comprehensive code annotations for API endpoints\n   - Define request/response schemas and data models\n   - Add parameter descriptions and validation rules\n   - Document authentication and authorization requirements\n   - Add example requests and responses\n\n4. **API Specification Generation**\n   - Set up automated API specification generation from code\n   - Configure OpenAPI/Swagger specification generation\n   - Set up schema validation and consistency checking\n   - Configure API versioning and changelog generation\n   - Set up specification file management and version control\n\n5. **Interactive Documentation Setup**\n   - Configure interactive API documentation with try-it-out functionality\n   - Set up API testing and example execution\n   - Configure authentication handling in documentation\n   - Set up request/response validation and examples\n   - Configure API endpoint categorization and organization\n\n6. **Documentation Content Enhancement**\n   - Add comprehensive API guides and tutorials\n   - Create authentication and authorization documentation\n   - Add error handling and status code documentation\n   - Create SDK and client library documentation\n   - Add rate limiting and usage guidelines\n\n7. **Documentation Hosting and Deployment**\n   - Set up documentation hosting and deployment\n   - Configure documentation website generation and styling\n   - Set up custom domain and SSL configuration\n   - Configure documentation search and navigation\n   - Set up documentation analytics and usage tracking\n\n8. **Automation and CI/CD Integration**\n   - Configure automated documentation generation in CI/CD pipeline\n   - Set up documentation deployment automation\n   - Configure documentation validation and quality checks\n   - Set up documentation change detection and notifications\n   - Configure documentation testing and link validation\n\n9. **Multi-format Documentation Generation**\n   - Generate documentation in multiple formats (HTML, PDF, Markdown)\n   - Set up downloadable documentation packages\n   - Configure offline documentation access\n   - Set up documentation API for programmatic access\n   - Configure documentation syndication and distribution\n\n10. **Maintenance and Quality Assurance**\n    - Set up documentation quality monitoring and validation\n    - Configure documentation feedback and improvement workflows\n    - Set up documentation analytics and usage metrics\n    - Create documentation maintenance procedures and guidelines\n    - Train team on documentation best practices and tools\n    - Set up documentation review and approval processes"}