@agile-vibe-coding/avc 0.1.1 → 0.3.1

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 (239) hide show
  1. package/cli/agent-loader.js +21 -0
  2. package/cli/agents/agent-selector.md +152 -0
  3. package/cli/agents/architecture-recommender.md +418 -0
  4. package/cli/agents/code-implementer.md +117 -0
  5. package/cli/agents/code-validator.md +80 -0
  6. package/cli/agents/context-reviewer-epic.md +101 -0
  7. package/cli/agents/context-reviewer-story.md +92 -0
  8. package/cli/agents/context-writer-epic.md +145 -0
  9. package/cli/agents/context-writer-story.md +111 -0
  10. package/cli/agents/database-deep-dive.md +470 -0
  11. package/cli/agents/database-recommender.md +634 -0
  12. package/cli/agents/doc-distributor.md +176 -0
  13. package/cli/agents/doc-writer-epic.md +42 -0
  14. package/cli/agents/doc-writer-story.md +43 -0
  15. package/cli/agents/documentation-updater.md +203 -0
  16. package/cli/agents/duplicate-detector.md +110 -0
  17. package/cli/agents/epic-story-decomposer.md +559 -0
  18. package/cli/agents/feature-context-generator.md +91 -0
  19. package/cli/agents/gap-checker-epic.md +52 -0
  20. package/cli/agents/impact-checker-story.md +51 -0
  21. package/cli/agents/migration-guide-generator.md +305 -0
  22. package/cli/agents/mission-scope-generator.md +143 -0
  23. package/cli/agents/mission-scope-validator.md +146 -0
  24. package/cli/agents/project-context-extractor.md +122 -0
  25. package/cli/agents/project-documentation-creator.json +226 -0
  26. package/cli/agents/project-documentation-creator.md +595 -0
  27. package/cli/agents/question-prefiller.md +269 -0
  28. package/cli/agents/refiner-epic.md +39 -0
  29. package/cli/agents/refiner-story.md +42 -0
  30. package/cli/agents/scaffolding-generator.md +99 -0
  31. package/cli/agents/seed-validator.md +71 -0
  32. package/cli/agents/story-doc-enricher.md +133 -0
  33. package/cli/agents/story-scope-reviewer.md +147 -0
  34. package/cli/agents/story-splitter.md +83 -0
  35. package/cli/agents/suggestion-business-analyst.md +88 -0
  36. package/cli/agents/suggestion-deployment-architect.md +263 -0
  37. package/cli/agents/suggestion-product-manager.md +129 -0
  38. package/cli/agents/suggestion-security-specialist.md +156 -0
  39. package/cli/agents/suggestion-technical-architect.md +269 -0
  40. package/cli/agents/suggestion-ux-researcher.md +93 -0
  41. package/cli/agents/task-subtask-decomposer.md +188 -0
  42. package/cli/agents/validator-documentation.json +183 -0
  43. package/cli/agents/validator-documentation.md +455 -0
  44. package/cli/agents/validator-selector.md +211 -0
  45. package/cli/ansi-colors.js +21 -0
  46. package/cli/api-reference-tool.js +368 -0
  47. package/cli/build-docs.js +29 -8
  48. package/cli/ceremony-history.js +369 -0
  49. package/cli/checks/catalog.json +76 -0
  50. package/cli/checks/code/quality.json +26 -0
  51. package/cli/checks/code/testing.json +14 -0
  52. package/cli/checks/code/traceability.json +26 -0
  53. package/cli/checks/cross-refs/epic.json +171 -0
  54. package/cli/checks/cross-refs/story.json +149 -0
  55. package/cli/checks/epic/api.json +114 -0
  56. package/cli/checks/epic/backend.json +126 -0
  57. package/cli/checks/epic/cloud.json +126 -0
  58. package/cli/checks/epic/data.json +102 -0
  59. package/cli/checks/epic/database.json +114 -0
  60. package/cli/checks/epic/developer.json +182 -0
  61. package/cli/checks/epic/devops.json +174 -0
  62. package/cli/checks/epic/frontend.json +162 -0
  63. package/cli/checks/epic/mobile.json +102 -0
  64. package/cli/checks/epic/qa.json +90 -0
  65. package/cli/checks/epic/security.json +184 -0
  66. package/cli/checks/epic/solution-architect.json +192 -0
  67. package/cli/checks/epic/test-architect.json +90 -0
  68. package/cli/checks/epic/ui.json +102 -0
  69. package/cli/checks/epic/ux.json +90 -0
  70. package/cli/checks/fixes/epic-fix-template.md +10 -0
  71. package/cli/checks/fixes/story-fix-template.md +10 -0
  72. package/cli/checks/story/api.json +186 -0
  73. package/cli/checks/story/backend.json +102 -0
  74. package/cli/checks/story/cloud.json +102 -0
  75. package/cli/checks/story/data.json +210 -0
  76. package/cli/checks/story/database.json +102 -0
  77. package/cli/checks/story/developer.json +168 -0
  78. package/cli/checks/story/devops.json +102 -0
  79. package/cli/checks/story/frontend.json +174 -0
  80. package/cli/checks/story/mobile.json +102 -0
  81. package/cli/checks/story/qa.json +210 -0
  82. package/cli/checks/story/security.json +198 -0
  83. package/cli/checks/story/solution-architect.json +230 -0
  84. package/cli/checks/story/test-architect.json +210 -0
  85. package/cli/checks/story/ui.json +102 -0
  86. package/cli/checks/story/ux.json +102 -0
  87. package/cli/coding-order.js +401 -0
  88. package/cli/command-logger.js +49 -12
  89. package/cli/components/static-output.js +63 -0
  90. package/cli/console-output-manager.js +94 -0
  91. package/cli/dependency-checker.js +72 -0
  92. package/cli/docs-sync.js +306 -0
  93. package/cli/epic-story-validator.js +659 -0
  94. package/cli/evaluation-prompts.js +1008 -0
  95. package/cli/execution-context.js +195 -0
  96. package/cli/generate-summary-table.js +340 -0
  97. package/cli/init-model-config.js +704 -0
  98. package/cli/init.js +1737 -278
  99. package/cli/kanban-server-manager.js +227 -0
  100. package/cli/llm-claude.js +150 -1
  101. package/cli/llm-gemini.js +109 -0
  102. package/cli/llm-local.js +493 -0
  103. package/cli/llm-mock.js +233 -0
  104. package/cli/llm-openai.js +454 -0
  105. package/cli/llm-provider.js +379 -3
  106. package/cli/llm-token-limits.js +211 -0
  107. package/cli/llm-verifier.js +662 -0
  108. package/cli/llm-xiaomi.js +143 -0
  109. package/cli/message-constants.js +49 -0
  110. package/cli/message-manager.js +334 -0
  111. package/cli/message-types.js +96 -0
  112. package/cli/messaging-api.js +291 -0
  113. package/cli/micro-check-fixer.js +335 -0
  114. package/cli/micro-check-runner.js +449 -0
  115. package/cli/micro-check-scorer.js +148 -0
  116. package/cli/micro-check-validator.js +538 -0
  117. package/cli/model-pricing.js +192 -0
  118. package/cli/model-query-engine.js +468 -0
  119. package/cli/model-recommendation-analyzer.js +495 -0
  120. package/cli/model-selector.js +270 -0
  121. package/cli/output-buffer.js +107 -0
  122. package/cli/process-manager.js +73 -2
  123. package/cli/prompt-logger.js +57 -0
  124. package/cli/repl-ink.js +4625 -1094
  125. package/cli/repl-old.js +3 -4
  126. package/cli/seed-processor.js +962 -0
  127. package/cli/sprint-planning-processor.js +4162 -0
  128. package/cli/template-processor.js +2149 -105
  129. package/cli/templates/project.md +25 -8
  130. package/cli/templates/vitepress-config.mts.template +5 -4
  131. package/cli/token-tracker.js +547 -0
  132. package/cli/tools/generate-story-validators.js +317 -0
  133. package/cli/tools/generate-validators.js +669 -0
  134. package/cli/update-checker.js +19 -17
  135. package/cli/update-notifier.js +4 -4
  136. package/cli/validation-router.js +667 -0
  137. package/cli/verification-tracker.js +563 -0
  138. package/cli/worktree-runner.js +654 -0
  139. package/kanban/README.md +386 -0
  140. package/kanban/client/README.md +205 -0
  141. package/kanban/client/components.json +20 -0
  142. package/kanban/client/dist/assets/index-D_KC5EQT.css +1 -0
  143. package/kanban/client/dist/assets/index-DjY5zqW7.js +351 -0
  144. package/kanban/client/dist/index.html +16 -0
  145. package/kanban/client/dist/vite.svg +1 -0
  146. package/kanban/client/index.html +15 -0
  147. package/kanban/client/package-lock.json +9442 -0
  148. package/kanban/client/package.json +44 -0
  149. package/kanban/client/postcss.config.js +6 -0
  150. package/kanban/client/public/vite.svg +1 -0
  151. package/kanban/client/src/App.jsx +651 -0
  152. package/kanban/client/src/components/ProjectFileEditorPopup.jsx +117 -0
  153. package/kanban/client/src/components/ceremony/AskArchPopup.jsx +420 -0
  154. package/kanban/client/src/components/ceremony/AskModelPopup.jsx +629 -0
  155. package/kanban/client/src/components/ceremony/CeremonyWorkflowModal.jsx +1133 -0
  156. package/kanban/client/src/components/ceremony/EpicStorySelectionModal.jsx +254 -0
  157. package/kanban/client/src/components/ceremony/ProviderSwitcherButton.jsx +290 -0
  158. package/kanban/client/src/components/ceremony/SponsorCallModal.jsx +686 -0
  159. package/kanban/client/src/components/ceremony/SprintPlanningModal.jsx +838 -0
  160. package/kanban/client/src/components/ceremony/steps/ArchitectureStep.jsx +150 -0
  161. package/kanban/client/src/components/ceremony/steps/CompleteStep.jsx +136 -0
  162. package/kanban/client/src/components/ceremony/steps/DatabaseStep.jsx +202 -0
  163. package/kanban/client/src/components/ceremony/steps/DeploymentStep.jsx +123 -0
  164. package/kanban/client/src/components/ceremony/steps/MissionStep.jsx +106 -0
  165. package/kanban/client/src/components/ceremony/steps/ReviewAnswersStep.jsx +329 -0
  166. package/kanban/client/src/components/ceremony/steps/RunningStep.jsx +249 -0
  167. package/kanban/client/src/components/kanban/CardDetailModal.jsx +646 -0
  168. package/kanban/client/src/components/kanban/EpicSection.jsx +146 -0
  169. package/kanban/client/src/components/kanban/FilterToolbar.jsx +222 -0
  170. package/kanban/client/src/components/kanban/GroupingSelector.jsx +63 -0
  171. package/kanban/client/src/components/kanban/KanbanBoard.jsx +211 -0
  172. package/kanban/client/src/components/kanban/KanbanCard.jsx +147 -0
  173. package/kanban/client/src/components/kanban/KanbanColumn.jsx +90 -0
  174. package/kanban/client/src/components/kanban/RefineWorkItemPopup.jsx +784 -0
  175. package/kanban/client/src/components/kanban/RunButton.jsx +162 -0
  176. package/kanban/client/src/components/kanban/SeedButton.jsx +176 -0
  177. package/kanban/client/src/components/layout/LoadingScreen.jsx +82 -0
  178. package/kanban/client/src/components/process/ProcessMonitorBar.jsx +80 -0
  179. package/kanban/client/src/components/settings/AgentEditorPopup.jsx +171 -0
  180. package/kanban/client/src/components/settings/AgentsTab.jsx +381 -0
  181. package/kanban/client/src/components/settings/ApiKeysTab.jsx +142 -0
  182. package/kanban/client/src/components/settings/CeremonyModelsTab.jsx +105 -0
  183. package/kanban/client/src/components/settings/CheckEditorPopup.jsx +507 -0
  184. package/kanban/client/src/components/settings/CostThresholdsTab.jsx +95 -0
  185. package/kanban/client/src/components/settings/ModelPricingTab.jsx +269 -0
  186. package/kanban/client/src/components/settings/OpenAIAuthSection.jsx +412 -0
  187. package/kanban/client/src/components/settings/ServersTab.jsx +121 -0
  188. package/kanban/client/src/components/settings/SettingsModal.jsx +84 -0
  189. package/kanban/client/src/components/stats/CostModal.jsx +384 -0
  190. package/kanban/client/src/components/ui/badge.jsx +27 -0
  191. package/kanban/client/src/components/ui/dialog.jsx +121 -0
  192. package/kanban/client/src/components/ui/tabs.jsx +85 -0
  193. package/kanban/client/src/hooks/__tests__/useGrouping.test.js +232 -0
  194. package/kanban/client/src/hooks/useGrouping.js +177 -0
  195. package/kanban/client/src/hooks/useWebSocket.js +120 -0
  196. package/kanban/client/src/lib/__tests__/api.test.js +196 -0
  197. package/kanban/client/src/lib/__tests__/status-grouping.test.js +94 -0
  198. package/kanban/client/src/lib/api.js +515 -0
  199. package/kanban/client/src/lib/status-grouping.js +154 -0
  200. package/kanban/client/src/lib/utils.js +11 -0
  201. package/kanban/client/src/main.jsx +10 -0
  202. package/kanban/client/src/store/__tests__/kanbanStore.test.js +164 -0
  203. package/kanban/client/src/store/ceremonyStore.js +172 -0
  204. package/kanban/client/src/store/filterStore.js +201 -0
  205. package/kanban/client/src/store/kanbanStore.js +123 -0
  206. package/kanban/client/src/store/processStore.js +65 -0
  207. package/kanban/client/src/store/sprintPlanningStore.js +33 -0
  208. package/kanban/client/src/styles/globals.css +59 -0
  209. package/kanban/client/tailwind.config.js +77 -0
  210. package/kanban/client/vite.config.js +28 -0
  211. package/kanban/client/vitest.config.js +28 -0
  212. package/kanban/dev-start.sh +47 -0
  213. package/kanban/package.json +12 -0
  214. package/kanban/server/index.js +537 -0
  215. package/kanban/server/routes/ceremony.js +454 -0
  216. package/kanban/server/routes/costs.js +163 -0
  217. package/kanban/server/routes/openai-oauth.js +366 -0
  218. package/kanban/server/routes/processes.js +50 -0
  219. package/kanban/server/routes/settings.js +736 -0
  220. package/kanban/server/routes/websocket.js +281 -0
  221. package/kanban/server/routes/work-items.js +487 -0
  222. package/kanban/server/services/CeremonyService.js +1441 -0
  223. package/kanban/server/services/FileSystemScanner.js +95 -0
  224. package/kanban/server/services/FileWatcher.js +144 -0
  225. package/kanban/server/services/HierarchyBuilder.js +196 -0
  226. package/kanban/server/services/ProcessRegistry.js +122 -0
  227. package/kanban/server/services/TaskRunnerService.js +261 -0
  228. package/kanban/server/services/WorkItemReader.js +123 -0
  229. package/kanban/server/services/WorkItemRefineService.js +510 -0
  230. package/kanban/server/start.js +49 -0
  231. package/kanban/server/utils/kanban-logger.js +132 -0
  232. package/kanban/server/utils/markdown.js +91 -0
  233. package/kanban/server/utils/status-grouping.js +107 -0
  234. package/kanban/server/workers/run-task-worker.js +121 -0
  235. package/kanban/server/workers/seed-worker.js +94 -0
  236. package/kanban/server/workers/sponsor-call-worker.js +92 -0
  237. package/kanban/server/workers/sprint-planning-worker.js +212 -0
  238. package/package.json +19 -7
  239. package/cli/agents/documentation.md +0 -302
