@agile-vibe-coding/avc 0.2.3 → 0.3.2

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.
Files changed (262) hide show
  1. package/README.md +475 -3
  2. package/cli/agents/agent-selector.md +23 -0
  3. package/cli/agents/code-implementer.md +117 -0
  4. package/cli/agents/code-validator.md +80 -0
  5. package/cli/agents/context-reviewer-epic.md +101 -0
  6. package/cli/agents/context-reviewer-story.md +92 -0
  7. package/cli/agents/context-writer-epic.md +145 -0
  8. package/cli/agents/context-writer-story.md +111 -0
  9. package/cli/agents/doc-writer-epic.md +42 -0
  10. package/cli/agents/doc-writer-story.md +43 -0
  11. package/cli/agents/duplicate-detector.md +110 -0
  12. package/cli/agents/epic-story-decomposer.md +318 -39
  13. package/cli/agents/mission-scope-generator.md +68 -4
  14. package/cli/agents/mission-scope-validator.md +40 -6
  15. package/cli/agents/project-context-extractor.md +21 -6
  16. package/cli/agents/scaffolding-generator.md +99 -0
  17. package/cli/agents/seed-validator.md +71 -0
  18. package/cli/agents/story-scope-reviewer.md +147 -0
  19. package/cli/agents/story-splitter.md +83 -0
  20. package/cli/agents/validator-documentation.json +31 -0
  21. package/cli/agents/validator-documentation.md +3 -1
  22. package/cli/api-reference-tool.js +368 -0
  23. package/cli/checks/catalog.json +76 -0
  24. package/cli/checks/code/quality.json +26 -0
  25. package/cli/checks/code/testing.json +14 -0
  26. package/cli/checks/code/traceability.json +26 -0
  27. package/cli/checks/cross-refs/epic.json +171 -0
  28. package/cli/checks/cross-refs/story.json +149 -0
  29. package/cli/checks/epic/api.json +114 -0
  30. package/cli/checks/epic/backend.json +126 -0
  31. package/cli/checks/epic/cloud.json +126 -0
  32. package/cli/checks/epic/data.json +102 -0
  33. package/cli/checks/epic/database.json +114 -0
  34. package/cli/checks/epic/developer.json +182 -0
  35. package/cli/checks/epic/devops.json +174 -0
  36. package/cli/checks/epic/frontend.json +162 -0
  37. package/cli/checks/epic/mobile.json +102 -0
  38. package/cli/checks/epic/qa.json +90 -0
  39. package/cli/checks/epic/security.json +184 -0
  40. package/cli/checks/epic/solution-architect.json +192 -0
  41. package/cli/checks/epic/test-architect.json +90 -0
  42. package/cli/checks/epic/ui.json +102 -0
  43. package/cli/checks/epic/ux.json +90 -0
  44. package/cli/checks/fixes/epic-fix-template.md +10 -0
  45. package/cli/checks/fixes/story-fix-template.md +10 -0
  46. package/cli/checks/story/api.json +186 -0
  47. package/cli/checks/story/backend.json +102 -0
  48. package/cli/checks/story/cloud.json +102 -0
  49. package/cli/checks/story/data.json +210 -0
  50. package/cli/checks/story/database.json +102 -0
  51. package/cli/checks/story/developer.json +168 -0
  52. package/cli/checks/story/devops.json +102 -0
  53. package/cli/checks/story/frontend.json +174 -0
  54. package/cli/checks/story/mobile.json +102 -0
  55. package/cli/checks/story/qa.json +210 -0
  56. package/cli/checks/story/security.json +198 -0
  57. package/cli/checks/story/solution-architect.json +230 -0
  58. package/cli/checks/story/test-architect.json +210 -0
  59. package/cli/checks/story/ui.json +102 -0
  60. package/cli/checks/story/ux.json +102 -0
  61. package/cli/coding-order.js +401 -0
  62. package/cli/dependency-checker.js +72 -0
  63. package/cli/epic-story-validator.js +284 -799
  64. package/cli/index.js +0 -0
  65. package/cli/init-model-config.js +17 -10
  66. package/cli/init.js +514 -92
  67. package/cli/kanban-server-manager.js +1 -2
  68. package/cli/llm-claude.js +98 -31
  69. package/cli/llm-gemini.js +29 -5
  70. package/cli/llm-local.js +493 -0
  71. package/cli/llm-openai.js +262 -41
  72. package/cli/llm-provider.js +147 -8
  73. package/cli/llm-token-limits.js +113 -4
  74. package/cli/llm-verifier.js +209 -1
  75. package/cli/llm-xiaomi.js +143 -0
  76. package/cli/message-constants.js +3 -12
  77. package/cli/messaging-api.js +6 -12
  78. package/cli/micro-check-fixer.js +335 -0
  79. package/cli/micro-check-runner.js +449 -0
  80. package/cli/micro-check-scorer.js +148 -0
  81. package/cli/micro-check-validator.js +538 -0
  82. package/cli/model-pricing.js +23 -0
  83. package/cli/model-selector.js +3 -2
  84. package/cli/prompt-logger.js +57 -0
  85. package/cli/repl-ink.js +106 -346
  86. package/cli/repl-old.js +1 -2
  87. package/cli/seed-processor.js +194 -24
  88. package/cli/sprint-planning-processor.js +2638 -289
  89. package/cli/template-processor.js +50 -3
  90. package/cli/token-tracker.js +50 -23
  91. package/cli/tools/generate-story-validators.js +1 -1
  92. package/cli/validation-router.js +70 -8
  93. package/cli/worktree-runner.js +654 -0
  94. package/kanban/client/dist/assets/index-D_KC5EQT.css +1 -0
  95. package/kanban/client/dist/assets/index-DjY5zqW7.js +351 -0
  96. package/kanban/client/dist/index.html +2 -2
  97. package/kanban/client/src/App.jsx +43 -14
  98. package/kanban/client/src/components/ceremony/AskArchPopup.jsx +7 -3
  99. package/kanban/client/src/components/ceremony/AskModelPopup.jsx +23 -10
  100. package/kanban/client/src/components/ceremony/CeremonyWorkflowModal.jsx +320 -133
  101. package/kanban/client/src/components/ceremony/ProviderSwitcherButton.jsx +290 -0
  102. package/kanban/client/src/components/ceremony/SponsorCallModal.jsx +80 -13
  103. package/kanban/client/src/components/ceremony/SprintPlanningModal.jsx +156 -22
  104. package/kanban/client/src/components/ceremony/steps/ArchitectureStep.jsx +11 -11
  105. package/kanban/client/src/components/ceremony/steps/CompleteStep.jsx +3 -21
  106. package/kanban/client/src/components/ceremony/steps/ReviewAnswersStep.jsx +214 -10
  107. package/kanban/client/src/components/ceremony/steps/RunningStep.jsx +23 -2
  108. package/kanban/client/src/components/kanban/CardDetailModal.jsx +97 -10
  109. package/kanban/client/src/components/kanban/GroupingSelector.jsx +7 -1
  110. package/kanban/client/src/components/kanban/KanbanCard.jsx +23 -14
  111. package/kanban/client/src/components/kanban/RefineWorkItemPopup.jsx +9 -14
  112. package/kanban/client/src/components/kanban/RunButton.jsx +162 -0
  113. package/kanban/client/src/components/kanban/SeedButton.jsx +176 -0
  114. package/kanban/client/src/components/settings/AgentsTab.jsx +103 -75
  115. package/kanban/client/src/components/settings/ApiKeysTab.jsx +31 -2
  116. package/kanban/client/src/components/settings/CeremonyModelsTab.jsx +9 -2
  117. package/kanban/client/src/components/settings/CheckEditorPopup.jsx +507 -0
  118. package/kanban/client/src/components/settings/CostThresholdsTab.jsx +3 -2
  119. package/kanban/client/src/components/settings/ModelPricingTab.jsx +72 -7
  120. package/kanban/client/src/components/settings/OpenAIAuthSection.jsx +412 -0
  121. package/kanban/client/src/components/settings/SettingsModal.jsx +4 -4
  122. package/kanban/client/src/components/stats/CostModal.jsx +34 -3
  123. package/kanban/client/src/hooks/useGrouping.js +59 -0
  124. package/kanban/client/src/lib/api.js +118 -4
  125. package/kanban/client/src/lib/status-grouping.js +10 -0
  126. package/kanban/client/src/store/kanbanStore.js +8 -0
  127. package/kanban/server/index.js +23 -2
  128. package/kanban/server/routes/ceremony.js +153 -4
  129. package/kanban/server/routes/costs.js +9 -3
  130. package/kanban/server/routes/openai-oauth.js +366 -0
  131. package/kanban/server/routes/settings.js +447 -14
  132. package/kanban/server/routes/websocket.js +7 -2
  133. package/kanban/server/routes/work-items.js +141 -1
  134. package/kanban/server/services/CeremonyService.js +275 -24
  135. package/kanban/server/services/TaskRunnerService.js +261 -0
  136. package/kanban/server/workers/run-task-worker.js +121 -0
  137. package/kanban/server/workers/seed-worker.js +94 -0
  138. package/kanban/server/workers/sponsor-call-worker.js +14 -6
  139. package/kanban/server/workers/sprint-planning-worker.js +94 -12
  140. package/package.json +2 -3
  141. package/cli/agents/solver-epic-api.json +0 -15
  142. package/cli/agents/solver-epic-api.md +0 -39
  143. package/cli/agents/solver-epic-backend.json +0 -15
  144. package/cli/agents/solver-epic-backend.md +0 -39
  145. package/cli/agents/solver-epic-cloud.json +0 -15
  146. package/cli/agents/solver-epic-cloud.md +0 -39
  147. package/cli/agents/solver-epic-data.json +0 -15
  148. package/cli/agents/solver-epic-data.md +0 -39
  149. package/cli/agents/solver-epic-database.json +0 -15
  150. package/cli/agents/solver-epic-database.md +0 -39
  151. package/cli/agents/solver-epic-developer.json +0 -15
  152. package/cli/agents/solver-epic-developer.md +0 -39
  153. package/cli/agents/solver-epic-devops.json +0 -15
  154. package/cli/agents/solver-epic-devops.md +0 -39
  155. package/cli/agents/solver-epic-frontend.json +0 -15
  156. package/cli/agents/solver-epic-frontend.md +0 -39
  157. package/cli/agents/solver-epic-mobile.json +0 -15
  158. package/cli/agents/solver-epic-mobile.md +0 -39
  159. package/cli/agents/solver-epic-qa.json +0 -15
  160. package/cli/agents/solver-epic-qa.md +0 -39
  161. package/cli/agents/solver-epic-security.json +0 -15
  162. package/cli/agents/solver-epic-security.md +0 -39
  163. package/cli/agents/solver-epic-solution-architect.json +0 -15
  164. package/cli/agents/solver-epic-solution-architect.md +0 -39
  165. package/cli/agents/solver-epic-test-architect.json +0 -15
  166. package/cli/agents/solver-epic-test-architect.md +0 -39
  167. package/cli/agents/solver-epic-ui.json +0 -15
  168. package/cli/agents/solver-epic-ui.md +0 -39
  169. package/cli/agents/solver-epic-ux.json +0 -15
  170. package/cli/agents/solver-epic-ux.md +0 -39
  171. package/cli/agents/solver-story-api.json +0 -15
  172. package/cli/agents/solver-story-api.md +0 -39
  173. package/cli/agents/solver-story-backend.json +0 -15
  174. package/cli/agents/solver-story-backend.md +0 -39
  175. package/cli/agents/solver-story-cloud.json +0 -15
  176. package/cli/agents/solver-story-cloud.md +0 -39
  177. package/cli/agents/solver-story-data.json +0 -15
  178. package/cli/agents/solver-story-data.md +0 -39
  179. package/cli/agents/solver-story-database.json +0 -15
  180. package/cli/agents/solver-story-database.md +0 -39
  181. package/cli/agents/solver-story-developer.json +0 -15
  182. package/cli/agents/solver-story-developer.md +0 -39
  183. package/cli/agents/solver-story-devops.json +0 -15
  184. package/cli/agents/solver-story-devops.md +0 -39
  185. package/cli/agents/solver-story-frontend.json +0 -15
  186. package/cli/agents/solver-story-frontend.md +0 -39
  187. package/cli/agents/solver-story-mobile.json +0 -15
  188. package/cli/agents/solver-story-mobile.md +0 -39
  189. package/cli/agents/solver-story-qa.json +0 -15
  190. package/cli/agents/solver-story-qa.md +0 -39
  191. package/cli/agents/solver-story-security.json +0 -15
  192. package/cli/agents/solver-story-security.md +0 -39
  193. package/cli/agents/solver-story-solution-architect.json +0 -15
  194. package/cli/agents/solver-story-solution-architect.md +0 -39
  195. package/cli/agents/solver-story-test-architect.json +0 -15
  196. package/cli/agents/solver-story-test-architect.md +0 -39
  197. package/cli/agents/solver-story-ui.json +0 -15
  198. package/cli/agents/solver-story-ui.md +0 -39
  199. package/cli/agents/solver-story-ux.json +0 -15
  200. package/cli/agents/solver-story-ux.md +0 -39
  201. package/cli/agents/validator-epic-api.json +0 -93
  202. package/cli/agents/validator-epic-api.md +0 -137
  203. package/cli/agents/validator-epic-backend.json +0 -93
  204. package/cli/agents/validator-epic-backend.md +0 -130
  205. package/cli/agents/validator-epic-cloud.json +0 -93
  206. package/cli/agents/validator-epic-cloud.md +0 -137
  207. package/cli/agents/validator-epic-data.json +0 -93
  208. package/cli/agents/validator-epic-data.md +0 -130
  209. package/cli/agents/validator-epic-database.json +0 -93
  210. package/cli/agents/validator-epic-database.md +0 -137
  211. package/cli/agents/validator-epic-developer.json +0 -74
  212. package/cli/agents/validator-epic-developer.md +0 -153
  213. package/cli/agents/validator-epic-devops.json +0 -74
  214. package/cli/agents/validator-epic-devops.md +0 -153
  215. package/cli/agents/validator-epic-frontend.json +0 -74
  216. package/cli/agents/validator-epic-frontend.md +0 -153
  217. package/cli/agents/validator-epic-mobile.json +0 -93
  218. package/cli/agents/validator-epic-mobile.md +0 -130
  219. package/cli/agents/validator-epic-qa.json +0 -93
  220. package/cli/agents/validator-epic-qa.md +0 -130
  221. package/cli/agents/validator-epic-security.json +0 -74
  222. package/cli/agents/validator-epic-security.md +0 -154
  223. package/cli/agents/validator-epic-solution-architect.json +0 -74
  224. package/cli/agents/validator-epic-solution-architect.md +0 -156
  225. package/cli/agents/validator-epic-test-architect.json +0 -93
  226. package/cli/agents/validator-epic-test-architect.md +0 -130
  227. package/cli/agents/validator-epic-ui.json +0 -93
  228. package/cli/agents/validator-epic-ui.md +0 -130
  229. package/cli/agents/validator-epic-ux.json +0 -93
  230. package/cli/agents/validator-epic-ux.md +0 -130
  231. package/cli/agents/validator-story-api.json +0 -104
  232. package/cli/agents/validator-story-api.md +0 -152
  233. package/cli/agents/validator-story-backend.json +0 -104
  234. package/cli/agents/validator-story-backend.md +0 -152
  235. package/cli/agents/validator-story-cloud.json +0 -104
  236. package/cli/agents/validator-story-cloud.md +0 -152
  237. package/cli/agents/validator-story-data.json +0 -104
  238. package/cli/agents/validator-story-data.md +0 -152
  239. package/cli/agents/validator-story-database.json +0 -104
  240. package/cli/agents/validator-story-database.md +0 -152
  241. package/cli/agents/validator-story-developer.json +0 -104
  242. package/cli/agents/validator-story-developer.md +0 -152
  243. package/cli/agents/validator-story-devops.json +0 -104
  244. package/cli/agents/validator-story-devops.md +0 -152
  245. package/cli/agents/validator-story-frontend.json +0 -104
  246. package/cli/agents/validator-story-frontend.md +0 -152
  247. package/cli/agents/validator-story-mobile.json +0 -104
  248. package/cli/agents/validator-story-mobile.md +0 -152
  249. package/cli/agents/validator-story-qa.json +0 -104
  250. package/cli/agents/validator-story-qa.md +0 -152
  251. package/cli/agents/validator-story-security.json +0 -104
  252. package/cli/agents/validator-story-security.md +0 -152
  253. package/cli/agents/validator-story-solution-architect.json +0 -104
  254. package/cli/agents/validator-story-solution-architect.md +0 -152
  255. package/cli/agents/validator-story-test-architect.json +0 -104
  256. package/cli/agents/validator-story-test-architect.md +0 -152
  257. package/cli/agents/validator-story-ui.json +0 -104
  258. package/cli/agents/validator-story-ui.md +0 -152
  259. package/cli/agents/validator-story-ux.json +0 -104
  260. package/cli/agents/validator-story-ux.md +0 -152
  261. package/kanban/client/dist/assets/index-CiD8PS2e.js +0 -306
  262. package/kanban/client/dist/assets/index-nLh0m82Q.css +0 -1
@@ -1,93 +0,0 @@
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
- }
@@ -1,137 +0,0 @@
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
- ```
@@ -1,74 +0,0 @@
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
- }
@@ -1,153 +0,0 @@
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
- ```
@@ -1,74 +0,0 @@
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
- }
@@ -1,153 +0,0 @@
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
- ```