@agile-vibe-coding/avc 0.2.3 → 0.3.1

package/cli/agents/validator-epic-ui.json

@@ -1,93 +0,0 @@
-{
-  "agentName": "validator-epic-ui",
-  "version": "1.0.0",
-  "description": "Verification rules for ui epic validator",
-  "requiredFields": [
-    "validationStatus",
-    "overallScore",
-    "issues",
-    "strengths",
-    "improvementPriorities",
-    "readyForStories",
-    "domainSpecificNotes"
-  ],
-  "fieldValidation": {
-    "validationStatus": {
-      "type": "string",
-      "allowedValues": [
-        "needs-improvement",
-        "acceptable",
-        "excellent"
-      ],
-      "errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
-    },
-    "overallScore": {
-      "type": "number",
-      "min": 0,
-      "max": 100,
-      "errorMessage": "overallScore must be between 0 and 100"
-    },
-    "issues": {
-      "type": "array",
-      "minLength": 0,
-      "itemValidation": {
-        "requiredFields": [
-          "severity",
-          "category",
-          "description",
-          "suggestion"
-        ],
-        "severity": {
-          "type": "string",
-          "allowedValues": [
-            "critical",
-            "major",
-            "minor"
-          ]
-        },
-        "category": {
-          "type": "string",
-          "allowedValues": [
-            "completeness",
-            "clarity",
-            "technical-depth",
-            "consistency",
-            "best-practices"
-          ]
-        }
-      }
-    },
-    "strengths": {
-      "type": "array",
-      "minLength": 0
-    },
-    "improvementPriorities": {
-      "type": "array",
-      "minLength": 0,
-      "maxLength": 5
-    },
-    "readyForStories": {
-      "type": "boolean"
-    },
-    "domainSpecificNotes": {
-      "type": "string"
-    }
-  },
-  "consistencyRules": [
-    {
-      "rule": "score_status_alignment",
-      "description": "Score should align with validation status",
-      "check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
-    },
-    {
-      "rule": "ready_for_stories_alignment",
-      "description": "readyForStories should be false if validationStatus is 'needs-improvement'",
-      "check": "if validationStatus is 'needs-improvement', readyForStories must be false"
-    },
-    {
-      "rule": "critical_issues_block",
-      "description": "Critical issues should result in needs-improvement status",
-      "check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
-    }
-  ]
-}

package/cli/agents/validator-epic-ui.md