@@ -0,0 +1,114 @@
1
+ {
2
+ "perspective": "database",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "db-epic-01",
7
+ "tier": 1,
8
+ "perspective": "database",
9
+ "severity": "critical",
10
+ "category": "completeness",
11
+ "universal": false,
12
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations? (Does it store, query, or manage structured data?)",
13
+ "question": "Does the epic scope clearly define database boundaries?",
14
+ "failDescription": "Database boundaries are not defined — unclear which data entities and operations are in scope",
15
+ "failSuggestion": "Define database boundaries: which tables/collections, relationships, and operations belong to this epic"
16
+ },
17
+ {
18
+ "id": "db-epic-02",
19
+ "tier": 1,
20
+ "perspective": "database",
21
+ "severity": "critical",
22
+ "category": "completeness",
23
+ "universal": false,
24
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations?",
25
+ "question": "Are all critical database features identified?",
26
+ "failDescription": "Critical database features are missing — schema, indexes, or migration strategy not identified",
27
+ "failSuggestion": "Identify critical database features: schema definition, indexes, migrations, data validation constraints"
28
+ },
29
+ {
30
+ "id": "db-epic-03",
31
+ "tier": 1,
32
+ "perspective": "database",
33
+ "severity": "major",
34
+ "category": "completeness",
35
+ "universal": false,
36
+ "applicabilityQuestion": "Does this epic depend on database services or infrastructure?",
37
+ "question": "Are dependencies on database services/infrastructure explicit?",
38
+ "failDescription": "Database service dependencies are not explicit",
39
+ "failSuggestion": "Make database dependencies explicit: database engine, version, hosting, backup service"
40
+ },
41
+ {
42
+ "id": "db-epic-04",
43
+ "tier": 1,
44
+ "perspective": "database",
45
+ "severity": "major",
46
+ "category": "completeness",
47
+ "universal": false,
48
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations?",
49
+ "question": "Are database success criteria measurable?",
50
+ "failDescription": "Database success criteria are not measurable",
51
+ "failSuggestion": "Define measurable database criteria: query latency targets, throughput, data integrity constraints"
52
+ },
53
+ {
54
+ "id": "db-epic-05",
55
+ "tier": 1,
56
+ "perspective": "database",
57
+ "severity": "minor",
58
+ "category": "clarity",
59
+ "universal": false,
60
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations?",
61
+ "question": "Is database terminology used correctly?",
62
+ "failDescription": "Database terminology is used incorrectly or inconsistently",
63
+ "failSuggestion": "Review database terminology: normalization, indexes, foreign keys, constraints, migrations"
64
+ },
65
+ {
66
+ "id": "db-epic-06",
67
+ "tier": 1,
68
+ "perspective": "database",
69
+ "severity": "major",
70
+ "category": "technical-depth",
71
+ "universal": false,
72
+ "applicabilityQuestion": "Does this epic involve database architecture? (Does it need schema design, optimization, or scaling?)",
73
+ "question": "Are database architectural patterns considered?",
74
+ "failDescription": "Database architectural patterns are not considered",
75
+ "failSuggestion": "Consider database patterns: normalization/denormalization strategy, indexing, partitioning, replication"
76
+ },
77
+ {
78
+ "id": "db-epic-07",
79
+ "tier": 1,
80
+ "perspective": "database",
81
+ "severity": "major",
82
+ "category": "technical-depth",
83
+ "universal": false,
84
+ "applicabilityQuestion": "Does this epic involve database queries that need to perform well?",
85
+ "question": "Are performance/scalability concerns for database addressed?",
86
+ "failDescription": "Database performance and scalability concerns are not addressed",
87
+ "failSuggestion": "Address database performance: query optimization, indexing strategy, connection pooling, read replicas"
88
+ },
89
+ {
90
+ "id": "db-epic-08",
91
+ "tier": 1,
92
+ "perspective": "database",
93
+ "severity": "minor",
94
+ "category": "consistency",
95
+ "universal": false,
96
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations?",
97
+ "question": "Does the database approach align with project context?",
98
+ "failDescription": "Database approach does not align with project context",
99
+ "failSuggestion": "Ensure database approach aligns with project: consistent engine, naming conventions, migration strategy"
100
+ },
101
+ {
102
+ "id": "db-epic-09",
103
+ "tier": 1,
104
+ "perspective": "database",
105
+ "severity": "minor",
106
+ "category": "best-practices",
107
+ "universal": false,
108
+ "applicabilityQuestion": "Does this epic involve data persistence or database operations?",
109
+ "question": "Are industry-standard database patterns followed (normalization, indexing)?",
110
+ "failDescription": "Database best practices are not followed",
111
+ "failSuggestion": "Follow database best practices: proper normalization, strategic indexing, referential integrity constraints"
112
+ }
113
+ ]
114
+ }
@@ -0,0 +1,182 @@
1
+ {
2
+ "perspective": "developer",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "dev-epic-01",
7
+ "tier": 1,
8
+ "perspective": "developer",
9
+ "severity": "critical",
10
+ "category": "clarity-feasibility",
11
+ "universal": true,
12
+ "question": "Is the epic description clear and unambiguous for developers?",
13
+ "failDescription": "Epic description is vague or ambiguous — developers cannot understand what to build",
14
+ "failSuggestion": "Rewrite the epic description to be specific about what is being built, the approach, and key technical decisions"
15
+ },
16
+ {
17
+ "id": "dev-epic-02",
18
+ "tier": 1,
19
+ "perspective": "developer",
20
+ "severity": "critical",
21
+ "category": "clarity-feasibility",
22
+ "universal": true,
23
+ "question": "Are the features technically feasible with reasonable effort?",
24
+ "failDescription": "One or more features appear technically infeasible or require unreasonable effort",
25
+ "failSuggestion": "Review features for technical feasibility and break down overly complex features into achievable increments"
26
+ },
27
+ {
28
+ "id": "dev-epic-03",
29
+ "tier": 1,
30
+ "perspective": "developer",
31
+ "severity": "major",
32
+ "category": "clarity-feasibility",
33
+ "universal": true,
34
+ "question": "Is the epic scope appropriate for iterative development?",
35
+ "failDescription": "Epic scope is too large or too small for iterative development",
36
+ "failSuggestion": "Adjust scope to be deliverable in stories that each cover a single cohesive capability — add as many as needed to fully cover the epic"
37
+ },
38
+ {
39
+ "id": "dev-epic-04",
40
+ "tier": 1,
41
+ "perspective": "developer",
42
+ "severity": "major",
43
+ "category": "clarity-feasibility",
44
+ "universal": true,
45
+ "question": "Are technical constraints and assumptions explicitly stated?",
46
+ "failDescription": "Technical constraints and assumptions are implicit — developers may make wrong assumptions",
47
+ "failSuggestion": "Make constraints and assumptions explicit: runtime version, OS constraints, browser support, API compatibility requirements"
48
+ },
49
+ {
50
+ "id": "dev-epic-05",
51
+ "tier": 1,
52
+ "perspective": "developer",
53
+ "severity": "minor",
54
+ "category": "code-quality-maintainability",
55
+ "universal": true,
56
+ "question": "Does the epic mention code quality standards (linting, formatting, code review)?",
57
+ "failDescription": "Code quality standards are not mentioned — no linting, formatting, or code review requirements",
58
+ "failSuggestion": "Mention code quality standards: linting rules, formatting conventions, and code review requirements"
59
+ },
60
+ {
61
+ "id": "dev-epic-06",
62
+ "tier": 1,
63
+ "perspective": "developer",
64
+ "severity": "major",
65
+ "category": "code-quality-maintainability",
66
+ "universal": true,
67
+ "question": "Does the epic address testing strategy (unit, integration, e2e)?",
68
+ "failDescription": "Testing strategy is not addressed — no mention of unit, integration, or e2e testing",
69
+ "failSuggestion": "Address testing strategy: specify which types of tests are expected (unit, integration, e2e) and coverage targets"
70
+ },
71
+ {
72
+ "id": "dev-epic-07",
73
+ "tier": 1,
74
+ "perspective": "developer",
75
+ "severity": "minor",
76
+ "category": "code-quality-maintainability",
77
+ "universal": true,
78
+ "question": "Are documentation requirements specified (code comments, API docs, README)?",
79
+ "failDescription": "Documentation requirements are not specified",
80
+ "failSuggestion": "Specify documentation requirements: inline code comments, API documentation, README updates"
81
+ },
82
+ {
83
+ "id": "dev-epic-08",
84
+ "tier": 1,
85
+ "perspective": "developer",
86
+ "severity": "minor",
87
+ "category": "development-workflow",
88
+ "universal": true,
89
+ "question": "Does the epic support incremental development and testing?",
90
+ "failDescription": "Epic does not support incremental development — features may need to be delivered all at once",
91
+ "failSuggestion": "Structure the epic to support incremental development: features should be independently testable and deployable"
92
+ },
93
+ {
94
+ "id": "dev-epic-09",
95
+ "tier": 1,
96
+ "perspective": "developer",
97
+ "severity": "minor",
98
+ "category": "development-workflow",
99
+ "universal": true,
100
+ "question": "Are dependencies clear and do they avoid blocking parallelization unnecessarily?",
101
+ "failDescription": "Dependencies are unclear or block parallelization unnecessarily",
102
+ "failSuggestion": "Clarify dependencies and minimize blocking relationships to allow parallel development"
103
+ },
104
+ {
105
+ "id": "dev-epic-10",
106
+ "tier": 1,
107
+ "perspective": "developer",
108
+ "severity": "minor",
109
+ "category": "development-workflow",
110
+ "universal": true,
111
+ "question": "Is a version control strategy implied or specified (branching, commits)?",
112
+ "failDescription": "Version control strategy is not addressed",
113
+ "failSuggestion": "Specify or imply version control strategy: feature branches, commit conventions, merge approach"
114
+ },
115
+ {
116
+ "id": "dev-epic-11",
117
+ "tier": 1,
118
+ "perspective": "developer",
119
+ "severity": "minor",
120
+ "category": "developer-experience",
121
+ "universal": true,
122
+ "question": "Does the epic provide sufficient context for developers to start work?",
123
+ "failDescription": "Insufficient context for developers — key background information or technical context is missing",
124
+ "failSuggestion": "Provide enough context: domain background, technical rationale, relevant prior decisions"
125
+ },
126
+ {
127
+ "id": "dev-epic-12",
128
+ "tier": 1,
129
+ "perspective": "developer",
130
+ "severity": "minor",
131
+ "category": "developer-experience",
132
+ "universal": true,
133
+ "question": "Are technical decisions justified (why this approach)?",
134
+ "failDescription": "Technical decisions are not justified — unclear why a particular approach was chosen",
135
+ "failSuggestion": "Justify key technical decisions: explain why this approach was chosen over alternatives"
136
+ },
137
+ {
138
+ "id": "dev-epic-13",
139
+ "tier": 1,
140
+ "perspective": "developer",
141
+ "severity": "minor",
142
+ "category": "developer-experience",
143
+ "universal": true,
144
+ "question": "Does the epic avoid introducing unnecessary complexity?",
145
+ "failDescription": "Epic introduces unnecessary complexity — simpler alternatives may exist",
146
+ "failSuggestion": "Review for unnecessary complexity and simplify where possible without losing functionality"
147
+ },
148
+ {
149
+ "id": "dev-epic-14",
150
+ "tier": 1,
151
+ "perspective": "developer",
152
+ "severity": "minor",
153
+ "category": "best-practices",
154
+ "universal": true,
155
+ "question": "Does the epic follow SOLID principles and clean code practices?",
156
+ "failDescription": "Epic design does not follow SOLID principles or clean code practices",
157
+ "failSuggestion": "Align the epic design with SOLID principles: single responsibility, open/closed, dependency inversion"
158
+ },
159
+ {
160
+ "id": "dev-epic-15",
161
+ "tier": 1,
162
+ "perspective": "developer",
163
+ "severity": "minor",
164
+ "category": "best-practices",
165
+ "universal": true,
166
+ "question": "Does the epic avoid common anti-patterns (tight coupling, god objects, premature optimization)?",
167
+ "failDescription": "Epic may introduce anti-patterns — tight coupling, god objects, or premature optimization",
168
+ "failSuggestion": "Review for anti-patterns: avoid tight coupling between components, god objects, and premature optimization"
169
+ },
170
+ {
171
+ "id": "dev-epic-16",
172
+ "tier": 1,
173
+ "perspective": "developer",
174
+ "severity": "minor",
175
+ "category": "best-practices",
176
+ "universal": true,
177
+ "question": "Does the epic consider technical debt and refactoring needs?",
178
+ "failDescription": "Technical debt and refactoring needs are not considered",
179
+ "failSuggestion": "Acknowledge technical debt implications and plan for necessary refactoring"
180
+ }
181
+ ]
182
+ }
@@ -0,0 +1,174 @@
1
+ {
2
+ "perspective": "devops",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "devops-epic-01",
7
+ "tier": 1,
8
+ "perspective": "devops",
9
+ "severity": "critical",
10
+ "category": "completeness",
11
+ "universal": false,
12
+ "applicabilityQuestion": "Does this epic involve deployment, infrastructure, or operational concerns? (Does it require CI/CD, containers, or cloud infrastructure?)",
13
+ "question": "Does the epic scope clearly define deployment and operational boundaries?",
14
+ "failDescription": "Deployment and operational boundaries are not defined",
15
+ "failSuggestion": "Define deployment boundaries: what is deployed, where, and how (container, serverless, VM)"
16
+ },
17
+ {
18
+ "id": "devops-epic-02",
19
+ "tier": 1,
20
+ "perspective": "devops",
21
+ "severity": "critical",
22
+ "category": "completeness",
23
+ "universal": false,
24
+ "applicabilityQuestion": "Does this epic involve deployment, infrastructure, or operational concerns? (Does it require CI/CD, monitoring, or scaling?)",
25
+ "question": "Are all critical DevOps features identified (CI/CD, monitoring, scaling)?",
26
+ "failDescription": "Critical DevOps features are missing — CI/CD, monitoring, or scaling not addressed",
27
+ "failSuggestion": "Identify critical DevOps features: CI/CD pipeline, monitoring/alerting, auto-scaling strategy"
28
+ },
29
+ {
30
+ "id": "devops-epic-03",
31
+ "tier": 1,
32
+ "perspective": "devops",
33
+ "severity": "major",
34
+ "category": "completeness",
35
+ "universal": false,
36
+ "applicabilityQuestion": "Does this epic depend on infrastructure services? (Does it use cloud provider, container registry, or external services?)",
37
+ "question": "Are dependencies on infrastructure services explicit (cloud provider, container registry)?",
38
+ "failDescription": "Infrastructure service dependencies are not explicit",
39
+ "failSuggestion": "Make infrastructure dependencies explicit: cloud provider, container registry, DNS, CDN, load balancer"
40
+ },
41
+ {
42
+ "id": "devops-epic-04",
43
+ "tier": 1,
44
+ "perspective": "devops",
45
+ "severity": "major",
46
+ "category": "completeness",
47
+ "universal": false,
48
+ "applicabilityQuestion": "Does this epic have operational requirements? (Does it need uptime, recovery, or deployment frequency targets?)",
49
+ "question": "Are operational success criteria measurable (e.g. 99.9% uptime, < 15min MTTR)?",
50
+ "failDescription": "Operational success criteria are not measurable",
51
+ "failSuggestion": "Define measurable operational criteria: uptime SLA (e.g. 99.9%), MTTR (e.g. < 15min), deployment frequency"
52
+ },
53
+ {
54
+ "id": "devops-epic-05",
55
+ "tier": 1,
56
+ "perspective": "devops",
57
+ "severity": "minor",
58
+ "category": "clarity",
59
+ "universal": false,
60
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
61
+ "question": "Is DevOps terminology used correctly and consistently?",
62
+ "failDescription": "DevOps terminology is used incorrectly or inconsistently",
63
+ "failSuggestion": "Review and correct DevOps terminology for consistency (e.g. container vs VM, deployment vs release)"
64
+ },
65
+ {
66
+ "id": "devops-epic-06",
67
+ "tier": 1,
68
+ "perspective": "devops",
69
+ "severity": "minor",
70
+ "category": "clarity",
71
+ "universal": false,
72
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
73
+ "question": "Is the epic description understandable to non-DevOps team members?",
74
+ "failDescription": "Epic description uses excessive DevOps jargon without explanation",
75
+ "failSuggestion": "Simplify or explain DevOps concepts so non-DevOps team members can understand the epic"
76
+ },
77
+ {
78
+ "id": "devops-epic-07",
79
+ "tier": 1,
80
+ "perspective": "devops",
81
+ "severity": "minor",
82
+ "category": "clarity",
83
+ "universal": false,
84
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
85
+ "question": "Are operational features described in terms of business value (faster deployments, reduced downtime)?",
86
+ "failDescription": "Operational features lack business value context",
87
+ "failSuggestion": "Frame operational features in business terms: 'automated deployment reduces release time from 2hr to 5min'"
88
+ },
89
+ {
90
+ "id": "devops-epic-08",
91
+ "tier": 1,
92
+ "perspective": "devops",
93
+ "severity": "major",
94
+ "category": "technical-depth",
95
+ "universal": false,
96
+ "applicabilityQuestion": "Does this epic involve deploying services? (Does it require containerization, orchestration, or scaling?)",
97
+ "question": "Is infrastructure architecture considered (containerization, orchestration, scaling)?",
98
+ "failDescription": "Infrastructure architecture is not considered — containerization, orchestration, or scaling missing",
99
+ "failSuggestion": "Address infrastructure architecture: containerization (Docker), orchestration (K8s/ECS), scaling strategy"
100
+ },
101
+ {
102
+ "id": "devops-epic-09",
103
+ "tier": 1,
104
+ "perspective": "devops",
105
+ "severity": "major",
106
+ "category": "technical-depth",
107
+ "universal": false,
108
+ "applicabilityQuestion": "Does this epic involve deploying to production? (Does it require a deployment strategy?)",
109
+ "question": "Is a deployment strategy addressed (blue/green, canary, rolling updates)?",
110
+ "failDescription": "Deployment strategy is not addressed",
111
+ "failSuggestion": "Define deployment strategy: blue/green, canary, or rolling updates with rollback plan"
112
+ },
113
+ {
114
+ "id": "devops-epic-10",
115
+ "tier": 1,
116
+ "perspective": "devops",
117
+ "severity": "major",
118
+ "category": "technical-depth",
119
+ "universal": false,
120
+ "applicabilityQuestion": "Does this epic involve running production services? (Does it require logging, metrics, or tracing?)",
121
+ "question": "Is an observability stack defined (metrics, logs, traces)?",
122
+ "failDescription": "Observability stack is not defined — no metrics, logging, or tracing specified",
123
+ "failSuggestion": "Define observability stack: logging (ELK, CloudWatch), metrics (Prometheus, Datadog), tracing (X-Ray, Jaeger)"
124
+ },
125
+ {
126
+ "id": "devops-epic-11",
127
+ "tier": 1,
128
+ "perspective": "devops",
129
+ "severity": "minor",
130
+ "category": "technical-depth",
131
+ "universal": false,
132
+ "applicabilityQuestion": "Does this epic involve production data or services? (Does it require backup or disaster recovery?)",
133
+ "question": "Is a disaster recovery and backup strategy mentioned?",
134
+ "failDescription": "Disaster recovery and backup strategy is not mentioned",
135
+ "failSuggestion": "Mention disaster recovery: backup frequency, RTO/RPO targets, recovery procedures"
136
+ },
137
+ {
138
+ "id": "devops-epic-12",
139
+ "tier": 1,
140
+ "perspective": "devops",
141
+ "severity": "minor",
142
+ "category": "consistency",
143
+ "universal": false,
144
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
145
+ "question": "Does the DevOps approach align with the project context and cloud platform?",
146
+ "failDescription": "DevOps approach does not align with project context or cloud platform",
147
+ "failSuggestion": "Align DevOps approach with project context: ensure tools and patterns match the chosen cloud platform"
148
+ },
149
+ {
150
+ "id": "devops-epic-13",
151
+ "tier": 1,
152
+ "perspective": "devops",
153
+ "severity": "minor",
154
+ "category": "best-practices",
155
+ "universal": false,
156
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
157
+ "question": "Are industry-standard DevOps patterns followed (12-factor app, GitOps, immutable infrastructure)?",
158
+ "failDescription": "Industry-standard DevOps patterns are not followed",
159
+ "failSuggestion": "Follow DevOps best practices: 12-factor app principles, GitOps workflows, immutable infrastructure"
160
+ },
161
+ {
162
+ "id": "devops-epic-14",
163
+ "tier": 1,
164
+ "perspective": "devops",
165
+ "severity": "minor",
166
+ "category": "best-practices",
167
+ "universal": false,
168
+ "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
169
+ "question": "Does the epic avoid DevOps anti-patterns (manual deployments, configuration drift, snowflake servers)?",
170
+ "failDescription": "Epic may introduce DevOps anti-patterns — manual deployments, configuration drift, or snowflake servers",
171
+ "failSuggestion": "Avoid DevOps anti-patterns: automate deployments, manage config as code, use immutable infrastructure"
172
+ }
173
+ ]
174
+ }
@@ -0,0 +1,162 @@
1
+ {
2
+ "perspective": "frontend",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "fe-epic-01",
7
+ "tier": 1,
8
+ "perspective": "frontend",
9
+ "severity": "critical",
10
+ "category": "ui-architecture-specification",
11
+ "universal": false,
12
+ "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it include UI components, pages, or client-side rendering?)",
13
+ "question": "Does the epic state the frontend framework (React, Vue, Angular, etc.)?",
14
+ "failDescription": "Frontend framework is not stated — foundational technology decision is missing",
15
+ "failSuggestion": "State the frontend framework: React, Vue, Angular, Svelte, etc."
16
+ },
17
+ {
18
+ "id": "fe-epic-02",
19
+ "tier": 1,
20
+ "perspective": "frontend",
21
+ "severity": "critical",
22
+ "category": "ui-architecture-specification",
23
+ "universal": false,
24
+ "applicabilityQuestion": "Does this epic involve fetching data from a server? (Does it make API calls or query a backend?)",
25
+ "question": "Does the epic name the server-state management library (TanStack Query, SWR, Apollo) and describe its usage pattern?",
26
+ "failDescription": "Server-state management library is not named or its usage pattern is not described",
27
+ "failSuggestion": "Name the server-state management library (TanStack Query, SWR, Apollo) and describe caching/refetch patterns"
28
+ },
29
+ {
30
+ "id": "fe-epic-03",
31
+ "tier": 1,
32
+ "perspective": "frontend",
33
+ "severity": "major",
34
+ "category": "ui-architecture-specification",
35
+ "universal": false,
36
+ "applicabilityQuestion": "Does this epic involve client-side state beyond server data? (Does it need UI state, form state, or application state?)",
37
+ "question": "Does the epic name the client-state management strategy (Zustand, Redux, Context) — or explicitly state 'no client state beyond React Query cache'?",
38
+ "failDescription": "Client-state management strategy is not named or explicitly declared absent",
39
+ "failSuggestion": "Name the client-state strategy (Zustand, Redux, Context) or explicitly state 'no client state beyond server-state cache'"
40
+ },
41
+ {
42
+ "id": "fe-epic-04",
43
+ "tier": 1,
44
+ "perspective": "frontend",
45
+ "severity": "major",
46
+ "category": "ui-architecture-specification",
47
+ "universal": false,
48
+ "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it include UI components?)",
49
+ "question": "Does the epic name the key UI component types (table, form, modal, drawer, chart, etc.)?",
50
+ "failDescription": "Key UI component types are not named",
51
+ "failSuggestion": "Name the key UI component types: tables, forms, modals, drawers, charts, etc."
52
+ },
53
+ {
54
+ "id": "fe-epic-05",
55
+ "tier": 1,
56
+ "perspective": "frontend",
57
+ "severity": "critical",
58
+ "category": "async-error-ux-strategy",
59
+ "universal": false,
60
+ "applicabilityQuestion": "Does this epic involve asynchronous operations? (Does it fetch data, submit forms, or call APIs?)",
61
+ "question": "Does the epic name a loading state strategy (skeleton loaders, spinners, progressive enhancement)?",
62
+ "failDescription": "Loading state strategy is not named — users will see undefined behavior during async operations",
63
+ "failSuggestion": "Name the loading state strategy: skeleton loaders, spinners, disabled buttons, or progressive enhancement"
64
+ },
65
+ {
66
+ "id": "fe-epic-06",
67
+ "tier": 1,
68
+ "perspective": "frontend",
69
+ "severity": "critical",
70
+ "category": "async-error-ux-strategy",
71
+ "universal": false,
72
+ "applicabilityQuestion": "Does this epic involve asynchronous operations? (Does it fetch data, submit forms, or call APIs?)",
73
+ "question": "Does the epic name an error state strategy (toast notifications, inline errors, error boundaries)?",
74
+ "failDescription": "Error state strategy is not named — errors will not be communicated to users",
75
+ "failSuggestion": "Name the error state strategy: toast notifications, inline errors, error boundaries, or retry prompts"
76
+ },
77
+ {
78
+ "id": "fe-epic-07",
79
+ "tier": 1,
80
+ "perspective": "frontend",
81
+ "severity": "major",
82
+ "category": "async-error-ux-strategy",
83
+ "universal": false,
84
+ "applicabilityQuestion": "Does this epic involve lists or search views? (Does it display collections of items or search results?)",
85
+ "question": "Does the epic describe empty state handling for all list/search views?",
86
+ "failDescription": "Empty state handling is not described for list/search views",
87
+ "failSuggestion": "Describe empty state handling: what renders when data is empty (illustration, message, call-to-action)"
88
+ },
89
+ {
90
+ "id": "fe-epic-08",
91
+ "tier": 1,
92
+ "perspective": "frontend",
93
+ "severity": "minor",
94
+ "category": "async-error-ux-strategy",
95
+ "universal": false,
96
+ "applicabilityQuestion": "Does this epic involve data mutations? (Does it create, update, or delete data?)",
97
+ "question": "Does the epic state an optimistic update strategy for mutation-heavy features?",
98
+ "failDescription": "Optimistic update strategy is not stated for mutation-heavy features",
99
+ "failSuggestion": "State whether mutations use optimistic updates (immediate UI update, rollback on failure) or wait for server confirmation"
100
+ },
101
+ {
102
+ "id": "fe-epic-09",
103
+ "tier": 1,
104
+ "perspective": "frontend",
105
+ "severity": "major",
106
+ "category": "accessibility-standards",
107
+ "universal": false,
108
+ "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it render UI for end users?)",
109
+ "question": "Does the epic state an accessibility standard (WCAG 2.1 AA or equivalent) if user-facing?",
110
+ "failDescription": "Accessibility standard is not stated for user-facing interface",
111
+ "failSuggestion": "State the accessibility standard: WCAG 2.1 AA, Section 508, or equivalent"
112
+ },
113
+ {
114
+ "id": "fe-epic-10",
115
+ "tier": 1,
116
+ "perspective": "frontend",
117
+ "severity": "minor",
118
+ "category": "accessibility-standards",
119
+ "universal": false,
120
+ "applicabilityQuestion": "Does this epic involve interactive UI components? (Does it have forms, modals, menus, or dropdowns?)",
121
+ "question": "Does the epic require keyboard navigation for interactive components?",
122
+ "failDescription": "Keyboard navigation requirement is not stated for interactive components",
123
+ "failSuggestion": "Require keyboard navigation for interactive components: Tab, Enter, Escape, Arrow keys for forms, modals, menus"
124
+ },
125
+ {
126
+ "id": "fe-epic-11",
127
+ "tier": 1,
128
+ "perspective": "frontend",
129
+ "severity": "minor",
130
+ "category": "accessibility-standards",
131
+ "universal": false,
132
+ "applicabilityQuestion": "Does this epic involve dynamic content updates? (Does it have live feeds, notifications, or async-loaded content?)",
133
+ "question": "Does the epic describe an ARIA strategy for dynamic content (live regions, labeled controls)?",
134
+ "failDescription": "ARIA strategy for dynamic content is not described",
135
+ "failSuggestion": "Describe ARIA strategy: aria-live regions for async updates, aria-label for controls, aria-describedby for errors"
136
+ },
137
+ {
138
+ "id": "fe-epic-12",
139
+ "tier": 1,
140
+ "perspective": "frontend",
141
+ "severity": "minor",
142
+ "category": "performance-build",
143
+ "universal": false,
144
+ "applicabilityQuestion": "Does this epic involve a web application with multiple routes or heavy components? (Does it have route-based views or large libraries?)",
145
+ "question": "Does the epic describe a code splitting strategy (route-level, component-level) if relevant?",
146
+ "failDescription": "Code splitting strategy is not described",
147
+ "failSuggestion": "Describe code splitting: route-level lazy loading, component-level splitting for heavy libraries"
148
+ },
149
+ {
150
+ "id": "fe-epic-13",
151
+ "tier": 1,
152
+ "perspective": "frontend",
153
+ "severity": "minor",
154
+ "category": "performance-build",
155
+ "universal": false,
156
+ "applicabilityQuestion": "Does this epic involve a user-facing web application? (Does it need to load quickly for end users?)",
157
+ "question": "Does the epic specify performance targets (bundle size, LCP, FID, CLS) — or 'N/A for internal tool'?",
158
+ "failDescription": "Performance targets are not specified",
159
+ "failSuggestion": "Specify performance targets: bundle size budget, LCP < 2.5s, FID < 100ms, CLS < 0.1 — or state 'N/A for internal tool'"
160
+ }
161
+ ]
162
+ }