mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
Update README usage section to highlight plugin slash commands
- Add comprehensive slash command documentation as primary interface - Include real command examples mapped to actual plugins in marketplace - Add 70+ categorized slash command reference (all real commands) - Show both command-based and natural language invocation patterns - Add tdd-workflows to Testing section for better discoverability - Provide detailed workflow orchestration examples with step breakdowns - Include command argument examples and discovery instructions All examples now use actual commands that exist in the plugin system (backend-development:feature-development, unit-testing:test-generate, etc.)
This commit is contained in:
Seth Hobson
243
README.md
243
README.md
@@ -199,11 +199,12 @@ Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best p
|
|||||||
| **full-stack-orchestration** | End-to-end feature orchestration | `/plugin install full-stack-orchestration` |
|
| **full-stack-orchestration** | End-to-end feature orchestration | `/plugin install full-stack-orchestration` |
|
||||||
| **tdd-workflows** | Test-driven development methodology | `/plugin install tdd-workflows` |
|
| **tdd-workflows** | Test-driven development methodology | `/plugin install tdd-workflows` |
|
||||||
|
|
||||||
### ✅ Testing (1 plugin)
|
### ✅ Testing (2 plugins)
|
||||||
|
|
||||||
| Plugin | Description | Install |
|
| Plugin | Description | Install |
|
||||||
| ---------------- | -------------------------------------------------- | ------------------------------ |
|
| ----------------- | -------------------------------------------------- | ------------------------------- |
|
||||||
| **unit-testing** | Automated unit test generation (Python/JavaScript) | `/plugin install unit-testing` |
|
| **unit-testing** | Automated unit test generation (Python/JavaScript) | `/plugin install unit-testing` |
|
||||||
|
| **tdd-workflows** | Test-driven development methodology | `/plugin install tdd-workflows` |
|
||||||
|
|
||||||
### 🔍 Quality (3 plugins)
|
### 🔍 Quality (3 plugins)
|
||||||
|
|
||||||
@@ -391,9 +392,33 @@ Each plugin contains:
|
|||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
### Using Plugin Slash Commands
|
||||||
|
|
||||||
|
After installing plugins, you can invoke their capabilities using **slash commands** - the primary interface for working with agents and workflows. Each plugin provides namespaced commands that you can run directly:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# List all available slash commands from installed plugins
|
||||||
|
/plugin
|
||||||
|
|
||||||
|
# Run a workflow command with arguments
|
||||||
|
/backend-development:feature-development user authentication with JWT
|
||||||
|
|
||||||
|
# Execute specialized tools
|
||||||
|
/unit-testing:test-generate src/auth/login.py
|
||||||
|
|
||||||
|
# Invoke security scans
|
||||||
|
/security-scanning:security-sast
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key benefits of slash commands:**
|
||||||
|
- **Direct invocation** - No need to describe what you want in natural language
|
||||||
|
- **Structured arguments** - Pass parameters explicitly for precise control
|
||||||
|
- **Composability** - Chain commands together for complex workflows
|
||||||
|
- **Discoverability** - Use `/plugin` to see all available commands
|
||||||
|
|
||||||
### Agent Invocation
|
### Agent Invocation
|
||||||
|
|
||||||
After installing plugins, agents are automatically available. Invoke them explicitly in natural language:
|
Agents can also be invoked through natural language when you need Claude to reason about which specialist to use:
|
||||||
|
|
||||||
```
|
```
|
||||||
"Use backend-architect to design the authentication API"
|
"Use backend-architect to design the authentication API"
|
||||||
@@ -403,41 +428,225 @@ After installing plugins, agents are automatically available. Invoke them explic
|
|||||||
|
|
||||||
Claude Code automatically selects and coordinates the appropriate agents based on your request.
|
Claude Code automatically selects and coordinates the appropriate agents based on your request.
|
||||||
|
|
||||||
### Multi-Agent Orchestration Examples
|
### Multi-Agent Workflow Examples
|
||||||
|
|
||||||
Plugins provide pre-configured multi-agent workflows that coordinate complex operations:
|
Plugins provide pre-configured multi-agent workflows accessible via slash commands:
|
||||||
|
|
||||||
**Full-Stack Development Plugin**
|
#### Full-Stack Development
|
||||||
|
|
||||||
```
|
```bash
|
||||||
|
# Command-based workflow invocation
|
||||||
|
/full-stack-orchestration:full-stack-feature "user dashboard with real-time analytics"
|
||||||
|
|
||||||
|
# Natural language alternative
|
||||||
"Implement user dashboard with real-time analytics"
|
"Implement user dashboard with real-time analytics"
|
||||||
```
|
```
|
||||||
|
|
||||||
→ backend-architect → graphql-architect → frontend-developer → mobile-developer → test-automator → security-auditor → performance-engineer → deployment-engineer
|
**Orchestration:** backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer
|
||||||
|
|
||||||
**Security Hardening Plugin**
|
**What happens:**
|
||||||
|
1. Database schema design with migrations
|
||||||
|
2. Backend API implementation (REST/GraphQL)
|
||||||
|
3. Frontend components with state management
|
||||||
|
4. Comprehensive test suite (unit/integration/E2E)
|
||||||
|
5. Security audit and hardening
|
||||||
|
6. CI/CD pipeline setup with feature flags
|
||||||
|
7. Observability and monitoring configuration
|
||||||
|
|
||||||
```
|
#### Security Hardening
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Comprehensive security assessment and remediation
|
||||||
|
/security-scanning:security-hardening --level comprehensive
|
||||||
|
|
||||||
|
# Natural language alternative
|
||||||
"Perform security audit and implement OWASP best practices"
|
"Perform security audit and implement OWASP best practices"
|
||||||
```
|
```
|
||||||
|
|
||||||
→ security-auditor → backend-security-coder → frontend-security-coder → mobile-security-coder → test-automator
|
**Orchestration:** security-auditor → backend-security-coder → frontend-security-coder → mobile-security-coder → test-automator
|
||||||
|
|
||||||
**Data/ML Pipeline Plugin**
|
#### Data/ML Pipeline
|
||||||
|
|
||||||
```
|
```bash
|
||||||
|
# ML feature development with production deployment
|
||||||
|
/machine-learning-ops:ml-pipeline "customer churn prediction model"
|
||||||
|
|
||||||
|
# Natural language alternative
|
||||||
"Build customer churn prediction model with deployment"
|
"Build customer churn prediction model with deployment"
|
||||||
```
|
```
|
||||||
|
|
||||||
→ data-scientist → data-engineer → ml-engineer → mlops-engineer → ai-engineer → performance-engineer
|
**Orchestration:** data-scientist → data-engineer → ml-engineer → mlops-engineer → performance-engineer
|
||||||
|
|
||||||
**Incident Response Plugin**
|
#### Incident Response
|
||||||
|
|
||||||
```
|
```bash
|
||||||
|
# Smart debugging with root cause analysis
|
||||||
|
/incident-response:smart-fix "production memory leak in payment service"
|
||||||
|
|
||||||
|
# Natural language alternative
|
||||||
"Debug production memory leak and create runbook"
|
"Debug production memory leak and create runbook"
|
||||||
```
|
```
|
||||||
|
|
||||||
→ incident-responder → devops-troubleshooter → debugger → error-detective → observability-engineer
|
**Orchestration:** incident-responder → devops-troubleshooter → debugger → error-detective → observability-engineer
|
||||||
|
|
||||||
|
### Command Arguments and Options
|
||||||
|
|
||||||
|
Many slash commands support arguments for precise control:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Test generation for specific files
|
||||||
|
/unit-testing:test-generate src/api/users.py
|
||||||
|
|
||||||
|
# Feature development with methodology specification
|
||||||
|
/backend-development:feature-development OAuth2 integration with social login
|
||||||
|
|
||||||
|
# Security dependency scanning
|
||||||
|
/security-scanning:security-dependencies
|
||||||
|
|
||||||
|
# Component scaffolding
|
||||||
|
/frontend-mobile-development:component-scaffold UserProfile component with hooks
|
||||||
|
|
||||||
|
# TDD workflow cycle
|
||||||
|
/tdd-workflows:tdd-red User can reset password
|
||||||
|
/tdd-workflows:tdd-green
|
||||||
|
/tdd-workflows:tdd-refactor
|
||||||
|
|
||||||
|
# Smart debugging
|
||||||
|
/debugging-toolkit:smart-debug memory leak in checkout flow
|
||||||
|
|
||||||
|
# Python project scaffolding
|
||||||
|
/python-development:python-scaffold fastapi-microservice
|
||||||
|
```
|
||||||
|
|
||||||
|
### Combining Natural Language and Commands
|
||||||
|
|
||||||
|
You can mix both approaches for optimal flexibility:
|
||||||
|
|
||||||
|
```
|
||||||
|
# Start with a command for structured workflow
|
||||||
|
/full-stack-orchestration:full-stack-feature "payment processing"
|
||||||
|
|
||||||
|
# Then provide natural language guidance
|
||||||
|
"Ensure PCI-DSS compliance and integrate with Stripe"
|
||||||
|
"Add retry logic for failed transactions"
|
||||||
|
"Set up fraud detection rules"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Discovering Commands
|
||||||
|
|
||||||
|
Use these commands to explore available functionality:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# List all installed plugins and their commands
|
||||||
|
/plugin
|
||||||
|
|
||||||
|
# Install a specific plugin
|
||||||
|
/plugin install python-development
|
||||||
|
|
||||||
|
# View available commands in a plugin
|
||||||
|
# After installation, commands will be listed with the format:
|
||||||
|
# /plugin-name:command-name
|
||||||
|
```
|
||||||
|
|
||||||
|
### Real Command Examples by Category
|
||||||
|
|
||||||
|
**Development & Features:**
|
||||||
|
- `/backend-development:feature-development` - End-to-end backend feature development
|
||||||
|
- `/full-stack-orchestration:full-stack-feature` - Complete full-stack feature implementation
|
||||||
|
- `/multi-platform-apps:multi-platform` - Cross-platform app development coordination
|
||||||
|
|
||||||
|
**Testing & Quality:**
|
||||||
|
- `/unit-testing:test-generate` - Generate comprehensive unit tests
|
||||||
|
- `/tdd-workflows:tdd-cycle` - Complete TDD red-green-refactor cycle
|
||||||
|
- `/tdd-workflows:tdd-red` - Write failing tests first
|
||||||
|
- `/tdd-workflows:tdd-green` - Implement code to pass tests
|
||||||
|
- `/tdd-workflows:tdd-refactor` - Refactor with passing tests
|
||||||
|
|
||||||
|
**Code Quality & Review:**
|
||||||
|
- `/code-review-ai:ai-review` - AI-powered code review
|
||||||
|
- `/comprehensive-review:full-review` - Multi-perspective analysis
|
||||||
|
- `/comprehensive-review:pr-enhance` - Enhance pull requests
|
||||||
|
|
||||||
|
**Debugging & Troubleshooting:**
|
||||||
|
- `/debugging-toolkit:smart-debug` - Interactive smart debugging
|
||||||
|
- `/incident-response:incident-response` - Production incident management
|
||||||
|
- `/incident-response:smart-fix` - Automated incident resolution
|
||||||
|
- `/error-debugging:error-analysis` - Deep error analysis
|
||||||
|
- `/error-debugging:error-trace` - Stack trace debugging
|
||||||
|
- `/error-diagnostics:smart-debug` - Smart diagnostic debugging
|
||||||
|
- `/distributed-debugging:debug-trace` - Distributed system tracing
|
||||||
|
|
||||||
|
**Security:**
|
||||||
|
- `/security-scanning:security-hardening` - Comprehensive security hardening
|
||||||
|
- `/security-scanning:security-sast` - Static application security testing
|
||||||
|
- `/security-scanning:security-dependencies` - Dependency vulnerability scanning
|
||||||
|
- `/security-compliance:compliance-check` - SOC2/HIPAA/GDPR compliance
|
||||||
|
- `/frontend-mobile-security:xss-scan` - XSS vulnerability scanning
|
||||||
|
|
||||||
|
**Infrastructure & Deployment:**
|
||||||
|
- `/observability-monitoring:monitor-setup` - Setup monitoring infrastructure
|
||||||
|
- `/observability-monitoring:slo-implement` - Implement SLO/SLI metrics
|
||||||
|
- `/deployment-validation:config-validate` - Pre-deployment validation
|
||||||
|
- `/cicd-automation:workflow-automate` - CI/CD pipeline automation
|
||||||
|
|
||||||
|
**Data & ML:**
|
||||||
|
- `/machine-learning-ops:ml-pipeline` - ML training pipeline orchestration
|
||||||
|
- `/data-engineering:data-pipeline` - ETL/ELT pipeline construction
|
||||||
|
- `/data-engineering:data-driven-feature` - Data-driven feature development
|
||||||
|
|
||||||
|
**Documentation:**
|
||||||
|
- `/code-documentation:doc-generate` - Generate comprehensive documentation
|
||||||
|
- `/code-documentation:code-explain` - Explain code functionality
|
||||||
|
- `/documentation-generation:doc-generate` - OpenAPI specs, diagrams, tutorials
|
||||||
|
|
||||||
|
**Refactoring & Maintenance:**
|
||||||
|
- `/code-refactoring:refactor-clean` - Code cleanup and refactoring
|
||||||
|
- `/code-refactoring:tech-debt` - Technical debt management
|
||||||
|
- `/codebase-cleanup:deps-audit` - Dependency auditing
|
||||||
|
- `/codebase-cleanup:tech-debt` - Technical debt reduction
|
||||||
|
- `/framework-migration:legacy-modernize` - Legacy code modernization
|
||||||
|
- `/framework-migration:code-migrate` - Framework migration
|
||||||
|
- `/framework-migration:deps-upgrade` - Dependency upgrades
|
||||||
|
|
||||||
|
**Database:**
|
||||||
|
- `/database-migrations:sql-migrations` - SQL migration automation
|
||||||
|
- `/database-migrations:migration-observability` - Migration monitoring
|
||||||
|
- `/database-cloud-optimization:cost-optimize` - Database and cloud optimization
|
||||||
|
|
||||||
|
**Git & PR Workflows:**
|
||||||
|
- `/git-pr-workflows:pr-enhance` - Enhance pull request quality
|
||||||
|
- `/git-pr-workflows:onboard` - Team onboarding automation
|
||||||
|
- `/git-pr-workflows:git-workflow` - Git workflow automation
|
||||||
|
|
||||||
|
**Project Scaffolding:**
|
||||||
|
- `/python-development:python-scaffold` - FastAPI/Django project setup
|
||||||
|
- `/javascript-typescript:typescript-scaffold` - Next.js/React + Vite setup
|
||||||
|
- `/systems-programming:rust-project` - Rust project scaffolding
|
||||||
|
|
||||||
|
**AI & LLM Development:**
|
||||||
|
- `/llm-application-dev:langchain-agent` - LangChain agent development
|
||||||
|
- `/llm-application-dev:ai-assistant` - AI assistant implementation
|
||||||
|
- `/llm-application-dev:prompt-optimize` - Prompt engineering optimization
|
||||||
|
- `/agent-orchestration:multi-agent-optimize` - Multi-agent optimization
|
||||||
|
- `/agent-orchestration:improve-agent` - Agent improvement workflows
|
||||||
|
|
||||||
|
**Testing & Performance:**
|
||||||
|
- `/performance-testing-review:ai-review` - Performance analysis
|
||||||
|
- `/application-performance:performance-optimization` - App optimization
|
||||||
|
|
||||||
|
**Team Collaboration:**
|
||||||
|
- `/team-collaboration:issue` - Issue management automation
|
||||||
|
- `/team-collaboration:standup-notes` - Standup notes generation
|
||||||
|
|
||||||
|
**Accessibility:**
|
||||||
|
- `/accessibility-compliance:accessibility-audit` - WCAG compliance auditing
|
||||||
|
|
||||||
|
**API Development:**
|
||||||
|
- `/api-testing-observability:api-mock` - API mocking and testing
|
||||||
|
|
||||||
|
**Context Management:**
|
||||||
|
- `/context-management:context-save` - Save conversation context
|
||||||
|
- `/context-management:context-restore` - Restore previous context
|
||||||
|
|
||||||
## Agent Categories
|
## Agent Categories
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user