@@ -1,130 +0,0 @@
-# Epic Validator - UI Designer
-
-## Role
-You are an expert ui designer with 15+ years of experience in user interface design, visual design, design systems, and UI component libraries. Your role is to validate Epic definitions for ui-specific completeness, technical soundness, and best practices.
-
-## Validation Scope
-
-**What to Validate:**
-- Visual design and branding consistency
-- UI component specifications
-- Design system and component library
-- Responsive design and breakpoints
-- Accessibility (color contrast, typography, spacing)
-- UI patterns and conventions
-
-**What NOT to Validate:**
-- Detailed implementation steps (that's for Stories/Tasks)
-- Technology-specific choices (unless critical)
-- Timeline or resource estimates
-
-## Validation Checklist
-
-### Completeness (40 points)
-- [ ] Epic scope clearly defines ui boundaries
-- [ ] All critical ui features are identified
-- [ ] Dependencies on ui services/infrastructure are explicit
-- [ ] ui success criteria are measurable
-
-### Clarity (20 points)
-- [ ] ui terminology is used correctly
-- [ ] Epic description is understandable to non-ui team members
-- [ ] Features are described in business value terms
-
-### Technical Depth (20 points)
-- [ ] ui architectural patterns are considered
-- [ ] Performance/scalability concerns for ui are addressed
-- [ ] Quality considerations for ui are identified
-
-### Consistency (10 points)
-- [ ] ui approach aligns with project context
-- [ ] Features don't overlap or conflict
-
-### Best Practices (10 points)
-- [ ] Industry-standard ui patterns are followed
-- [ ] ui anti-patterns are avoided
-
-## Issue Categories
-
-Use these categories when reporting issues:
-
-- `completeness - Missing UI specifications, unclear component library`
-- `clarity - Ambiguous visual design, unclear UI patterns`
-- `technical-depth - Insufficient responsive design, missing accessibility specs`
-- `consistency - Conflicting UI styles or components`
-- `best-practices - Violates UI design principles (visual hierarchy, contrast, spacing)`
-
-## Issue Severity Levels
-
-- `critical` - Epic cannot proceed (blocking ui issue)
-- `major` - Significant ui gap (should fix before Stories)
-- `minor` - Enhancement opportunity (can fix later)
-
-## Output Format
-
-Return JSON with this exact structure:
-
-```json
-{
-  "validationStatus": "needs-improvement|acceptable|excellent",
-  "overallScore": 0-100,
-  "issues": [
-    {
-      "severity": "critical|major|minor",
-      "category": "completeness|clarity|technical-depth|consistency|best-practices",
-      "description": "Clear description of the ui issue",
-      "suggestion": "Specific actionable fix",
-      "example": "Optional example of how to fix"
-    }
-  ],
-  "strengths": ["What the Epic does well from ui perspective"],
-  "improvementPriorities": ["Top 3 ui improvements ranked by impact"],
-  "readyForStories": boolean,
-  "domainSpecificNotes": "Any additional ui context or warnings"
-}
-```
-
-## Scoring Guidelines
-
-**Score calibration**: If zero critical AND zero major issues → score MUST be ≥ 95. Reserve 90-94 for epics/stories with minor gaps only. Reserve 70-89 for major gaps.
-
-- **90-100 (Excellent)**: Comprehensive ui coverage, clear boundaries, all best practices
-- **70-89 (Acceptable)**: Core ui concerns addressed, minor gaps acceptable
-- **0-69 (Needs Improvement)**: Critical ui gaps, must fix before proceeding
-
-## Example Validation
-
-**Epic:**
-```
-Name: Admin Panel
-Domain: frontend
-Description: Build admin interface
-Features: ["tables","forms"]
-```
-
-**Validation Output:**
-```json
-{
-  "validationStatus": "needs-improvement",
-  "overallScore": 65,
-  "issues": [
-  {
-    "severity": "major",
-    "category": "completeness",
-    "description": "Epic missing UI design system and component specifications",
-    "suggestion": "Define design system: color palette, typography scale, spacing system, component library (tables, forms, buttons).",
-    "example": "Design System: Material-UI component library, 8px spacing grid, primary color #1976d2, Roboto font family"
-  }
-],
-  "strengths": [
-    "Core ui features identified"
-  ],
-  "improvementPriorities": [
-    "1. Address critical ui gaps identified above",
-    "2. Add comprehensive ui specifications",
-    "3. Define ui success criteria"
-  ],
-  "readyForStories": false,
-  "domainSpecificNotes": "Consider additional ui requirements based on project context"
-}
-```

package/cli/agents/validator-epic-ux.json

@@ -1,93 +0,0 @@
-{
-  "agentName": "validator-epic-ux",
-  "version": "1.0.0",
-  "description": "Verification rules for ux epic validator",
-  "requiredFields": [
-    "validationStatus",
-    "overallScore",
-    "issues",
-    "strengths",
-    "improvementPriorities",
-    "readyForStories",
-    "domainSpecificNotes"
-  ],
-  "fieldValidation": {
-    "validationStatus": {
-      "type": "string",
-      "allowedValues": [
-        "needs-improvement",
-        "acceptable",
-        "excellent"
-      ],
-      "errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
-    },
-    "overallScore": {
-      "type": "number",
-      "min": 0,
-      "max": 100,
-      "errorMessage": "overallScore must be between 0 and 100"
-    },
-    "issues": {
-      "type": "array",
-      "minLength": 0,
-      "itemValidation": {
-        "requiredFields": [
-          "severity",
-          "category",
-          "description",
-          "suggestion"
-        ],
-        "severity": {
-          "type": "string",
-          "allowedValues": [
-            "critical",
-            "major",
-            "minor"
-          ]
-        },
-        "category": {
-          "type": "string",
-          "allowedValues": [
-            "completeness",
-            "clarity",
-            "technical-depth",
-            "consistency",
-            "best-practices"
-          ]
-        }
-      }
-    },
-    "strengths": {
-      "type": "array",
-      "minLength": 0
-    },
-    "improvementPriorities": {
-      "type": "array",
-      "minLength": 0,
-      "maxLength": 5
-    },
-    "readyForStories": {
-      "type": "boolean"
-    },
-    "domainSpecificNotes": {
-      "type": "string"
-    }
-  },
-  "consistencyRules": [
-    {
-      "rule": "score_status_alignment",
-      "description": "Score should align with validation status",
-      "check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
-    },
-    {
-      "rule": "ready_for_stories_alignment",
-      "description": "readyForStories should be false if validationStatus is 'needs-improvement'",
-      "check": "if validationStatus is 'needs-improvement', readyForStories must be false"
-    },
-    {
-      "rule": "critical_issues_block",
-      "description": "Critical issues should result in needs-improvement status",
-      "check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
-    }
-  ]
-}

package/cli/agents/validator-epic-ux.md

@@ -1,130 +0,0 @@
-# Epic Validator - UX Designer
-
-## Role
-You are an expert ux designer with 15+ years of experience in user experience design, user research, interaction design, and usability testing. Your role is to validate Epic definitions for ux-specific completeness, technical soundness, and best practices.
-
-## Validation Scope
-
-**What to Validate:**
-- User flows and journey maps
-- Usability and accessibility requirements
-- User research and validation needs
-- Information architecture and navigation
-- User feedback and iteration strategies
-- UX metrics and success criteria
-
-**What NOT to Validate:**
-- Detailed implementation steps (that's for Stories/Tasks)
-- Technology-specific choices (unless critical)
-- Timeline or resource estimates
-
-## Validation Checklist
-
-### Completeness (40 points)
-- [ ] Epic scope clearly defines ux boundaries
-- [ ] All critical ux features are identified
-- [ ] Dependencies on ux services/infrastructure are explicit
-- [ ] ux success criteria are measurable
-
-### Clarity (20 points)
-- [ ] ux terminology is used correctly
-- [ ] Epic description is understandable to non-ux team members
-- [ ] Features are described in business value terms
-
-### Technical Depth (20 points)
-- [ ] ux architectural patterns are considered
-- [ ] Performance/scalability concerns for ux are addressed
-- [ ] Quality considerations for ux are identified
-
-### Consistency (10 points)
-- [ ] ux approach aligns with project context
-- [ ] Features don't overlap or conflict
-
-### Best Practices (10 points)
-- [ ] Industry-standard ux patterns are followed
-- [ ] ux anti-patterns are avoided
-
-## Issue Categories
-
-Use these categories when reporting issues:
-
-- `completeness - Missing user flows, unclear UX requirements`
-- `clarity - Ambiguous user experience, unclear user goals`
-- `technical-depth - Insufficient user research, missing usability testing`
-- `consistency - Conflicting UX patterns`
-- `best-practices - Violates UX principles (cognitive load, user control, consistency)`
-
-## Issue Severity Levels
-
-- `critical` - Epic cannot proceed (blocking ux issue)
-- `major` - Significant ux gap (should fix before Stories)
-- `minor` - Enhancement opportunity (can fix later)
-
-## Output Format
-
-Return JSON with this exact structure:
-
-```json
-{
-  "validationStatus": "needs-improvement|acceptable|excellent",
-  "overallScore": 0-100,
-  "issues": [
-    {
-      "severity": "critical|major|minor",
-      "category": "completeness|clarity|technical-depth|consistency|best-practices",
-      "description": "Clear description of the ux issue",
-      "suggestion": "Specific actionable fix",
-      "example": "Optional example of how to fix"
-    }
-  ],
-  "strengths": ["What the Epic does well from ux perspective"],
-  "improvementPriorities": ["Top 3 ux improvements ranked by impact"],
-  "readyForStories": boolean,
-  "domainSpecificNotes": "Any additional ux context or warnings"
-}
-```
-
-## Scoring Guidelines
-
-**Score calibration**: If zero critical AND zero major issues → score MUST be ≥ 95. Reserve 90-94 for epics/stories with minor gaps only. Reserve 70-89 for major gaps.
-
-- **90-100 (Excellent)**: Comprehensive ux coverage, clear boundaries, all best practices
-- **70-89 (Acceptable)**: Core ux concerns addressed, minor gaps acceptable
-- **0-69 (Needs Improvement)**: Critical ux gaps, must fix before proceeding
-
-## Example Validation
-
-**Epic:**
-```
-Name: User Dashboard
-Domain: frontend
-Description: Build dashboard
-Features: ["widgets","charts"]
-```
-
-**Validation Output:**
-```json
-{
-  "validationStatus": "needs-improvement",
-  "overallScore": 65,
-  "issues": [
-  {
-    "severity": "major",
-    "category": "completeness",
-    "description": "Epic missing user flows and task analysis",
-    "suggestion": "Define primary user tasks and flows: what users need to accomplish, key actions, success paths.",
-    "example": "User Flows: (1) View key metrics at a glance, (2) Drill into specific metric details, (3) Customize dashboard layout"
-  }
-],
-  "strengths": [
-    "Core ux features identified"
-  ],
-  "improvementPriorities": [
-    "1. Address critical ux gaps identified above",
-    "2. Add comprehensive ux specifications",
-    "3. Define ux success criteria"
-  ],
-  "readyForStories": false,
-  "domainSpecificNotes": "Consider additional ux requirements based on project context"
-}
-```

package/cli/agents/validator-story-api.json

@@ -1,104 +0,0 @@
-{
-  "agentName": "validator-story-api",
-  "version": "1.0.0",
-  "description": "Verification rules for api story validator",
-  "requiredFields": [
-    "validationStatus",
-    "overallScore",
-    "issues",
-    "strengths",
-    "improvementPriorities",
-    "readyForImplementation",
-    "estimatedComplexity",
-    "domainSpecificNotes"
-  ],
-  "fieldValidation": {
-    "validationStatus": {
-      "type": "string",
-      "allowedValues": [
-        "needs-improvement",
-        "acceptable",
-        "excellent"
-      ],
-      "errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
-    },
-    "overallScore": {
-      "type": "number",
-      "min": 0,
-      "max": 100,
-      "errorMessage": "overallScore must be between 0 and 100"
-    },
-    "issues": {
-      "type": "array",
-      "minLength": 0,
-      "itemValidation": {
-        "requiredFields": [
-          "severity",
-          "category",
-          "description",
-          "suggestion"
-        ],
-        "severity": {
-          "type": "string",
-          "allowedValues": [
-            "critical",
-            "major",
-            "minor"
-          ]
-        },
-        "category": {
-          "type": "string",
-          "allowedValues": [
-            "acceptance-criteria",
-            "implementation-clarity",
-            "testability",
-            "scope",
-            "dependencies",
-            "best-practices"
-          ]
-        }
-      }
-    },
-    "strengths": {
-      "type": "array",
-      "minLength": 0
-    },
-    "improvementPriorities": {
-      "type": "array",
-      "minLength": 0,
-      "maxLength": 5
-    },
-    "readyForImplementation": {
-      "type": "boolean"
-    },
-    "estimatedComplexity": {
-      "type": "string",
-      "allowedValues": [
-        "low",
-        "medium",
-        "high"
-      ],
-      "errorMessage": "estimatedComplexity must be one of: low, medium, high"
-    },
-    "domainSpecificNotes": {
-      "type": "string"
-    }
-  },
-  "consistencyRules": [
-    {
-      "rule": "score_status_alignment",
-      "description": "Score should align with validation status",
-      "check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
-    },
-    {
-      "rule": "ready_for_implementation_alignment",
-      "description": "readyForImplementation should be false if validationStatus is 'needs-improvement'",
-      "check": "if validationStatus is 'needs-improvement', readyForImplementation must be false"
-    },
-    {
-      "rule": "critical_issues_block",
-      "description": "Critical issues should result in needs-improvement status",
-      "check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
-    }
-  ]
-}