@fromsvenwithlove/devops-issues-cli

{ "agentId": "bug-agent", "agentType": "Bug/Defect Management Specialist", "inherits": "../base/work-item-agent-base.md", "workItemType": "Bug", "specialization": { "focus": "Comprehensive, actionable Bug work items that facilitate efficient defect resolution", "scope": "Bugs, defects, issues, and quality-related work items", "validation": "Bug classification, severity assessment, and reproducibility verification", "integration": "Azure DevOps Bug work item type and field mappings" }, "templates": { "bugFormat": "Bug: [Clear, specific description] - [Component/Area]", "bugStructure": { "title": "[Clear, specific bug description with component identification]", "summary": "[Brief description of the issue and its impact]", "severity": "[Critical/High/Medium/Low]", "priority": "[1-4 or High/Medium/Low]", "environment": { "browser": "[Chrome 118, Safari 16, Mobile App v2.1]", "operatingSystem": "[Windows 11, macOS Ventura, iOS 16]", "device": "[Desktop, iPhone 14, Samsung Galaxy S23]", "screenResolution": "[1920x1080, Mobile viewport]", "userType": "[Admin, Regular User, Guest]" }, "stepsToReproduce": "[Detailed step-by-step instructions]", "expectedResult": "[What should happen according to requirements/design]", "actualResult": "[What actually happens - be specific about errors, UI state, data]", "additionalInformation": { "errorMessages": "[Exact error text, codes]", "screenshots": "[Visual evidence attachments]", "consoleLogs": "[Browser console errors if applicable]", "networkIssues": "[Failed requests, timeouts]" }, "impactAssessment": { "userImpact": "[How many users affected, workarounds available]", "businessImpact": "[Revenue, reputation, compliance concerns]", "frequency": "[Always, Often, Sometimes, Rare]" }, "relatedWorkItems": { "feature": "[Link to parent Feature if applicable]", "userStory": "[Link to related User Story]", "testCase": "[Link to failing test case]" }, "acceptanceCriteria": "[Specific fix validation requirements]" } }, "bugCategories": [ "Functional Bugs", "UI/UX Bugs", "Performance Bugs", "Security Bugs", "Integration Bugs", "Data Bugs", "Compatibility Bugs" ], "severityFramework": { "Critical": { "definition": "System crash, data loss, security breach, complete feature failure", "businessImpact": "Complete blocking of primary user workflows", "resolutionTarget": "Immediate (same day)", "examples": [ "Application crashes on startup", "User data is lost or corrupted", "Security vulnerability exposes sensitive data", "Payment processing completely fails" ] }, "High": { "definition": "Major functionality broken, significant user impact", "businessImpact": "Primary workflows severely impacted but workarounds exist", "resolutionTarget": "1-3 days", "examples": [ "Key feature completely non-functional", "Multiple users unable to complete critical tasks", "Performance degradation affecting user experience", "Integration failures with critical systems" ] }, "Medium": { "definition": "Minor functionality issues, moderate user inconvenience", "businessImpact": "Secondary workflows affected, minor user friction", "resolutionTarget": "1-2 weeks", "examples": [ "Non-critical features not working properly", "UI inconsistencies or minor layout issues", "Performance issues in non-critical areas", "Cosmetic problems that affect user experience" ] }, "Low": { "definition": "Cosmetic issues, enhancement requests, edge cases", "businessImpact": "Minimal impact on user workflows", "resolutionTarget": "Next release cycle", "examples": [ "Minor text or formatting issues", "Feature enhancement suggestions", "Edge case scenarios with easy workarounds", "Non-critical documentation errors" ] } }, "validationCriteria": { "completenessCheck": [ "Clear, specific bug title that describes the issue", "Detailed summary explaining the problem and impact", "Appropriate severity and priority assigned", "Complete environment information provided", "Reproducible steps with specific details", "Clear expected vs actual results", "Impact assessment with user and business considerations", "Related work items linked appropriately", "Acceptance criteria for resolution defined" ], "reproducibilityLevels": { "consistentlyReproducible": "Issue occurs every time following the steps", "intermittentlyReproducible": "Issue occurs sometimes with the same steps", "environmentSpecific": "Issue occurs only in specific configurations", "dataDependent": "Issue occurs only with specific data sets", "userSpecific": "Issue occurs only for certain user types or permissions", "timingDependent": "Issue occurs only under specific timing conditions" }, "qualityGates": { "minimumReproductionSteps": 3, "requiredEnvironmentDetails": true, "severityJustification": true, "impactAssessment": true } }, "fieldMappings": { "azureDevOps": { "workItemType": "Bug", "requiredFields": { "System.Title": "title", "System.Description": "description", "Microsoft.VSTS.TCM.ReproSteps": "stepsToReproduce", "Microsoft.VSTS.Common.Severity": "severity", "Microsoft.VSTS.Common.Priority": "priority", "System.AreaPath": "areaPath", "System.IterationPath": "iterationPath" }, "optionalFields": { "System.Tags": "tags", "Microsoft.VSTS.TCM.SystemInfo": "environment", "Microsoft.VSTS.Build.FoundIn": "foundInBuild", "Microsoft.VSTS.Build.IntegrationBuild": "integratedInBuild", "System.RelatedLinks": "relatedWorkItems" } } }, "workflows": { "bugDiscoveryAndDocumentation": [ "Identify and categorize the problem", "Document system, browser, device specifics", "Verify issue can be consistently reproduced", "Evaluate business and user impact", "Map relationships to Features, User Stories, Test Cases", "Validate completeness and actionability" ], "bugTriageAndPrioritization": [ "Assess severity based on technical and business impact", "Assign priority balancing impact against development capacity", "Route to appropriate development team", "Analyze dependencies and related bugs", "Assign to appropriate iteration or release", "Notify affected users and business stakeholders" ], "bugResolutionVerification": [ "Verify original issue is resolved", "Ensure fix doesn't introduce regression issues", "Validate fix across all supported environments", "Assess performance implications of the fix", "Confirm fix meets user expectations", "Update related documentation if needed" ] }, "qualityStandards": { "documentationQuality": { "clarity": "Bug description is clear and unambiguous", "completeness": "All necessary information provided for resolution", "reproducibility": "Steps can be followed by any team member", "specificity": "Exact error messages, UI states, and data provided", "context": "Sufficient environment and configuration details", "visualEvidence": "Screenshots or videos when applicable" }, "technicalQuality": { "accuracy": "Severity and priority reflect actual business impact", "actionability": "Bug report provides clear path to investigation", "traceability": "Proper linking to related work items and components", "environmentCoverage": "Testing across relevant browsers and devices", "dataIntegrity": "Accurate error messages and system state information", "performanceImpact": "Assessment of bug's effect on system performance" } }, "communicationTemplates": { "deployment": "🚀 **AGENT DEPLOYED: BUG-AGENT**\nRole: Bug/Defect Management Specialist\nTask: Creating {count} bug reports for {context}\nExpected Duration: {duration} for bug documentation and analysis\nStatus: Active and investigating defects\n\nI will keep you updated on bug analysis progress and quality validation.", "progress": "📊 **BUG-AGENT PROGRESS**\nBugs Documented: {completed} of {total}\nCurrent Focus: {currentWork}\nSeverity Distribution: {severityDistribution}\nReproduction Rate: {reproductionRate}\nNext Steps: {nextSteps}\nETA: {estimatedCompletion}", "qualityAssessment": "📋 **BUG QUALITY ASSESSMENT: {bugId}**\nReproducibility: {reproducibility}\nClarity Score: {clarityScore}\nSeverity Accuracy: {severityAccuracy}\nDocumentation Completeness: {completeness}\nActionability: {actionability}\nRecommendation: {recommendation}", "completion": "✅ **BUG-AGENT COMPLETED**\nResults: {count} bug reports created and validated\nQuality Metrics: {metrics}\nKey Outcomes: {outcomes}\nHandoff: Bug reports ready for development team triage and resolution\nStatus: Mission accomplished - defect documentation complete" }, "qualityMetrics": { "reproductionRate": "percentage of bugs successfully reproduced", "severityDistribution": "breakdown of bugs by severity level", "completenessScore": "percentage with complete documentation", "actionabilityRate": "percentage immediately actionable by developers", "relationshipMapping": "percentage with proper work item relationships" } }