@agile-vibe-coding/avc 0.1.1 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cli/agent-loader.js +21 -0
- package/cli/agents/agent-selector.md +129 -0
- package/cli/agents/architecture-recommender.md +418 -0
- package/cli/agents/database-deep-dive.md +470 -0
- package/cli/agents/database-recommender.md +634 -0
- package/cli/agents/doc-distributor.md +176 -0
- package/cli/agents/documentation-updater.md +203 -0
- package/cli/agents/epic-story-decomposer.md +280 -0
- package/cli/agents/feature-context-generator.md +91 -0
- package/cli/agents/gap-checker-epic.md +52 -0
- package/cli/agents/impact-checker-story.md +51 -0
- package/cli/agents/migration-guide-generator.md +305 -0
- package/cli/agents/mission-scope-generator.md +79 -0
- package/cli/agents/mission-scope-validator.md +112 -0
- package/cli/agents/project-context-extractor.md +107 -0
- package/cli/agents/project-documentation-creator.json +226 -0
- package/cli/agents/project-documentation-creator.md +595 -0
- package/cli/agents/question-prefiller.md +269 -0
- package/cli/agents/refiner-epic.md +39 -0
- package/cli/agents/refiner-story.md +42 -0
- package/cli/agents/solver-epic-api.json +15 -0
- package/cli/agents/solver-epic-api.md +39 -0
- package/cli/agents/solver-epic-backend.json +15 -0
- package/cli/agents/solver-epic-backend.md +39 -0
- package/cli/agents/solver-epic-cloud.json +15 -0
- package/cli/agents/solver-epic-cloud.md +39 -0
- package/cli/agents/solver-epic-data.json +15 -0
- package/cli/agents/solver-epic-data.md +39 -0
- package/cli/agents/solver-epic-database.json +15 -0
- package/cli/agents/solver-epic-database.md +39 -0
- package/cli/agents/solver-epic-developer.json +15 -0
- package/cli/agents/solver-epic-developer.md +39 -0
- package/cli/agents/solver-epic-devops.json +15 -0
- package/cli/agents/solver-epic-devops.md +39 -0
- package/cli/agents/solver-epic-frontend.json +15 -0
- package/cli/agents/solver-epic-frontend.md +39 -0
- package/cli/agents/solver-epic-mobile.json +15 -0
- package/cli/agents/solver-epic-mobile.md +39 -0
- package/cli/agents/solver-epic-qa.json +15 -0
- package/cli/agents/solver-epic-qa.md +39 -0
- package/cli/agents/solver-epic-security.json +15 -0
- package/cli/agents/solver-epic-security.md +39 -0
- package/cli/agents/solver-epic-solution-architect.json +15 -0
- package/cli/agents/solver-epic-solution-architect.md +39 -0
- package/cli/agents/solver-epic-test-architect.json +15 -0
- package/cli/agents/solver-epic-test-architect.md +39 -0
- package/cli/agents/solver-epic-ui.json +15 -0
- package/cli/agents/solver-epic-ui.md +39 -0
- package/cli/agents/solver-epic-ux.json +15 -0
- package/cli/agents/solver-epic-ux.md +39 -0
- package/cli/agents/solver-story-api.json +15 -0
- package/cli/agents/solver-story-api.md +39 -0
- package/cli/agents/solver-story-backend.json +15 -0
- package/cli/agents/solver-story-backend.md +39 -0
- package/cli/agents/solver-story-cloud.json +15 -0
- package/cli/agents/solver-story-cloud.md +39 -0
- package/cli/agents/solver-story-data.json +15 -0
- package/cli/agents/solver-story-data.md +39 -0
- package/cli/agents/solver-story-database.json +15 -0
- package/cli/agents/solver-story-database.md +39 -0
- package/cli/agents/solver-story-developer.json +15 -0
- package/cli/agents/solver-story-developer.md +39 -0
- package/cli/agents/solver-story-devops.json +15 -0
- package/cli/agents/solver-story-devops.md +39 -0
- package/cli/agents/solver-story-frontend.json +15 -0
- package/cli/agents/solver-story-frontend.md +39 -0
- package/cli/agents/solver-story-mobile.json +15 -0
- package/cli/agents/solver-story-mobile.md +39 -0
- package/cli/agents/solver-story-qa.json +15 -0
- package/cli/agents/solver-story-qa.md +39 -0
- package/cli/agents/solver-story-security.json +15 -0
- package/cli/agents/solver-story-security.md +39 -0
- package/cli/agents/solver-story-solution-architect.json +15 -0
- package/cli/agents/solver-story-solution-architect.md +39 -0
- package/cli/agents/solver-story-test-architect.json +15 -0
- package/cli/agents/solver-story-test-architect.md +39 -0
- package/cli/agents/solver-story-ui.json +15 -0
- package/cli/agents/solver-story-ui.md +39 -0
- package/cli/agents/solver-story-ux.json +15 -0
- package/cli/agents/solver-story-ux.md +39 -0
- package/cli/agents/story-doc-enricher.md +133 -0
- package/cli/agents/suggestion-business-analyst.md +88 -0
- package/cli/agents/suggestion-deployment-architect.md +263 -0
- package/cli/agents/suggestion-product-manager.md +129 -0
- package/cli/agents/suggestion-security-specialist.md +156 -0
- package/cli/agents/suggestion-technical-architect.md +269 -0
- package/cli/agents/suggestion-ux-researcher.md +93 -0
- package/cli/agents/task-subtask-decomposer.md +188 -0
- package/cli/agents/validator-documentation.json +152 -0
- package/cli/agents/validator-documentation.md +453 -0
- package/cli/agents/validator-epic-api.json +93 -0
- package/cli/agents/validator-epic-api.md +137 -0
- package/cli/agents/validator-epic-backend.json +93 -0
- package/cli/agents/validator-epic-backend.md +130 -0
- package/cli/agents/validator-epic-cloud.json +93 -0
- package/cli/agents/validator-epic-cloud.md +137 -0
- package/cli/agents/validator-epic-data.json +93 -0
- package/cli/agents/validator-epic-data.md +130 -0
- package/cli/agents/validator-epic-database.json +93 -0
- package/cli/agents/validator-epic-database.md +137 -0
- package/cli/agents/validator-epic-developer.json +74 -0
- package/cli/agents/validator-epic-developer.md +153 -0
- package/cli/agents/validator-epic-devops.json +74 -0
- package/cli/agents/validator-epic-devops.md +153 -0
- package/cli/agents/validator-epic-frontend.json +74 -0
- package/cli/agents/validator-epic-frontend.md +153 -0
- package/cli/agents/validator-epic-mobile.json +93 -0
- package/cli/agents/validator-epic-mobile.md +130 -0
- package/cli/agents/validator-epic-qa.json +93 -0
- package/cli/agents/validator-epic-qa.md +130 -0
- package/cli/agents/validator-epic-security.json +74 -0
- package/cli/agents/validator-epic-security.md +154 -0
- package/cli/agents/validator-epic-solution-architect.json +74 -0
- package/cli/agents/validator-epic-solution-architect.md +156 -0
- package/cli/agents/validator-epic-test-architect.json +93 -0
- package/cli/agents/validator-epic-test-architect.md +130 -0
- package/cli/agents/validator-epic-ui.json +93 -0
- package/cli/agents/validator-epic-ui.md +130 -0
- package/cli/agents/validator-epic-ux.json +93 -0
- package/cli/agents/validator-epic-ux.md +130 -0
- package/cli/agents/validator-selector.md +211 -0
- package/cli/agents/validator-story-api.json +104 -0
- package/cli/agents/validator-story-api.md +152 -0
- package/cli/agents/validator-story-backend.json +104 -0
- package/cli/agents/validator-story-backend.md +152 -0
- package/cli/agents/validator-story-cloud.json +104 -0
- package/cli/agents/validator-story-cloud.md +152 -0
- package/cli/agents/validator-story-data.json +104 -0
- package/cli/agents/validator-story-data.md +152 -0
- package/cli/agents/validator-story-database.json +104 -0
- package/cli/agents/validator-story-database.md +152 -0
- package/cli/agents/validator-story-developer.json +104 -0
- package/cli/agents/validator-story-developer.md +152 -0
- package/cli/agents/validator-story-devops.json +104 -0
- package/cli/agents/validator-story-devops.md +152 -0
- package/cli/agents/validator-story-frontend.json +104 -0
- package/cli/agents/validator-story-frontend.md +152 -0
- package/cli/agents/validator-story-mobile.json +104 -0
- package/cli/agents/validator-story-mobile.md +152 -0
- package/cli/agents/validator-story-qa.json +104 -0
- package/cli/agents/validator-story-qa.md +152 -0
- package/cli/agents/validator-story-security.json +104 -0
- package/cli/agents/validator-story-security.md +152 -0
- package/cli/agents/validator-story-solution-architect.json +104 -0
- package/cli/agents/validator-story-solution-architect.md +152 -0
- package/cli/agents/validator-story-test-architect.json +104 -0
- package/cli/agents/validator-story-test-architect.md +152 -0
- package/cli/agents/validator-story-ui.json +104 -0
- package/cli/agents/validator-story-ui.md +152 -0
- package/cli/agents/validator-story-ux.json +104 -0
- package/cli/agents/validator-story-ux.md +152 -0
- package/cli/ansi-colors.js +21 -0
- package/cli/build-docs.js +29 -8
- package/cli/ceremony-history.js +369 -0
- package/cli/command-logger.js +49 -12
- package/cli/components/static-output.js +63 -0
- package/cli/console-output-manager.js +94 -0
- package/cli/docs-sync.js +306 -0
- package/cli/epic-story-validator.js +1174 -0
- package/cli/evaluation-prompts.js +1008 -0
- package/cli/execution-context.js +195 -0
- package/cli/generate-summary-table.js +340 -0
- package/cli/index.js +0 -0
- package/cli/init-model-config.js +697 -0
- package/cli/init.js +1311 -274
- package/cli/kanban-server-manager.js +228 -0
- package/cli/llm-claude.js +83 -1
- package/cli/llm-gemini.js +85 -0
- package/cli/llm-mock.js +233 -0
- package/cli/llm-openai.js +233 -0
- package/cli/llm-provider.js +240 -3
- package/cli/llm-token-limits.js +102 -0
- package/cli/llm-verifier.js +454 -0
- package/cli/message-constants.js +58 -0
- package/cli/message-manager.js +334 -0
- package/cli/message-types.js +96 -0
- package/cli/messaging-api.js +297 -0
- package/cli/model-pricing.js +169 -0
- package/cli/model-query-engine.js +468 -0
- package/cli/model-recommendation-analyzer.js +495 -0
- package/cli/model-selector.js +269 -0
- package/cli/output-buffer.js +107 -0
- package/cli/process-manager.js +73 -2
- package/cli/repl-ink.js +4988 -1217
- package/cli/repl-old.js +4 -4
- package/cli/seed-processor.js +792 -0
- package/cli/sprint-planning-processor.js +1813 -0
- package/cli/template-processor.js +2102 -105
- package/cli/templates/project.md +25 -8
- package/cli/templates/vitepress-config.mts.template +5 -4
- package/cli/token-tracker.js +520 -0
- package/cli/tools/generate-story-validators.js +317 -0
- package/cli/tools/generate-validators.js +669 -0
- package/cli/update-checker.js +19 -17
- package/cli/update-notifier.js +4 -4
- package/cli/validation-router.js +605 -0
- package/cli/verification-tracker.js +563 -0
- package/kanban/README.md +386 -0
- package/kanban/client/README.md +205 -0
- package/kanban/client/components.json +20 -0
- package/kanban/client/dist/assets/index-CiD8PS2e.js +306 -0
- package/kanban/client/dist/assets/index-nLh0m82Q.css +1 -0
- package/kanban/client/dist/index.html +16 -0
- package/kanban/client/dist/vite.svg +1 -0
- package/kanban/client/index.html +15 -0
- package/kanban/client/package-lock.json +9442 -0
- package/kanban/client/package.json +44 -0
- package/kanban/client/postcss.config.js +6 -0
- package/kanban/client/public/vite.svg +1 -0
- package/kanban/client/src/App.jsx +622 -0
- package/kanban/client/src/components/ProjectFileEditorPopup.jsx +117 -0
- package/kanban/client/src/components/ceremony/AskArchPopup.jsx +416 -0
- package/kanban/client/src/components/ceremony/AskModelPopup.jsx +616 -0
- package/kanban/client/src/components/ceremony/CeremonyWorkflowModal.jsx +946 -0
- package/kanban/client/src/components/ceremony/EpicStorySelectionModal.jsx +254 -0
- package/kanban/client/src/components/ceremony/SponsorCallModal.jsx +619 -0
- package/kanban/client/src/components/ceremony/SprintPlanningModal.jsx +704 -0
- package/kanban/client/src/components/ceremony/steps/ArchitectureStep.jsx +150 -0
- package/kanban/client/src/components/ceremony/steps/CompleteStep.jsx +154 -0
- package/kanban/client/src/components/ceremony/steps/DatabaseStep.jsx +202 -0
- package/kanban/client/src/components/ceremony/steps/DeploymentStep.jsx +123 -0
- package/kanban/client/src/components/ceremony/steps/MissionStep.jsx +106 -0
- package/kanban/client/src/components/ceremony/steps/ReviewAnswersStep.jsx +125 -0
- package/kanban/client/src/components/ceremony/steps/RunningStep.jsx +228 -0
- package/kanban/client/src/components/kanban/CardDetailModal.jsx +559 -0
- package/kanban/client/src/components/kanban/EpicSection.jsx +146 -0
- package/kanban/client/src/components/kanban/FilterToolbar.jsx +222 -0
- package/kanban/client/src/components/kanban/GroupingSelector.jsx +57 -0
- package/kanban/client/src/components/kanban/KanbanBoard.jsx +211 -0
- package/kanban/client/src/components/kanban/KanbanCard.jsx +138 -0
- package/kanban/client/src/components/kanban/KanbanColumn.jsx +90 -0
- package/kanban/client/src/components/kanban/RefineWorkItemPopup.jsx +789 -0
- package/kanban/client/src/components/layout/LoadingScreen.jsx +82 -0
- package/kanban/client/src/components/process/ProcessMonitorBar.jsx +80 -0
- package/kanban/client/src/components/settings/AgentEditorPopup.jsx +171 -0
- package/kanban/client/src/components/settings/AgentsTab.jsx +353 -0
- package/kanban/client/src/components/settings/ApiKeysTab.jsx +113 -0
- package/kanban/client/src/components/settings/CeremonyModelsTab.jsx +98 -0
- package/kanban/client/src/components/settings/CostThresholdsTab.jsx +94 -0
- package/kanban/client/src/components/settings/ModelPricingTab.jsx +204 -0
- package/kanban/client/src/components/settings/ServersTab.jsx +121 -0
- package/kanban/client/src/components/settings/SettingsModal.jsx +84 -0
- package/kanban/client/src/components/stats/CostModal.jsx +353 -0
- package/kanban/client/src/components/ui/badge.jsx +27 -0
- package/kanban/client/src/components/ui/dialog.jsx +121 -0
- package/kanban/client/src/components/ui/tabs.jsx +85 -0
- package/kanban/client/src/hooks/__tests__/useGrouping.test.js +232 -0
- package/kanban/client/src/hooks/useGrouping.js +118 -0
- package/kanban/client/src/hooks/useWebSocket.js +120 -0
- package/kanban/client/src/lib/__tests__/api.test.js +196 -0
- package/kanban/client/src/lib/__tests__/status-grouping.test.js +94 -0
- package/kanban/client/src/lib/api.js +401 -0
- package/kanban/client/src/lib/status-grouping.js +144 -0
- package/kanban/client/src/lib/utils.js +11 -0
- package/kanban/client/src/main.jsx +10 -0
- package/kanban/client/src/store/__tests__/kanbanStore.test.js +164 -0
- package/kanban/client/src/store/ceremonyStore.js +172 -0
- package/kanban/client/src/store/filterStore.js +201 -0
- package/kanban/client/src/store/kanbanStore.js +115 -0
- package/kanban/client/src/store/processStore.js +65 -0
- package/kanban/client/src/store/sprintPlanningStore.js +33 -0
- package/kanban/client/src/styles/globals.css +59 -0
- package/kanban/client/tailwind.config.js +77 -0
- package/kanban/client/vite.config.js +28 -0
- package/kanban/client/vitest.config.js +28 -0
- package/kanban/dev-start.sh +47 -0
- package/kanban/package.json +12 -0
- package/kanban/server/index.js +516 -0
- package/kanban/server/routes/ceremony.js +305 -0
- package/kanban/server/routes/costs.js +157 -0
- package/kanban/server/routes/processes.js +50 -0
- package/kanban/server/routes/settings.js +303 -0
- package/kanban/server/routes/websocket.js +276 -0
- package/kanban/server/routes/work-items.js +347 -0
- package/kanban/server/services/CeremonyService.js +1190 -0
- package/kanban/server/services/FileSystemScanner.js +95 -0
- package/kanban/server/services/FileWatcher.js +144 -0
- package/kanban/server/services/HierarchyBuilder.js +196 -0
- package/kanban/server/services/ProcessRegistry.js +122 -0
- package/kanban/server/services/WorkItemReader.js +123 -0
- package/kanban/server/services/WorkItemRefineService.js +510 -0
- package/kanban/server/start.js +49 -0
- package/kanban/server/utils/kanban-logger.js +132 -0
- package/kanban/server/utils/markdown.js +91 -0
- package/kanban/server/utils/status-grouping.js +107 -0
- package/kanban/server/workers/sponsor-call-worker.js +84 -0
- package/kanban/server/workers/sprint-planning-worker.js +130 -0
- package/package.json +18 -5
- package/cli/agents/documentation.md +0 -302
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
{
|
|
2
|
+
"agentName": "validator-epic-database",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Verification rules for database epic validator",
|
|
5
|
+
"requiredFields": [
|
|
6
|
+
"validationStatus",
|
|
7
|
+
"overallScore",
|
|
8
|
+
"issues",
|
|
9
|
+
"strengths",
|
|
10
|
+
"improvementPriorities",
|
|
11
|
+
"readyForStories",
|
|
12
|
+
"domainSpecificNotes"
|
|
13
|
+
],
|
|
14
|
+
"fieldValidation": {
|
|
15
|
+
"validationStatus": {
|
|
16
|
+
"type": "string",
|
|
17
|
+
"allowedValues": [
|
|
18
|
+
"needs-improvement",
|
|
19
|
+
"acceptable",
|
|
20
|
+
"excellent"
|
|
21
|
+
],
|
|
22
|
+
"errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
|
|
23
|
+
},
|
|
24
|
+
"overallScore": {
|
|
25
|
+
"type": "number",
|
|
26
|
+
"min": 0,
|
|
27
|
+
"max": 100,
|
|
28
|
+
"errorMessage": "overallScore must be between 0 and 100"
|
|
29
|
+
},
|
|
30
|
+
"issues": {
|
|
31
|
+
"type": "array",
|
|
32
|
+
"minLength": 0,
|
|
33
|
+
"itemValidation": {
|
|
34
|
+
"requiredFields": [
|
|
35
|
+
"severity",
|
|
36
|
+
"category",
|
|
37
|
+
"description",
|
|
38
|
+
"suggestion"
|
|
39
|
+
],
|
|
40
|
+
"severity": {
|
|
41
|
+
"type": "string",
|
|
42
|
+
"allowedValues": [
|
|
43
|
+
"critical",
|
|
44
|
+
"major",
|
|
45
|
+
"minor"
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
"category": {
|
|
49
|
+
"type": "string",
|
|
50
|
+
"allowedValues": [
|
|
51
|
+
"completeness",
|
|
52
|
+
"clarity",
|
|
53
|
+
"technical-depth",
|
|
54
|
+
"consistency",
|
|
55
|
+
"best-practices"
|
|
56
|
+
]
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
"strengths": {
|
|
61
|
+
"type": "array",
|
|
62
|
+
"minLength": 0
|
|
63
|
+
},
|
|
64
|
+
"improvementPriorities": {
|
|
65
|
+
"type": "array",
|
|
66
|
+
"minLength": 0,
|
|
67
|
+
"maxLength": 5
|
|
68
|
+
},
|
|
69
|
+
"readyForStories": {
|
|
70
|
+
"type": "boolean"
|
|
71
|
+
},
|
|
72
|
+
"domainSpecificNotes": {
|
|
73
|
+
"type": "string"
|
|
74
|
+
}
|
|
75
|
+
},
|
|
76
|
+
"consistencyRules": [
|
|
77
|
+
{
|
|
78
|
+
"rule": "score_status_alignment",
|
|
79
|
+
"description": "Score should align with validation status",
|
|
80
|
+
"check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"rule": "ready_for_stories_alignment",
|
|
84
|
+
"description": "readyForStories should be false if validationStatus is 'needs-improvement'",
|
|
85
|
+
"check": "if validationStatus is 'needs-improvement', readyForStories must be false"
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
"rule": "critical_issues_block",
|
|
89
|
+
"description": "Critical issues should result in needs-improvement status",
|
|
90
|
+
"check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# Epic Validator - Database Specialist
|
|
2
|
+
|
|
3
|
+
## Role
|
|
4
|
+
You are an expert database specialist with 15+ years of experience in database design, data modeling, query optimization, and database administration. Your role is to validate Epic definitions for database-specific completeness, technical soundness, and best practices.
|
|
5
|
+
|
|
6
|
+
## Validation Scope
|
|
7
|
+
|
|
8
|
+
**What to Validate:**
|
|
9
|
+
- Data model design and schema definitions
|
|
10
|
+
- Database performance and query optimization
|
|
11
|
+
- Data integrity and consistency requirements
|
|
12
|
+
- Backup, recovery, and disaster recovery strategies
|
|
13
|
+
- Database scalability (sharding, replication, partitioning)
|
|
14
|
+
- Migration and schema evolution strategies
|
|
15
|
+
|
|
16
|
+
**What NOT to Validate:**
|
|
17
|
+
- Detailed implementation steps (that's for Stories/Tasks)
|
|
18
|
+
- Technology-specific choices (unless critical)
|
|
19
|
+
- Timeline or resource estimates
|
|
20
|
+
|
|
21
|
+
## Validation Checklist
|
|
22
|
+
|
|
23
|
+
### Completeness (40 points)
|
|
24
|
+
- [ ] Epic scope clearly defines database boundaries
|
|
25
|
+
- [ ] All critical database features are identified
|
|
26
|
+
- [ ] Dependencies on database services/infrastructure are explicit
|
|
27
|
+
- [ ] database success criteria are measurable
|
|
28
|
+
|
|
29
|
+
### Clarity (20 points)
|
|
30
|
+
- [ ] database terminology is used correctly
|
|
31
|
+
- [ ] Epic description is understandable to non-database team members
|
|
32
|
+
- [ ] Features are described in business value terms
|
|
33
|
+
|
|
34
|
+
### Technical Depth (20 points)
|
|
35
|
+
- [ ] database architectural patterns are considered
|
|
36
|
+
- [ ] Performance/scalability concerns for database are addressed
|
|
37
|
+
- [ ] Quality considerations for database are identified
|
|
38
|
+
|
|
39
|
+
### Consistency (10 points)
|
|
40
|
+
- [ ] database approach aligns with project context
|
|
41
|
+
- [ ] Features don't overlap or conflict
|
|
42
|
+
|
|
43
|
+
### Best Practices (10 points)
|
|
44
|
+
- [ ] Industry-standard database patterns are followed
|
|
45
|
+
- [ ] database anti-patterns are avoided
|
|
46
|
+
|
|
47
|
+
## Issue Categories
|
|
48
|
+
|
|
49
|
+
Use these categories when reporting issues:
|
|
50
|
+
|
|
51
|
+
- `completeness - Missing tables/entities, unclear relationships`
|
|
52
|
+
- `clarity - Ambiguous data model, unclear database boundaries`
|
|
53
|
+
- `technical-depth - Insufficient normalization/denormalization strategy, missing indexes`
|
|
54
|
+
- `consistency - Conflicting data requirements or constraints`
|
|
55
|
+
- `best-practices - Violates database design principles (normalization, indexing)`
|
|
56
|
+
|
|
57
|
+
## Issue Severity Levels
|
|
58
|
+
|
|
59
|
+
- `critical` - Epic cannot proceed (blocking database issue)
|
|
60
|
+
- `major` - Significant database gap (should fix before Stories)
|
|
61
|
+
- `minor` - Enhancement opportunity (can fix later)
|
|
62
|
+
|
|
63
|
+
## Output Format
|
|
64
|
+
|
|
65
|
+
Return JSON with this exact structure:
|
|
66
|
+
|
|
67
|
+
```json
|
|
68
|
+
{
|
|
69
|
+
"validationStatus": "needs-improvement|acceptable|excellent",
|
|
70
|
+
"overallScore": 0-100,
|
|
71
|
+
"issues": [
|
|
72
|
+
{
|
|
73
|
+
"severity": "critical|major|minor",
|
|
74
|
+
"category": "completeness|clarity|technical-depth|consistency|best-practices",
|
|
75
|
+
"description": "Clear description of the database issue",
|
|
76
|
+
"suggestion": "Specific actionable fix",
|
|
77
|
+
"example": "Optional example of how to fix"
|
|
78
|
+
}
|
|
79
|
+
],
|
|
80
|
+
"strengths": ["What the Epic does well from database perspective"],
|
|
81
|
+
"improvementPriorities": ["Top 3 database improvements ranked by impact"],
|
|
82
|
+
"readyForStories": boolean,
|
|
83
|
+
"domainSpecificNotes": "Any additional database context or warnings"
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Scoring Guidelines
|
|
88
|
+
|
|
89
|
+
**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
|
+
|
|
91
|
+
- **90-100 (Excellent)**: Comprehensive database coverage, clear boundaries, all best practices
|
|
92
|
+
- **70-89 (Acceptable)**: Core database concerns addressed, minor gaps acceptable
|
|
93
|
+
- **0-69 (Needs Improvement)**: Critical database gaps, must fix before proceeding
|
|
94
|
+
|
|
95
|
+
## Example Validation
|
|
96
|
+
|
|
97
|
+
**Epic:**
|
|
98
|
+
```
|
|
99
|
+
Name: User Data Storage
|
|
100
|
+
Domain: data-processing
|
|
101
|
+
Description: Store user data
|
|
102
|
+
Features: ["user table","profile storage"]
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
**Validation Output:**
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"validationStatus": "needs-improvement",
|
|
109
|
+
"overallScore": 65,
|
|
110
|
+
"issues": [
|
|
111
|
+
{
|
|
112
|
+
"severity": "critical",
|
|
113
|
+
"category": "completeness",
|
|
114
|
+
"description": "Database epic missing schema definition and relationships",
|
|
115
|
+
"suggestion": "Define complete schema: tables, columns, data types, primary keys, foreign keys, indexes.",
|
|
116
|
+
"example": "Schema: users table (id PK, email unique, password_hash, created_at), profiles table (user_id FK, bio, avatar_url)"
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"severity": "major",
|
|
120
|
+
"category": "technical-depth",
|
|
121
|
+
"description": "No mention of database technology (SQL vs NoSQL) or specific database engine",
|
|
122
|
+
"suggestion": "Specify database type (PostgreSQL, MySQL, MongoDB, DynamoDB) based on data access patterns.",
|
|
123
|
+
"example": "Technology: PostgreSQL for relational user data with ACID guarantees"
|
|
124
|
+
}
|
|
125
|
+
],
|
|
126
|
+
"strengths": [
|
|
127
|
+
"Core database features identified"
|
|
128
|
+
],
|
|
129
|
+
"improvementPriorities": [
|
|
130
|
+
"1. Address critical database gaps identified above",
|
|
131
|
+
"2. Add comprehensive database specifications",
|
|
132
|
+
"3. Define database success criteria"
|
|
133
|
+
],
|
|
134
|
+
"readyForStories": false,
|
|
135
|
+
"domainSpecificNotes": "Consider additional database requirements based on project context"
|
|
136
|
+
}
|
|
137
|
+
```
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
{
|
|
2
|
+
"agentName": "validator-epic-developer",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Verification rules for developer (general best practices) epic validator",
|
|
5
|
+
"requiredFields": [
|
|
6
|
+
"validationStatus",
|
|
7
|
+
"overallScore",
|
|
8
|
+
"issues",
|
|
9
|
+
"strengths",
|
|
10
|
+
"improvementPriorities",
|
|
11
|
+
"readyForStories",
|
|
12
|
+
"domainSpecificNotes"
|
|
13
|
+
],
|
|
14
|
+
"fieldValidation": {
|
|
15
|
+
"validationStatus": {
|
|
16
|
+
"type": "string",
|
|
17
|
+
"allowedValues": ["needs-improvement", "acceptable", "excellent"],
|
|
18
|
+
"errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
|
|
19
|
+
},
|
|
20
|
+
"overallScore": {
|
|
21
|
+
"type": "number",
|
|
22
|
+
"min": 0,
|
|
23
|
+
"max": 100,
|
|
24
|
+
"errorMessage": "overallScore must be between 0 and 100"
|
|
25
|
+
},
|
|
26
|
+
"issues": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"minLength": 0,
|
|
29
|
+
"itemValidation": {
|
|
30
|
+
"requiredFields": ["severity", "category", "description", "suggestion"],
|
|
31
|
+
"severity": {
|
|
32
|
+
"type": "string",
|
|
33
|
+
"allowedValues": ["critical", "major", "minor"]
|
|
34
|
+
},
|
|
35
|
+
"category": {
|
|
36
|
+
"type": "string",
|
|
37
|
+
"allowedValues": ["clarity", "feasibility", "quality", "workflow", "best-practices"]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"strengths": {
|
|
42
|
+
"type": "array",
|
|
43
|
+
"minLength": 0
|
|
44
|
+
},
|
|
45
|
+
"improvementPriorities": {
|
|
46
|
+
"type": "array",
|
|
47
|
+
"minLength": 0,
|
|
48
|
+
"maxLength": 5
|
|
49
|
+
},
|
|
50
|
+
"readyForStories": {
|
|
51
|
+
"type": "boolean"
|
|
52
|
+
},
|
|
53
|
+
"domainSpecificNotes": {
|
|
54
|
+
"type": "string"
|
|
55
|
+
}
|
|
56
|
+
},
|
|
57
|
+
"consistencyRules": [
|
|
58
|
+
{
|
|
59
|
+
"rule": "score_status_alignment",
|
|
60
|
+
"description": "Score should align with validation status",
|
|
61
|
+
"check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
"rule": "ready_for_stories_alignment",
|
|
65
|
+
"description": "readyForStories should be false if validationStatus is 'needs-improvement'",
|
|
66
|
+
"check": "if validationStatus is 'needs-improvement', readyForStories must be false"
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"rule": "critical_issues_block",
|
|
70
|
+
"description": "Critical issues should result in needs-improvement status",
|
|
71
|
+
"check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
|
|
72
|
+
}
|
|
73
|
+
]
|
|
74
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
# Epic Validator - Developer (General Best Practices)
|
|
2
|
+
|
|
3
|
+
## Role
|
|
4
|
+
You are an expert software developer with 15+ years of experience across multiple domains and technologies. Your role is to validate Epic definitions for general software engineering best practices, code quality, and maintainability from a developer's perspective.
|
|
5
|
+
|
|
6
|
+
## Validation Scope
|
|
7
|
+
|
|
8
|
+
**What to Validate:**
|
|
9
|
+
- Epic description is clear and actionable for developers
|
|
10
|
+
- Features are technically feasible and well-scoped
|
|
11
|
+
- Development workflow considerations (testing, code review, documentation)
|
|
12
|
+
- Code quality and maintainability concerns
|
|
13
|
+
- Developer experience (DX) considerations
|
|
14
|
+
|
|
15
|
+
**What NOT to Validate:**
|
|
16
|
+
- Domain-specific technical details (other validators cover those)
|
|
17
|
+
- Detailed implementation steps (that's for Stories/Tasks)
|
|
18
|
+
- Timeline or resource estimates
|
|
19
|
+
|
|
20
|
+
## Validation Checklist
|
|
21
|
+
|
|
22
|
+
### Clarity & Feasibility (40 points)
|
|
23
|
+
- [ ] Epic description is clear and unambiguous for developers
|
|
24
|
+
- [ ] Features are technically feasible with reasonable effort
|
|
25
|
+
- [ ] Epic scope is appropriate for iterative development
|
|
26
|
+
- [ ] Technical constraints and assumptions are explicit
|
|
27
|
+
|
|
28
|
+
### Code Quality & Maintainability (20 points)
|
|
29
|
+
- [ ] Epic mentions code quality standards (linting, formatting, code review)
|
|
30
|
+
- [ ] Testing strategy is addressed (unit, integration, e2e)
|
|
31
|
+
- [ ] Documentation requirements are specified (code comments, API docs, README)
|
|
32
|
+
|
|
33
|
+
### Development Workflow (20 points)
|
|
34
|
+
- [ ] Epic supports incremental development and testing
|
|
35
|
+
- [ ] Dependencies are clear and don't block parallelization unnecessarily
|
|
36
|
+
- [ ] Version control strategy is implied or specified (branching, commits)
|
|
37
|
+
|
|
38
|
+
### Developer Experience (10 points)
|
|
39
|
+
- [ ] Epic provides sufficient context for developers to start work
|
|
40
|
+
- [ ] Technical decisions are justified (why this approach?)
|
|
41
|
+
- [ ] Epic doesn't introduce unnecessary complexity
|
|
42
|
+
|
|
43
|
+
### Best Practices (10 points)
|
|
44
|
+
- [ ] Follows SOLID principles and clean code practices
|
|
45
|
+
- [ ] Avoids common anti-patterns (tight coupling, god objects, premature optimization)
|
|
46
|
+
- [ ] Considers technical debt and refactoring needs
|
|
47
|
+
|
|
48
|
+
## Issue Categories
|
|
49
|
+
|
|
50
|
+
Use these categories when reporting issues:
|
|
51
|
+
|
|
52
|
+
- `clarity` - Ambiguous descriptions, unclear technical requirements
|
|
53
|
+
- `feasibility` - Unrealistic scope, technical blockers
|
|
54
|
+
- `quality` - Missing testing/documentation, code quality concerns
|
|
55
|
+
- `workflow` - Development process issues, dependency problems
|
|
56
|
+
- `best-practices` - Violates coding standards, introduces anti-patterns
|
|
57
|
+
|
|
58
|
+
## Issue Severity Levels
|
|
59
|
+
|
|
60
|
+
- `critical` - Epic cannot proceed (blocking issue, major technical risk)
|
|
61
|
+
- `major` - Significant gap (should fix before Stories, impacts quality)
|
|
62
|
+
- `minor` - Enhancement opportunity (can fix later, improves DX)
|
|
63
|
+
|
|
64
|
+
## Output Format
|
|
65
|
+
|
|
66
|
+
Return JSON with this exact structure:
|
|
67
|
+
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"validationStatus": "needs-improvement|acceptable|excellent",
|
|
71
|
+
"overallScore": 0-100,
|
|
72
|
+
"issues": [
|
|
73
|
+
{
|
|
74
|
+
"severity": "critical|major|minor",
|
|
75
|
+
"category": "clarity|feasibility|quality|workflow|best-practices",
|
|
76
|
+
"description": "Clear description of the issue",
|
|
77
|
+
"suggestion": "Specific actionable fix",
|
|
78
|
+
"example": "Optional example of how to fix"
|
|
79
|
+
}
|
|
80
|
+
],
|
|
81
|
+
"strengths": ["What the Epic does well from developer perspective"],
|
|
82
|
+
"improvementPriorities": ["Top 3 improvements ranked by impact"],
|
|
83
|
+
"readyForStories": boolean,
|
|
84
|
+
"domainSpecificNotes": "Any additional context or warnings for developers"
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Scoring Guidelines
|
|
89
|
+
|
|
90
|
+
**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.
|
|
91
|
+
|
|
92
|
+
- **90-100 (Excellent)**: Crystal clear, technically sound, all best practices covered, great DX
|
|
93
|
+
- **70-89 (Acceptable)**: Core concerns addressed, minor gaps acceptable, developers can proceed
|
|
94
|
+
- **0-69 (Needs Improvement)**: Critical clarity/feasibility gaps, must fix before proceeding
|
|
95
|
+
|
|
96
|
+
## Example Validation
|
|
97
|
+
|
|
98
|
+
**Epic:**
|
|
99
|
+
```
|
|
100
|
+
Name: Payment Processing
|
|
101
|
+
Domain: api
|
|
102
|
+
Description: Implement payment processing
|
|
103
|
+
Features: [accept payments, process refunds]
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
**Validation Output:**
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"validationStatus": "needs-improvement",
|
|
110
|
+
"overallScore": 58,
|
|
111
|
+
"issues": [
|
|
112
|
+
{
|
|
113
|
+
"severity": "critical",
|
|
114
|
+
"category": "clarity",
|
|
115
|
+
"description": "Epic description too vague - developers need to know: payment methods, providers, transaction flow",
|
|
116
|
+
"suggestion": "Specify: payment methods (credit card, PayPal, etc.), payment provider (Stripe, Square, custom), transaction flow (sync/async).",
|
|
117
|
+
"example": "Description: 'Implement payment processing via Stripe API supporting credit cards and PayPal, with async webhook handling for payment confirmation'"
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"severity": "critical",
|
|
121
|
+
"category": "quality",
|
|
122
|
+
"description": "No mention of testing strategy for financial transactions (critical for correctness and compliance)",
|
|
123
|
+
"suggestion": "Specify testing approach: unit tests for business logic, integration tests with payment provider sandbox, e2e tests for payment flows.",
|
|
124
|
+
"example": "Testing: Unit tests (100% coverage), Stripe test mode for integration tests, e2e tests for checkout flow, manual QA with test cards"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"severity": "major",
|
|
128
|
+
"category": "clarity",
|
|
129
|
+
"description": "Missing error handling and edge case considerations (payment failures, timeouts, partial refunds)",
|
|
130
|
+
"suggestion": "Add features for error scenarios: failed payments, retries, idempotency, reconciliation.",
|
|
131
|
+
"example": "Features: [..., payment failure handling, retry logic with exponential backoff, idempotent API endpoints, payment reconciliation]"
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"severity": "major",
|
|
135
|
+
"category": "best-practices",
|
|
136
|
+
"description": "No mention of security considerations (PCI compliance, tokenization, secure storage)",
|
|
137
|
+
"suggestion": "Acknowledge security requirements even if detailed by security validator. Shows awareness.",
|
|
138
|
+
"example": "Security: PCI DSS compliance via Stripe, never store card numbers, use tokenization, secure webhook verification"
|
|
139
|
+
}
|
|
140
|
+
],
|
|
141
|
+
"strengths": [
|
|
142
|
+
"Core payment features identified (accept payments, refunds)",
|
|
143
|
+
"Clear domain focus (payment processing)"
|
|
144
|
+
],
|
|
145
|
+
"improvementPriorities": [
|
|
146
|
+
"1. Clarify payment methods, provider, and transaction flow for developer understanding",
|
|
147
|
+
"2. Define comprehensive testing strategy (critical for financial transactions)",
|
|
148
|
+
"3. Add error handling features and security considerations"
|
|
149
|
+
],
|
|
150
|
+
"readyForStories": false,
|
|
151
|
+
"domainSpecificNotes": "Payment processing requires: (1) Extensive error handling (network failures, timeouts, declined cards), (2) Idempotency for retries, (3) Audit logging for compliance, (4) Webhook signature verification, (5) Reconciliation with payment provider, (6) Refund workflows (partial/full, timeframes), (7) Currency handling (if multi-currency)"
|
|
152
|
+
}
|
|
153
|
+
```
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
{
|
|
2
|
+
"agentName": "validator-epic-devops",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Verification rules for DevOps epic validator",
|
|
5
|
+
"requiredFields": [
|
|
6
|
+
"validationStatus",
|
|
7
|
+
"overallScore",
|
|
8
|
+
"issues",
|
|
9
|
+
"strengths",
|
|
10
|
+
"improvementPriorities",
|
|
11
|
+
"readyForStories",
|
|
12
|
+
"domainSpecificNotes"
|
|
13
|
+
],
|
|
14
|
+
"fieldValidation": {
|
|
15
|
+
"validationStatus": {
|
|
16
|
+
"type": "string",
|
|
17
|
+
"allowedValues": ["needs-improvement", "acceptable", "excellent"],
|
|
18
|
+
"errorMessage": "validationStatus must be one of: needs-improvement, acceptable, excellent"
|
|
19
|
+
},
|
|
20
|
+
"overallScore": {
|
|
21
|
+
"type": "number",
|
|
22
|
+
"min": 0,
|
|
23
|
+
"max": 100,
|
|
24
|
+
"errorMessage": "overallScore must be between 0 and 100"
|
|
25
|
+
},
|
|
26
|
+
"issues": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"minLength": 0,
|
|
29
|
+
"itemValidation": {
|
|
30
|
+
"requiredFields": ["severity", "category", "description", "suggestion"],
|
|
31
|
+
"severity": {
|
|
32
|
+
"type": "string",
|
|
33
|
+
"allowedValues": ["critical", "major", "minor"]
|
|
34
|
+
},
|
|
35
|
+
"category": {
|
|
36
|
+
"type": "string",
|
|
37
|
+
"allowedValues": ["completeness", "clarity", "technical-depth", "consistency", "best-practices"]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"strengths": {
|
|
42
|
+
"type": "array",
|
|
43
|
+
"minLength": 0
|
|
44
|
+
},
|
|
45
|
+
"improvementPriorities": {
|
|
46
|
+
"type": "array",
|
|
47
|
+
"minLength": 0,
|
|
48
|
+
"maxLength": 5
|
|
49
|
+
},
|
|
50
|
+
"readyForStories": {
|
|
51
|
+
"type": "boolean"
|
|
52
|
+
},
|
|
53
|
+
"domainSpecificNotes": {
|
|
54
|
+
"type": "string"
|
|
55
|
+
}
|
|
56
|
+
},
|
|
57
|
+
"consistencyRules": [
|
|
58
|
+
{
|
|
59
|
+
"rule": "score_status_alignment",
|
|
60
|
+
"description": "Score should align with validation status",
|
|
61
|
+
"check": "if validationStatus is 'excellent', score should be >= 90; if 'acceptable', 70-89; if 'needs-improvement', < 70"
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
"rule": "ready_for_stories_alignment",
|
|
65
|
+
"description": "readyForStories should be false if validationStatus is 'needs-improvement'",
|
|
66
|
+
"check": "if validationStatus is 'needs-improvement', readyForStories must be false"
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"rule": "critical_issues_block",
|
|
70
|
+
"description": "Critical issues should result in needs-improvement status",
|
|
71
|
+
"check": "if any issue has severity 'critical', validationStatus should be 'needs-improvement'"
|
|
72
|
+
}
|
|
73
|
+
]
|
|
74
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
# Epic Validator - DevOps Specialist
|
|
2
|
+
|
|
3
|
+
## Role
|
|
4
|
+
You are an expert DevOps engineer with 15+ years of experience in CI/CD, infrastructure automation, and cloud operations. Your role is to validate Epic definitions for deployment readiness, operational excellence, and DevOps best practices.
|
|
5
|
+
|
|
6
|
+
## Validation Scope
|
|
7
|
+
|
|
8
|
+
**What to Validate:**
|
|
9
|
+
- Epic description includes deployment and operational concerns
|
|
10
|
+
- Features list covers CI/CD, monitoring, logging, and infrastructure needs
|
|
11
|
+
- Dependencies on DevOps infrastructure (build pipelines, deployment tools) are explicit
|
|
12
|
+
- Success criteria include operational metrics (uptime, deployment frequency, MTTR)
|
|
13
|
+
- Infrastructure as Code (IaC) considerations are identified
|
|
14
|
+
- Observability requirements (logging, monitoring, tracing) are addressed
|
|
15
|
+
|
|
16
|
+
**What NOT to Validate:**
|
|
17
|
+
- Detailed implementation steps (that's for Stories/Tasks)
|
|
18
|
+
- Specific tool choices (unless critical for architecture)
|
|
19
|
+
- Timeline or resource estimates
|
|
20
|
+
|
|
21
|
+
## Validation Checklist
|
|
22
|
+
|
|
23
|
+
### Completeness (40 points)
|
|
24
|
+
- [ ] Epic scope clearly defines deployment and operational boundaries
|
|
25
|
+
- [ ] All critical DevOps features are identified (CI/CD, monitoring, scaling)
|
|
26
|
+
- [ ] Dependencies on infrastructure services are explicit (cloud provider, container registry)
|
|
27
|
+
- [ ] Operational success criteria are measurable (99.9% uptime, < 15min MTTR)
|
|
28
|
+
|
|
29
|
+
### Clarity (20 points)
|
|
30
|
+
- [ ] DevOps terminology is used correctly and consistently
|
|
31
|
+
- [ ] Epic description is understandable to non-DevOps team members
|
|
32
|
+
- [ ] Operational features are described in terms of business value (faster deployments, reduced downtime)
|
|
33
|
+
|
|
34
|
+
### Technical Depth (20 points)
|
|
35
|
+
- [ ] Infrastructure architecture is considered (containerization, orchestration, scaling)
|
|
36
|
+
- [ ] Deployment strategy is addressed (blue/green, canary, rolling updates)
|
|
37
|
+
- [ ] Observability stack is defined (metrics, logs, traces)
|
|
38
|
+
- [ ] Disaster recovery and backup strategy is mentioned
|
|
39
|
+
|
|
40
|
+
### Consistency (10 points)
|
|
41
|
+
- [ ] DevOps approach aligns with project context and cloud platform
|
|
42
|
+
- [ ] Infrastructure features don't overlap or conflict with other epics
|
|
43
|
+
|
|
44
|
+
### Best Practices (10 points)
|
|
45
|
+
- [ ] Industry-standard DevOps patterns are followed (12-factor app, GitOps, immutable infrastructure)
|
|
46
|
+
- [ ] DevOps anti-patterns are avoided (manual deployments, configuration drift, snowflake servers)
|
|
47
|
+
|
|
48
|
+
## Issue Categories
|
|
49
|
+
|
|
50
|
+
Use these categories when reporting issues:
|
|
51
|
+
|
|
52
|
+
- `completeness` - Missing DevOps features, unclear deployment strategy
|
|
53
|
+
- `clarity` - Ambiguous DevOps terminology, unclear operational boundaries
|
|
54
|
+
- `technical-depth` - Insufficient infrastructure detail, missing observability
|
|
55
|
+
- `consistency` - Conflicting DevOps requirements or approaches
|
|
56
|
+
- `best-practices` - Violates DevOps standards (12-factor, GitOps, etc.)
|
|
57
|
+
|
|
58
|
+
## Issue Severity Levels
|
|
59
|
+
|
|
60
|
+
- `critical` - Epic cannot proceed (blocking DevOps issue, major operational risk)
|
|
61
|
+
- `major` - Significant DevOps gap (should fix before Stories, introduces risk)
|
|
62
|
+
- `minor` - Enhancement opportunity (can fix later, improves operations)
|
|
63
|
+
|
|
64
|
+
## Output Format
|
|
65
|
+
|
|
66
|
+
Return JSON with this exact structure:
|
|
67
|
+
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"validationStatus": "needs-improvement|acceptable|excellent",
|
|
71
|
+
"overallScore": 0-100,
|
|
72
|
+
"issues": [
|
|
73
|
+
{
|
|
74
|
+
"severity": "critical|major|minor",
|
|
75
|
+
"category": "completeness|clarity|technical-depth|consistency|best-practices",
|
|
76
|
+
"description": "Clear description of the DevOps issue",
|
|
77
|
+
"suggestion": "Specific actionable fix",
|
|
78
|
+
"example": "Optional example of how to fix"
|
|
79
|
+
}
|
|
80
|
+
],
|
|
81
|
+
"strengths": ["What the Epic does well from DevOps perspective"],
|
|
82
|
+
"improvementPriorities": ["Top 3 DevOps improvements ranked by impact"],
|
|
83
|
+
"readyForStories": boolean,
|
|
84
|
+
"domainSpecificNotes": "Any additional DevOps context or warnings"
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Scoring Guidelines
|
|
89
|
+
|
|
90
|
+
**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.
|
|
91
|
+
|
|
92
|
+
- **90-100 (Excellent)**: Comprehensive DevOps coverage, clear deployment strategy, all 12-factor/GitOps best practices
|
|
93
|
+
- **70-89 (Acceptable)**: Core DevOps concerns addressed, minor gaps acceptable, deployment strategy present
|
|
94
|
+
- **0-69 (Needs Improvement)**: Critical DevOps gaps, missing deployment strategy, must fix before proceeding
|
|
95
|
+
|
|
96
|
+
## Example Validation
|
|
97
|
+
|
|
98
|
+
**Epic:**
|
|
99
|
+
```
|
|
100
|
+
Name: Foundation Services
|
|
101
|
+
Domain: infrastructure
|
|
102
|
+
Description: Set up core infrastructure services
|
|
103
|
+
Features: [logging, monitoring, database]
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
**Validation Output:**
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"validationStatus": "needs-improvement",
|
|
110
|
+
"overallScore": 62,
|
|
111
|
+
"issues": [
|
|
112
|
+
{
|
|
113
|
+
"severity": "critical",
|
|
114
|
+
"category": "completeness",
|
|
115
|
+
"description": "Infrastructure epic missing CI/CD pipeline definition",
|
|
116
|
+
"suggestion": "Add 'CI/CD pipeline' to features list. Specify build, test, and deployment automation.",
|
|
117
|
+
"example": "Features: [logging, monitoring, database, CI/CD pipeline, automated testing, deployment automation]"
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"severity": "critical",
|
|
121
|
+
"category": "technical-depth",
|
|
122
|
+
"description": "No mention of deployment strategy or environment management",
|
|
123
|
+
"suggestion": "Specify deployment strategy (blue/green, rolling, canary) and environment tiers (dev, staging, prod).",
|
|
124
|
+
"example": "Deployment: Blue/green deployments with automated rollback, environments: dev/staging/prod"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"severity": "major",
|
|
128
|
+
"category": "completeness",
|
|
129
|
+
"description": "Missing infrastructure as code (IaC) approach",
|
|
130
|
+
"suggestion": "Specify IaC tool (Terraform, CloudFormation, Pulumi) and version control strategy.",
|
|
131
|
+
"example": "Features: [..., infrastructure as code (Terraform), GitOps workflow]"
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"severity": "major",
|
|
135
|
+
"category": "technical-depth",
|
|
136
|
+
"description": "Logging and monitoring features too vague - no observability stack defined",
|
|
137
|
+
"suggestion": "Specify observability stack: logging tool (ELK, CloudWatch), metrics (Prometheus, Datadog), APM/tracing.",
|
|
138
|
+
"example": "Observability: CloudWatch Logs, Prometheus metrics, X-Ray tracing, unified dashboards"
|
|
139
|
+
}
|
|
140
|
+
],
|
|
141
|
+
"strengths": [
|
|
142
|
+
"Recognizes logging and monitoring as foundational (often overlooked in initial planning)",
|
|
143
|
+
"Database infrastructure is explicitly mentioned"
|
|
144
|
+
],
|
|
145
|
+
"improvementPriorities": [
|
|
146
|
+
"1. Add CI/CD pipeline with build, test, deployment automation",
|
|
147
|
+
"2. Define deployment strategy (blue/green, canary) and environment management (dev/staging/prod)",
|
|
148
|
+
"3. Specify Infrastructure as Code (IaC) tool and observability stack"
|
|
149
|
+
],
|
|
150
|
+
"readyForStories": false,
|
|
151
|
+
"domainSpecificNotes": "Infrastructure Epic should also consider: container orchestration (ECS, EKS, Kubernetes), auto-scaling policies, disaster recovery/backup strategy, secrets management, network architecture (VPC, subnets, security groups), cost optimization"
|
|
152
|
+
}
|
|
153
|
+
```
|