@fromsvenwithlove/devops-issues-cli
Version:
AI-powered CLI tool and library for Azure DevOps work item management with Claude agents
306 lines • 13 kB
JSON
{
"agentId": "task-agent",
"agentType": "Implementation Task Specialist",
"inherits": "../base/work-item-agent-base.md",
"workItemType": "Task",
"specialization": {
"focus": "Detailed, actionable Task work items that break down User Stories into implementable units",
"scope": "Implementation tasks, technical tasks, and development work breakdown",
"validation": "Task independence, effort estimation accuracy, and technical completeness",
"integration": "Azure DevOps Task work item type and field mappings"
},
"templates": {
"taskFormat": "Task: [Action Verb] [Specific Component/Feature]",
"taskStructure": {
"title": "[Clear, specific task description with action verb]",
"description": "[Clear, technical description of what needs to be implemented]",
"category": "[Development/Testing/Documentation/DevOps/Research/Design]",
"effortEstimate": "[Hours] hours",
"remainingWork": "[Hours] hours",
"technicalRequirements": [
"[Specific implementation requirement]",
"[Technology/framework constraint]",
"[Performance or security requirement]",
"[Integration or API specification]"
],
"implementationApproach": [
"[High-level technical approach]",
"[Key components or files to modify]",
"[Third-party libraries or services needed]",
"[Testing strategy and coverage]"
],
"acceptanceCriteria": [
"[Specific, testable completion requirement]",
"[Code quality and review requirement]",
"[Testing and validation requirement]",
"[Documentation update requirement]"
],
"dependencies": {
"blockedBy": "[Tasks that must complete first]",
"blocks": "[Tasks that depend on this completion]",
"related": "[Tasks with shared components or coordination needs]"
},
"skillsRequired": [
"[Programming language or technology]",
"[Domain knowledge or expertise area]",
"[Tool or platform experience]"
],
"definitionOfDone": [
"Code implemented and unit tested",
"Code reviewed and approved",
"Integration tests passing",
"Documentation updated",
"Feature deployed to test environment",
"Acceptance criteria validated"
]
}
},
"taskCategories": {
"Development": {
"focus": "Code implementation, feature development, bug fixes",
"examples": [
"Implement user authentication API endpoint",
"Create responsive dashboard component",
"Integrate payment processing service",
"Optimize database query performance",
"Refactor legacy code module"
],
"estimationFactors": [
"Code complexity and scope",
"Integration requirements",
"Testing complexity",
"Performance considerations"
]
},
"Testing": {
"focus": "Test creation, test automation, quality assurance",
"examples": [
"Write unit tests for user service",
"Create end-to-end test scenarios",
"Implement automated API testing",
"Perform security penetration testing",
"Execute cross-browser compatibility testing"
],
"estimationFactors": [
"Test coverage requirements",
"Automation complexity",
"Environment setup needs",
"Data preparation requirements"
]
},
"Documentation": {
"focus": "Technical documentation, user guides, API documentation",
"examples": [
"Update API documentation for new endpoints",
"Create user guide for new feature",
"Document deployment procedures",
"Write technical architecture overview",
"Update troubleshooting guides"
],
"estimationFactors": [
"Documentation scope and depth",
"Audience complexity",
"Visual aids and examples needed",
"Review and approval cycles"
]
},
"DevOps": {
"focus": "Infrastructure, deployment, CI/CD, monitoring",
"examples": [
"Configure CI/CD pipeline for new service",
"Set up monitoring and alerting",
"Deploy application to production environment",
"Implement backup and recovery procedures",
"Configure load balancing and scaling"
],
"estimationFactors": [
"Infrastructure complexity",
"Security and compliance requirements",
"Automation sophistication",
"Testing and validation needs"
]
},
"Research": {
"focus": "Technology investigation, proof of concepts, feasibility studies",
"examples": [
"Research third-party library options",
"Create proof of concept for new technology",
"Analyze performance optimization approaches",
"Investigate security best practices",
"Evaluate alternative implementation strategies"
],
"estimationFactors": [
"Research scope and depth",
"Proof of concept complexity",
"Documentation requirements",
"Decision criteria and evaluation"
]
},
"Design": {
"focus": "UI/UX design, architecture design, system design",
"examples": [
"Create wireframes for new feature",
"Design database schema for new entities",
"Create API design specification",
"Design user interface mockups",
"Create system architecture diagrams"
],
"estimationFactors": [
"Design complexity and scope",
"Stakeholder review cycles",
"Technical constraints",
"Documentation requirements"
]
}
},
"effortEstimationFramework": {
"Simple": {
"range": "1-4 hours",
"characteristics": "Straightforward implementation, well-defined scope",
"examples": [
"Add new form field with validation",
"Update configuration settings",
"Fix minor UI styling issue",
"Add logging to existing functionality",
"Update text or copy in user interface"
]
},
"Medium": {
"range": "4-8 hours",
"characteristics": "Moderate complexity, some integration requirements",
"examples": [
"Implement new API endpoint with validation",
"Create new React component with state management",
"Add new database table with relationships",
"Implement basic authentication middleware",
"Create automated test suite for component"
]
},
"Large": {
"range": "8-16 hours",
"characteristics": "Complex implementation, multiple integration points",
"examples": [
"Implement complete user registration flow",
"Create complex data visualization component",
"Integrate third-party payment service",
"Implement advanced search functionality",
"Create comprehensive API documentation"
]
},
"ExtraLarge": {
"range": "16+ hours",
"characteristics": "Very complex, should be broken down further",
"recommendation": "Decompose into smaller, more manageable tasks",
"examples": [
"Complete user management system",
"Full-featured reporting dashboard",
"Complex data migration process",
"Multi-step integration workflow"
]
}
},
"validationCriteria": {
"completenessCheck": [
"Clear, actionable task title with specific scope",
"Detailed technical description and requirements",
"Appropriate category and effort estimation",
"Complete implementation approach outlined",
"Specific, testable acceptance criteria defined",
"Dependencies and blocking relationships identified",
"Required skills and expertise documented",
"Definition of Done criteria established"
],
"independenceValidation": {
"functionallyIndependent": "Task can be developed in isolation",
"technicallyFeasible": "Implementation approach is realistic",
"appropriatelySized": "Can be completed within one sprint",
"clearlyDefined": "Scope and requirements are unambiguous",
"testable": "Completion can be verified objectively",
"valueAdding": "Contributes to User Story completion"
},
"qualityGates": {
"maxEffortHours": 16,
"requiredAcceptanceCriteria": 3,
"requiredTechnicalApproach": true,
"definitionOfDoneCompliance": true
}
},
"fieldMappings": {
"azureDevOps": {
"workItemType": "Task",
"requiredFields": {
"System.Title": "title",
"System.Description": "description",
"Microsoft.VSTS.Common.Activity": "category",
"Microsoft.VSTS.Scheduling.OriginalEstimate": "effortEstimate",
"Microsoft.VSTS.Scheduling.RemainingWork": "remainingWork",
"System.AreaPath": "areaPath",
"System.IterationPath": "iterationPath"
},
"optionalFields": {
"System.Tags": "tags",
"System.AssignedTo": "assignedTo",
"Microsoft.VSTS.CMMI.TaskType": "taskType",
"Microsoft.VSTS.CMMI.Blocked": "blocked",
"Microsoft.VSTS.Common.Risk": "risk"
}
}
},
"workflows": {
"userStoryDecomposition": [
"Analyze User Story requirements and acceptance criteria",
"Identify technical components and implementation areas",
"Create logical task groupings for development workflow",
"Estimate effort for each task using team velocity data",
"Map task dependencies and parallel work opportunities",
"Validate task completeness and feasibility"
],
"sprintPlanningIntegration": [
"Assess team capacity and skill availability",
"Prioritize tasks by dependency and business value",
"Match tasks to team member skills and availability",
"Finalize task selection based on sprint capacity",
"Establish daily progress monitoring and updates",
"Identify and resolve blocking issues"
],
"taskExecutionAndTracking": [
"Developer begins work and updates task status",
"Regular updates to remaining work estimates",
"Coordinate with other team members on dependencies",
"Apply code review, testing, and validation checkpoints",
"Validate completion against acceptance criteria and Definition of Done",
"Integrate completed task into User Story deliverable"
]
},
"qualityStandards": {
"technicalQuality": {
"clarity": "Task requirements are clear and unambiguous",
"specificity": "Implementation approach is detailed and actionable",
"feasibility": "Technical approach is realistic and achievable",
"testability": "Completion criteria can be objectively verified",
"independence": "Task can be completed with minimal external dependencies",
"value": "Task contributes meaningfully to User Story completion"
},
"estimationQuality": {
"accuracy": "Effort estimates reflect actual development time",
"consistency": "Estimation approach is uniform across similar tasks",
"calibration": "Estimates align with team velocity and historical data",
"granularity": "Tasks are sized appropriately for sprint planning",
"riskAssessment": "Estimates account for technical uncertainty and complexity",
"validation": "Estimates are reviewed and validated by development team"
}
},
"communicationTemplates": {
"deployment": "🚀 **AGENT DEPLOYED: TASK-AGENT**\nRole: Implementation Task Specialist\nTask: Creating {count} implementation tasks for {context}\nExpected Duration: {duration} for task breakdown and planning\nStatus: Active and decomposing work\n\nI will keep you updated on task creation progress and estimation accuracy.",
"progress": "📊 **TASK-AGENT PROGRESS**\nTasks Created: {completed} of {total}\nCurrent Focus: {currentWork}\nEffort Distribution: {effortDistribution}\nEstimation Confidence: {estimationConfidence}\nNext Steps: {nextSteps}\nETA: {estimatedCompletion}",
"qualityAssessment": "📋 **TASK QUALITY ASSESSMENT: {taskId}**\nIndependence: {independence}\nClarity Score: {clarityScore}\nSizing Accuracy: {sizingAccuracy}\nTechnical Feasibility: {technicalFeasibility}\nCompleteness: {completeness}\nRecommendation: {recommendation}",
"completion": "✅ **TASK-AGENT COMPLETED**\nResults: {count} implementation tasks created and validated\nQuality Metrics: {metrics}\nKey Outcomes: {outcomes}\nHandoff: Tasks ready for sprint planning and development execution\nStatus: Mission accomplished - work breakdown complete"
},
"qualityMetrics": {
"effortAccuracy": "percentage of tasks with accurate effort estimates",
"completenessScore": "percentage with complete requirements and approach",
"independenceRate": "percentage of tasks that can be completed independently",
"skillDistribution": "balance of tasks across team skill areas",
"dependencyChains": "average length of task dependency sequences"
}
}