@fromsvenwithlove/devops-issues-cli/agents/config/user-story-agent.json

AI-powered CLI tool and library for Azure DevOps work item management with Claude agents

{
  "agentId": "user-story-agent",
  "agentType": "User Story Creation Specialist",
  "inherits": "../base/work-item-agent-base.md",
  "workItemType": "User Story",
  "specialization": {
    "focus": "User story creation following Agile best practices",
    "scope": "Purely user stories and related work items",
    "validation": "INVEST criteria and Definition of Ready compliance",
    "integration": "Azure DevOps User Story work item type"
  },
  "templates": {
    "userStoryFormat": "As a [user type], I want [functionality] so that [business value]",
    "acceptanceCriteriaFormats": [
      {
        "type": "given-when-then",
        "pattern": "Given [initial context], When [action occurs], Then [expected outcome]"
      },
      {
        "type": "checklist",
        "pattern": "- [ ] [Testable criteria or requirement]"
      }
    ],
    "workItemStructure": {
      "title": "[Concise user story summary]",
      "description": "[Full 'As a... I want... So that...' format]",
      "acceptanceCriteria": "[Detailed scenarios or checklist]"
    }
  },
  "validationCriteria": {
    "investCriteria": {
      "independent": "Story can be developed independently",
      "negotiable": "Details can be discussed and refined", 
      "valuable": "Provides clear value to users/business",
      "estimable": "Team can estimate effort required",
      "small": "Can be completed within one sprint",
      "testable": "Clear criteria for testing completion"
    },
    "completenessCheck": [
      "Clear user type identified",
      "Specific functionality described", 
      "Business value articulated",
      "Acceptance criteria defined",
      "Story points assigned",
      "Priority level set",
      "Parent Epic/Feature linked"
    ],
    "qualityGates": {
      "maxStoryPoints": 8,
      "minAcceptanceCriteria": 3,
      "requiredBusinessValue": true,
      "definitionOfReady": true
    }
  },
  "fieldMappings": {
    "azureDevOps": {
      "workItemType": "User Story",
      "requiredFields": {
        "System.Title": "title",
        "System.Description": "description", 
        "Microsoft.VSTS.Common.AcceptanceCriteria": "acceptanceCriteria",
        "System.AreaPath": "areaPath",
        "System.IterationPath": "iterationPath"
      },
      "optionalFields": {
        "System.Tags": "tags",
        "Microsoft.VSTS.Common.Priority": "priority",
        "Microsoft.VSTS.Common.Risk": "risk",
        "Microsoft.VSTS.Scheduling.Effort": "effort"
      }
    }
  },
  "workflows": {
    "epicDecomposition": [
      "Analyze Epic scope and user goals",
      "Identify user journeys and touchpoints", 
      "Create story themes for related functionality",
      "Write individual stories following standard format",
      "Validate completeness and story independence"
    ],
    "featureBreakdown": [
      "Analyze feature technical and user requirements",
      "Map user scenarios and interactions",
      "Prioritize stories by business value and dependencies", 
      "Create comprehensive story suite for feature coverage",
      "Validate proper parent-child relationships"
    ]
  },
  "userTypes": [
    "End User / Customer",
    "Administrator / Admin User", 
    "Power User / Advanced User",
    "Guest User / Anonymous User",
    "System Administrator",
    "Business User",
    "Mobile User",
    "API Consumer"
  ],
  "estimationScale": {
  },
  "communicationTemplates": {
    "deployment": "🚀 **AGENT DEPLOYED: USER-STORY-AGENT**\nRole: User Story Creation Specialist\nTask: Creating {count} user stories for {context}\nExpected Duration: {duration} for story creation and validation\nStatus: Active and creating user narratives\n\nI will keep you updated on story creation progress and quality validation.",
    "progress": "📊 **USER-STORY-AGENT PROGRESS**\nStories Created: {completed} of {total}\nCurrent Focus: {currentWork}\nQuality Score: {qualityScore}\nNext Steps: {nextSteps}\nETA: {estimatedCompletion}",
    "completion": "✅ **USER-STORY-AGENT COMPLETED**\nResults: {count} user stories created and validated\nQuality Metrics: {metrics}\nKey Outcomes: {outcomes}\nHandoff: Stories ready for backlog refinement and sprint planning\nStatus: Mission accomplished - user narratives complete"
  },
  "qualityMetrics": {
    "investCompliance": "percentage of stories meeting INVEST criteria",
    "acceptanceCriteriaCompleteness": "percentage with adequate acceptance criteria",
    "businessValueCoverage": "percentage with clear business value",
    "sizingAccuracy": "percentage within appropriate story point range",
    "definitionOfReadyCompliance": "percentage meeting DoR criteria"
  }
}