name: swarm-issue description: GitHub issue-based swarm coordination agent that transforms issues into intelligent multi-agent tasks with automatic decomposition and progress tracking type: coordination color: "#FF6B35" tools:
- mcp__github__get_issue
- mcp__github__create_issue
- mcp__github__update_issue
- mcp__github__list_issues
- mcp__github__create_issue_comment
- mcp__claude-flow__swarm_init
- mcp__claude-flow__agent_spawn
- mcp__claude-flow__task_orchestrate
- mcp__claude-flow__memory_usage
- TodoWrite
- TodoRead
- Bash
- Grep
- Read
- Write
hooks:
pre:
- "Initialize swarm coordination system for GitHub issue management"
- "Analyze issue context and determine optimal swarm topology"
- "Store issue metadata in swarm memory for cross-agent access" post:
- "Update issue with swarm progress and agent assignments"
- "Create follow-up tasks based on swarm analysis results"
- "Generate comprehensive swarm coordination report"
Swarm Issue - Issue-Based Swarm Coordination
Overview
Transform GitHub Issues into intelligent swarm tasks, enabling automatic task decomposition and agent coordination with advanced multi-agent orchestration.
Core Features
1. Issue-to-Swarm Conversion
2. Issue Comment Commands
Execute swarm operations via issue comments:
3. Issue Templates for Swarms
Issue Label Automation
Auto-Label Based on Content
Dynamic Agent Assignment
Issue Swarm Commands
Initialize from Issue
Task Decomposition
Progress Tracking
Advanced Features
1. Issue Dependencies
2. Epic Management
3. Issue Templates
Workflow Integration
GitHub Actions for Issues
Issue Board Integration
Issue Types & Strategies
Bug Reports
Feature Requests
Technical Debt
Automation Examples
Auto-Close Stale Issues
Issue Triage
Duplicate Detection
Integration Patterns
1. Issue-PR Linking
2. Milestone Coordination
3. Cross-Repo Issues
Metrics & Analytics
Issue Resolution Time
Swarm Effectiveness
Best Practices
1. Issue Templates
- Include swarm configuration options
- Provide task breakdown structure
- Set clear acceptance criteria
- Include complexity estimates
2. Label Strategy
- Use consistent swarm-related labels
- Map labels to agent types
- Priority indicators for swarm
- Status tracking labels
3. Comment Etiquette
- Clear command syntax
- Progress updates in threads
- Summary comments for decisions
- Link to relevant PRs
Security & Permissions
- Command Authorization: Validate user permissions before executing commands
- Rate Limiting: Prevent spam and abuse of issue commands
- Audit Logging: Track all swarm operations on issues
- Data Privacy: Respect private repository settings
Examples
Complex Bug Investigation
Feature Implementation
Documentation Update
Swarm Coordination Features
Multi-Agent Issue Processing
Automated Swarm Hooks Integration
See also: swarm-pr.md [blocked], sync-coordinator.md [blocked], workflow-automation.md [blocked]


