Restructure doc-generate.md to clearly distinguish between:
- Concise, directive instructions (what to create)
- Detailed reference examples (how to create it)
Changes:
- Add "How to Use This Tool" section explaining structure
- Rewrite Instructions section to be concise and directive (75 lines)
- Rename and relabel all examples with clear "Example N:" format
- Add purpose statements and "Implementation Example:" labels
- Keep all existing reference code intact
Addresses user feedback in issue #87 about ambiguity between
instructions and examples that could confuse LLMs and humans.
Closes#87
- Update terraform-specialist from opus to sonnet
- Update database-optimizer from opus to sonnet
- Update tdd-orchestrator from opus to sonnet
- Update tutorial-engineer from opus to sonnet
- Update README.md with new model distribution (Sonnet: 52, Opus: 20)
- Remove duplicate agents/README.md file
These agents are implementation-focused rather than reasoning-focused,
making Sonnet the more appropriate model choice. This change follows
feedback from PR #72 while maintaining our task-complexity-tier
philosophy.
- Update primary installation method to use full HTTPS URL
- Remove redundant manual installation section
- Simplify instructions to two commands
- Resolves SSH authentication issues reported in #85
Users were experiencing "Failed to clone marketplace repository" errors
when using the short format (wshobson/agents) because Claude Code
defaults to SSH cloning. Using the full HTTPS URL bypasses this issue.
- Replace Quick Start section with interactive /plugin command instructions
- Add note about using wshobson/agents as marketplace source
- Simplify installation steps to match actual UI prompts
- Keep Available Plugins section as reference
Major Updates:
- Add Plugin Marketplace as primary installation method (Available Oct 9, 2025)
- Show /plugin commands for installing workflow-based collections
- Reorganize structure: Installation → Agent Categories → Model Config → Usage
- Remove Migration section (not relevant for this PR)
- Fix heading hierarchy issues from merge
- Preserve all 83 agent details in comprehensive tables
- Add workflow and tool invocation examples with proper syntax
The README now highlights the new plugin marketplace feature while
maintaining complete agent documentation and technical specifications.
The migration guide referenced slash command syntax that won't work
until the plugin system is deployed. Removed to avoid user confusion.
The repository now focuses on what works today: 83 agents.
Reverted README to highlight the 83 agents which are the core feature.
Added small note about repository update with link to MIGRATION.md.
Updated all agent links to point to agents/ subdirectory.
The agents work now and are the primary value. Workflows/tools will
be documented in the plugin PR tomorrow.
Workflows and tools will be accessible via plugin system (coming soon).
For now, the README focuses on the 83 agents which are directly usable.
Changes:
- Removed /workflows: and /tools: invocation examples
- Updated multi-agent orchestration examples to show natural language
- Simplified migration guide to focus on what works now
- Plugin-based workflow/tool access will be documented in future PR
Documentation Updates:
- Add migration warning and quick links section to README
- Expand installation section with update instructions
- Create comprehensive MIGRATION.md guide with:
* Step-by-step migration process
* Before/after structure comparison
* Command syntax changes reference
* Common issues and solutions
* Testing instructions and rollback steps
- Document breaking changes in command invocation syntax
- Add troubleshooting resources and help links
This provides a smooth user experience for the major repository restructure.
Repository Restructure:
- Move all 83 agent .md files to agents/ subdirectory
- Add 15 workflow orchestrators from commands repo to workflows/
- Add 42 development tools from commands repo to tools/
- Update README for unified repository structure
The commands repository functionality is now fully integrated, providing
complete workflow orchestration and development tooling alongside agents.
Directory Structure:
- agents/ - 83 specialized AI agents
- workflows/ - 15 multi-agent orchestration commands
- tools/ - 42 focused development utilities
No breaking changes to agent functionality - all agents remain accessible
with same names and behavior. Adds workflow and tool commands for enhanced
multi-agent coordination capabilities.
Repository Restructure:
- Move all 83 agent .md files to agents/ subdirectory
- Add 15 workflow orchestrators from commands repo to workflows/
- Add 42 development tools from commands repo to tools/
- Update README for unified repository structure
This prepares the repository for unified plugin marketplace integration.
The commands repository functionality is now fully integrated, providing
complete workflow orchestration and development tooling alongside agents.
Directory Structure:
- agents/ - 83 specialized AI agents
- workflows/ - 15 multi-agent orchestration commands
- tools/ - 42 focused development utilities
No breaking changes to agent functionality - all agents remain accessible
with same names and behavior. Adds workflow and tool commands for enhanced
multi-agent coordination capabilities.
- Add comprehensive database-architect agent for data layer design
- Technology selection (SQL/NoSQL/TimeSeries/NewSQL)
- Schema design and data modeling
- Migration planning and strategy
- Indexing, caching, and scalability patterns
- Handles both greenfield and re-architecture
- Works BEFORE backend-architect in workflow
- Enhance backend-architect agent with modern patterns
- Expand from 31 to 283 lines with comprehensive capabilities
- Add GraphQL, gRPC, WebSockets, event-driven architectures
- Include resilience patterns, observability, and security
- Add testing strategies and deployment patterns
- Defer database design to database-architect
- Works AFTER database-architect in workflow
Closes#70
- Added observability-engineer to Performance & Observability section
- Updated total agent count from 82 to 83
- Renamed "Performance & Research" to "Performance & Observability"
- Updated Opus model count from 21 to 22 agents
- Added observability-engineer to Critical Analysis category in Opus section
- Add Google SRE methodology and Fortune 500 enterprise patterns
- Include GDPR compliance and container security monitoring
- Add OpenTelemetry ecosystem and vendor-neutral standards
- Include edge computing, IoT, and serverless monitoring
- Add business intelligence integration capabilities
- Add anomaly detection and predictive analytics
- Include root cause analysis automation
- Add intelligent alert clustering and noise reduction
- Include time series forecasting and capacity planning
- Add NLP for log analysis and MLOps integration
- Comprehensive coverage of 11 observability capability areas
- Supports Prometheus, Grafana, Jaeger, ELK stack, OpenTelemetry
- Includes SLI/SLO management, chaos engineering, and incident response
- Production-ready monitoring strategies and cost optimization
- Follows same quality standards as existing agents
- Addresses critical gap in production reliability expertise
- Updated agent count from 78 to 82
- Added 3 new security coding agents (backend, frontend, mobile) to Code Quality & Review section
- Added blockchain-developer agent to Specialized Domains section
- All new agents properly linked with descriptions
- Comprehensive coverage of 11 blockchain capability areas
- Supports Ethereum, Solana, Cosmos, and other major blockchains
- Includes DeFi, NFT, and enterprise blockchain patterns
- Production-ready security and auditing best practices
- Follows same quality standards as existing agents
- Addresses major gap in Web3 development expertise
- Shorten descriptions in all three security coder agents to 2-3 lines
- Ensure mobile-security-coder.md is complete and properly formatted
- Address overlap concerns with existing security-auditor.md
- All agents now use model: opus for security-critical tasks
- Change model from sonnet to opus for all three security coder agents
- Add clear differentiation from security-auditor with use-case boundaries
- Implement environment-specific clickjacking protection guidance
- Add WebView data cleanup recommendations for mobile security
- Standardize terminology to use 'allowlist' consistently
- Complete cross-platform security examples for mobile development
- Fix repetitive phrasing in behavioral traits
- Align all security practices with reference material requirements
- Convert all agent listings to professional tables
- Add structured tables with Agent, Model, and Description columns
- Reorganize model configuration section with distribution tables
- Enhance agent selection guide with task-based tables
- Maintain consistency with commands repository formatting
- Improve readability and information accessibility
- Keep all existing content while improving presentation
- Remove all emoji for cleaner professional appearance
- Reorganize content with logical categorical structure
- Improve technical clarity and concise descriptions
- Add clear hierarchy with consistent formatting
- Focus on functionality rather than marketing language
- Better organization of agents by functional domains
- Streamline model configuration section
- Enhance usage examples with technical focus
- Reduce content from 558 to 438 lines while maintaining all essential information
- Add new tdd-orchestrator agent for managing complete TDD workflows
- Enhance test-automator with dedicated TDD capabilities and metrics
- Add TDD excellence section with red-green-refactor cycle automation
- Include support for Chicago and London TDD schools
- Add property-based TDD approaches and BDD integration
- Include TDD cycle metrics tracking and compliance monitoring
- Update README with new agent and TDD examples
- Add comprehensive TDD usage examples and documentation
This enhancement provides full TDD orchestration capabilities across
the agent collection, enabling test-first development with automated
cycle management, metrics tracking, and multi-agent coordination.
Addresses issue #64: TDD workflow support
- Enhanced all agents with 2024/2025 best practices and modern tooling
- Standardized format with 8-12 detailed capability subsections per agent
- Added Django Pro and FastAPI Pro specialist agents
- Updated model assignments (Sonnet/Haiku) based on task complexity
- Integrated latest frameworks: React 19, Next.js 15, Flutter 3.x, Unity 6, etc.
- Enhanced infrastructure agents with GitOps, OpenTelemetry, service mesh
- Modernized AI/ML agents with LLM integration, RAG systems, vector databases
- Updated business agents with AI-powered tools and automation
- Refreshed all programming language agents with current ecosystem tools
- Enhanced documentation with comprehensive README reflecting all improvements
Total changes: 5,945 insertions, 1,443 deletions across 40 files
All agents now provide production-ready, enterprise-level expertise
