moai-alfred-issue-labels
GitHub issue label configuration, label taxonomy, and workflow automation mapping for MoAI-ADK projects
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for GitHub issue management, featuring a standardized label taxonomy and automated workflow mapping. It enables development teams to maintain consistency in issue categorization, priority assignment, and response SLAs across multiple repositories, significantly improving project visibility and developer productivity through structured organization.
Use Cases
- Standardizing issue triage and classification using a multi-tier priority system (critical to low) to ensure high-impact bugs are addressed with appropriate urgency.
- Automating repository setup by deploying a consistent set of primary, priority, and status labels across new or existing MoAI-ADK projects.
- Implementing SLA-driven workflows where specific labels trigger automated actions, such as immediate notifications for critical issues or auto-assignment to specialized teams.
- Streamlining the creation of bug reports and feature requests via integrated CLI commands that automatically apply the correct taxonomy and metadata.
| name | moai-alfred-issue-labels |
|---|---|
| version | 1.1.0 |
| created | 2025-11-05 |
| updated | 2025-11-05 |
| status | active |
| description | GitHub issue label configuration, label taxonomy, and workflow automation mapping for MoAI-ADK projects |
| keywords | ['github', 'issues', 'labels', 'workflow', 'taxonomy', 'automation'] |
Alfred Issue Labels Skill
Skill Metadata
| Field | Value |
|---|---|
| Skill Name | moai-alfred-issue-labels |
| Version | 1.1.0 (2025-11-05) |
| Status | Active |
| Tier | Alfred |
| Purpose | Standardize GitHub issue labeling and workflow automation |
What It Does
Provides comprehensive GitHub issue label configuration, taxonomy management, and workflow automation mapping for MoAI-ADK projects. Ensures consistent issue categorization and priority management across all repositories.
Key capabilities:
- ✅ Standardized label taxonomy for all issue types
- ✅ Priority-based labeling system (critical/high/medium/low)
- ✅ Workflow automation mappings
- ✅ Consistent issue management across projects
- ✅ Integration with Alfred command workflows
When to Use
Automatic triggers:
- Creating new issues via
/alfred:9-feedback - Issue triage and classification
- Project setup and configuration
- Label management and cleanup
Manual reference:
- Understanding label taxonomy
- Setting up new repositories
- Training team members on issue management
- Customizing workflow automation
Label Taxonomy System
Bug Issues (--bug)
Primary Labels: bug, reported
Priority Labels:
priority-critical- System down, data loss riskpriority-high- Major feature brokenpriority-medium- Normal bug (default)priority-low- Minor issue, cosmetic
Usage Pattern:
/alfred:9-feedback --bug --priority-high "Login system broken"
Feature Request Issues (--feature)
Primary Labels: feature-request, enhancement
Priority Labels:
priority-critical- Blocking, must implement immediatelypriority-high- Important featurepriority-medium- Normal priority (default)priority-low- Nice to have
Usage Pattern:
/alfred:9-feedback --feature --priority-medium "Add dark mode support"
Improvement Issues (--improvement)
Primary Labels: improvement, enhancement
Priority Labels:
priority-critical- Critical refactoring neededpriority-high- Important improvementpriority-medium- Normal priority (default)priority-low- Technical debt, can wait
Question/Discussion Issues (--question)
Primary Labels: question, help-wanted, discussion
Usage Patterns:
- Technical questions and clarifications
- Architecture discussions
- Feature feedback and suggestions
- Community engagement
Workflow Automation Mappings
Label-Based Automation
Critical Priority:
- Immediate notification to maintainers
- Auto-assignment to lead developers
- SLA: 24-hour response time
High Priority:
- Enhanced visibility in project boards
- Auto-add to milestone planning
- SLA: 72-hour response time
Medium Priority:
- Standard workflow processing
- Regular backlog grooming
- Normal development cycle
Low Priority:
- Future consideration queue
- Community contribution opportunities
- Best-effort timeline
Integration with Alfred Commands
/alfred:9-feedback Command Integration
# Create bug report with automatic labeling
/alfred:9-feedback --bug --priority-high "Critical issue description"
# Create feature request
/alfred:9-feedback --feature --priority-medium "Feature description"
# Create improvement suggestion
/alfred:9-feedback --improvement --priority-low "Improvement idea"
Auto-Assignment Rules
- Bug issues → Assign to bug-fix team
- Feature requests → Assign to feature team
- Documentation → Assign to docs team
- Infrastructure → Assign to DevOps team
Best Practices
✅ DO:
- Always select appropriate primary label type
- Use priority labels consistently
- Provide detailed descriptions
- Link related issues with dependencies
- Update labels when issue scope changes
- Follow team response SLAs
❌ DON'T:
- Mix primary label types (bug + feature)
- Use priority labels without justification
- Leave issues unlabeled
- Ignore label-based automation
- Create custom labels without team consensus
Repository Setup
Required Labels (Minimum Set)
# Primary type labels
bug, feature-request, improvement, question, documentation
# Priority labels
priority-critical, priority-high, priority-medium, priority-low
# Status labels
needs-triage, in-progress, blocked, ready-for-review, done
Optional Enhanced Labels
# Team labels
team-frontend, team-backend, team-devops, team-docs
# Component labels
component-ui, component-api, component-database, component-auth
# Type-specific labels
performance, security, accessibility, testing, refactoring
Quality Metrics
Label Compliance Rate: Target >95%
- Issues with proper primary label
- Issues with appropriate priority
- Response time compliance by priority
Automation Success Rate: Target >90%
- Correct auto-assignments
- Proper workflow routing
- SLA compliance tracking
Learn more in reference.md for complete label definitions, automation workflows, and team configuration details.
Related Skills:
moai-alfred-workflow- Issue workflow managementmoai-alfred-agent-guide- Team coordinationmoai-foundation-specs- Requirements management