@agile-vibe-coding/avc 0.2.3 → 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 (261) hide show
  1. package/cli/agents/agent-selector.md +23 -0
  2. package/cli/agents/code-implementer.md +117 -0
  3. package/cli/agents/code-validator.md +80 -0
  4. package/cli/agents/context-reviewer-epic.md +101 -0
  5. package/cli/agents/context-reviewer-story.md +92 -0
  6. package/cli/agents/context-writer-epic.md +145 -0
  7. package/cli/agents/context-writer-story.md +111 -0
  8. package/cli/agents/doc-writer-epic.md +42 -0
  9. package/cli/agents/doc-writer-story.md +43 -0
  10. package/cli/agents/duplicate-detector.md +110 -0
  11. package/cli/agents/epic-story-decomposer.md +318 -39
  12. package/cli/agents/mission-scope-generator.md +68 -4
  13. package/cli/agents/mission-scope-validator.md +40 -6
  14. package/cli/agents/project-context-extractor.md +21 -6
  15. package/cli/agents/scaffolding-generator.md +99 -0
  16. package/cli/agents/seed-validator.md +71 -0
  17. package/cli/agents/story-scope-reviewer.md +147 -0
  18. package/cli/agents/story-splitter.md +83 -0
  19. package/cli/agents/validator-documentation.json +31 -0
  20. package/cli/agents/validator-documentation.md +3 -1
  21. package/cli/api-reference-tool.js +368 -0
  22. package/cli/checks/catalog.json +76 -0
  23. package/cli/checks/code/quality.json +26 -0
  24. package/cli/checks/code/testing.json +14 -0
  25. package/cli/checks/code/traceability.json +26 -0
  26. package/cli/checks/cross-refs/epic.json +171 -0
  27. package/cli/checks/cross-refs/story.json +149 -0
  28. package/cli/checks/epic/api.json +114 -0
  29. package/cli/checks/epic/backend.json +126 -0
  30. package/cli/checks/epic/cloud.json +126 -0
  31. package/cli/checks/epic/data.json +102 -0
  32. package/cli/checks/epic/database.json +114 -0
  33. package/cli/checks/epic/developer.json +182 -0
  34. package/cli/checks/epic/devops.json +174 -0
  35. package/cli/checks/epic/frontend.json +162 -0
  36. package/cli/checks/epic/mobile.json +102 -0
  37. package/cli/checks/epic/qa.json +90 -0
  38. package/cli/checks/epic/security.json +184 -0
  39. package/cli/checks/epic/solution-architect.json +192 -0
  40. package/cli/checks/epic/test-architect.json +90 -0
  41. package/cli/checks/epic/ui.json +102 -0
  42. package/cli/checks/epic/ux.json +90 -0
  43. package/cli/checks/fixes/epic-fix-template.md +10 -0
  44. package/cli/checks/fixes/story-fix-template.md +10 -0
  45. package/cli/checks/story/api.json +186 -0
  46. package/cli/checks/story/backend.json +102 -0
  47. package/cli/checks/story/cloud.json +102 -0
  48. package/cli/checks/story/data.json +210 -0
  49. package/cli/checks/story/database.json +102 -0
  50. package/cli/checks/story/developer.json +168 -0
  51. package/cli/checks/story/devops.json +102 -0
  52. package/cli/checks/story/frontend.json +174 -0
  53. package/cli/checks/story/mobile.json +102 -0
  54. package/cli/checks/story/qa.json +210 -0
  55. package/cli/checks/story/security.json +198 -0
  56. package/cli/checks/story/solution-architect.json +230 -0
  57. package/cli/checks/story/test-architect.json +210 -0
  58. package/cli/checks/story/ui.json +102 -0
  59. package/cli/checks/story/ux.json +102 -0
  60. package/cli/coding-order.js +401 -0
  61. package/cli/dependency-checker.js +72 -0
  62. package/cli/epic-story-validator.js +284 -799
  63. package/cli/index.js +0 -0
  64. package/cli/init-model-config.js +17 -10
  65. package/cli/init.js +514 -92
  66. package/cli/kanban-server-manager.js +1 -2
  67. package/cli/llm-claude.js +98 -31
  68. package/cli/llm-gemini.js +29 -5
  69. package/cli/llm-local.js +493 -0
  70. package/cli/llm-openai.js +262 -41
  71. package/cli/llm-provider.js +147 -8
  72. package/cli/llm-token-limits.js +113 -4
  73. package/cli/llm-verifier.js +209 -1
  74. package/cli/llm-xiaomi.js +143 -0
  75. package/cli/message-constants.js +3 -12
  76. package/cli/messaging-api.js +6 -12
  77. package/cli/micro-check-fixer.js +335 -0
  78. package/cli/micro-check-runner.js +449 -0
  79. package/cli/micro-check-scorer.js +148 -0
  80. package/cli/micro-check-validator.js +538 -0
  81. package/cli/model-pricing.js +23 -0
  82. package/cli/model-selector.js +3 -2
  83. package/cli/prompt-logger.js +57 -0
  84. package/cli/repl-ink.js +106 -346
  85. package/cli/repl-old.js +1 -2
  86. package/cli/seed-processor.js +194 -24
  87. package/cli/sprint-planning-processor.js +2638 -289
  88. package/cli/template-processor.js +50 -3
  89. package/cli/token-tracker.js +50 -23
  90. package/cli/tools/generate-story-validators.js +1 -1
  91. package/cli/validation-router.js +70 -8
  92. package/cli/worktree-runner.js +654 -0
  93. package/kanban/client/dist/assets/index-D_KC5EQT.css +1 -0
  94. package/kanban/client/dist/assets/index-DjY5zqW7.js +351 -0
  95. package/kanban/client/dist/index.html +2 -2
  96. package/kanban/client/src/App.jsx +43 -14
  97. package/kanban/client/src/components/ceremony/AskArchPopup.jsx +7 -3
  98. package/kanban/client/src/components/ceremony/AskModelPopup.jsx +23 -10
  99. package/kanban/client/src/components/ceremony/CeremonyWorkflowModal.jsx +320 -133
  100. package/kanban/client/src/components/ceremony/ProviderSwitcherButton.jsx +290 -0
  101. package/kanban/client/src/components/ceremony/SponsorCallModal.jsx +80 -13
  102. package/kanban/client/src/components/ceremony/SprintPlanningModal.jsx +156 -22
  103. package/kanban/client/src/components/ceremony/steps/ArchitectureStep.jsx +11 -11
  104. package/kanban/client/src/components/ceremony/steps/CompleteStep.jsx +3 -21
  105. package/kanban/client/src/components/ceremony/steps/ReviewAnswersStep.jsx +214 -10
  106. package/kanban/client/src/components/ceremony/steps/RunningStep.jsx +23 -2
  107. package/kanban/client/src/components/kanban/CardDetailModal.jsx +97 -10
  108. package/kanban/client/src/components/kanban/GroupingSelector.jsx +7 -1
  109. package/kanban/client/src/components/kanban/KanbanCard.jsx +23 -14
  110. package/kanban/client/src/components/kanban/RefineWorkItemPopup.jsx +9 -14
  111. package/kanban/client/src/components/kanban/RunButton.jsx +162 -0
  112. package/kanban/client/src/components/kanban/SeedButton.jsx +176 -0
  113. package/kanban/client/src/components/settings/AgentsTab.jsx +103 -75
  114. package/kanban/client/src/components/settings/ApiKeysTab.jsx +31 -2
  115. package/kanban/client/src/components/settings/CeremonyModelsTab.jsx +9 -2
  116. package/kanban/client/src/components/settings/CheckEditorPopup.jsx +507 -0
  117. package/kanban/client/src/components/settings/CostThresholdsTab.jsx +3 -2
  118. package/kanban/client/src/components/settings/ModelPricingTab.jsx +72 -7
  119. package/kanban/client/src/components/settings/OpenAIAuthSection.jsx +412 -0
  120. package/kanban/client/src/components/settings/SettingsModal.jsx +4 -4
  121. package/kanban/client/src/components/stats/CostModal.jsx +34 -3
  122. package/kanban/client/src/hooks/useGrouping.js +59 -0
  123. package/kanban/client/src/lib/api.js +118 -4
  124. package/kanban/client/src/lib/status-grouping.js +10 -0
  125. package/kanban/client/src/store/kanbanStore.js +8 -0
  126. package/kanban/server/index.js +23 -2
  127. package/kanban/server/routes/ceremony.js +153 -4
  128. package/kanban/server/routes/costs.js +9 -3
  129. package/kanban/server/routes/openai-oauth.js +366 -0
  130. package/kanban/server/routes/settings.js +447 -14
  131. package/kanban/server/routes/websocket.js +7 -2
  132. package/kanban/server/routes/work-items.js +141 -1
  133. package/kanban/server/services/CeremonyService.js +275 -24
  134. package/kanban/server/services/TaskRunnerService.js +261 -0
  135. package/kanban/server/workers/run-task-worker.js +121 -0
  136. package/kanban/server/workers/seed-worker.js +94 -0
  137. package/kanban/server/workers/sponsor-call-worker.js +14 -6
  138. package/kanban/server/workers/sprint-planning-worker.js +94 -12
  139. package/package.json +2 -3
  140. package/cli/agents/solver-epic-api.json +0 -15
  141. package/cli/agents/solver-epic-api.md +0 -39
  142. package/cli/agents/solver-epic-backend.json +0 -15
  143. package/cli/agents/solver-epic-backend.md +0 -39
  144. package/cli/agents/solver-epic-cloud.json +0 -15
  145. package/cli/agents/solver-epic-cloud.md +0 -39
  146. package/cli/agents/solver-epic-data.json +0 -15
  147. package/cli/agents/solver-epic-data.md +0 -39
  148. package/cli/agents/solver-epic-database.json +0 -15
  149. package/cli/agents/solver-epic-database.md +0 -39
  150. package/cli/agents/solver-epic-developer.json +0 -15
  151. package/cli/agents/solver-epic-developer.md +0 -39
  152. package/cli/agents/solver-epic-devops.json +0 -15
  153. package/cli/agents/solver-epic-devops.md +0 -39
  154. package/cli/agents/solver-epic-frontend.json +0 -15
  155. package/cli/agents/solver-epic-frontend.md +0 -39
  156. package/cli/agents/solver-epic-mobile.json +0 -15
  157. package/cli/agents/solver-epic-mobile.md +0 -39
  158. package/cli/agents/solver-epic-qa.json +0 -15
  159. package/cli/agents/solver-epic-qa.md +0 -39
  160. package/cli/agents/solver-epic-security.json +0 -15
  161. package/cli/agents/solver-epic-security.md +0 -39
  162. package/cli/agents/solver-epic-solution-architect.json +0 -15
  163. package/cli/agents/solver-epic-solution-architect.md +0 -39
  164. package/cli/agents/solver-epic-test-architect.json +0 -15
  165. package/cli/agents/solver-epic-test-architect.md +0 -39
  166. package/cli/agents/solver-epic-ui.json +0 -15
  167. package/cli/agents/solver-epic-ui.md +0 -39
  168. package/cli/agents/solver-epic-ux.json +0 -15
  169. package/cli/agents/solver-epic-ux.md +0 -39
  170. package/cli/agents/solver-story-api.json +0 -15
  171. package/cli/agents/solver-story-api.md +0 -39
  172. package/cli/agents/solver-story-backend.json +0 -15
  173. package/cli/agents/solver-story-backend.md +0 -39
  174. package/cli/agents/solver-story-cloud.json +0 -15
  175. package/cli/agents/solver-story-cloud.md +0 -39
  176. package/cli/agents/solver-story-data.json +0 -15
  177. package/cli/agents/solver-story-data.md +0 -39
  178. package/cli/agents/solver-story-database.json +0 -15
  179. package/cli/agents/solver-story-database.md +0 -39
  180. package/cli/agents/solver-story-developer.json +0 -15
  181. package/cli/agents/solver-story-developer.md +0 -39
  182. package/cli/agents/solver-story-devops.json +0 -15
  183. package/cli/agents/solver-story-devops.md +0 -39
  184. package/cli/agents/solver-story-frontend.json +0 -15
  185. package/cli/agents/solver-story-frontend.md +0 -39
  186. package/cli/agents/solver-story-mobile.json +0 -15
  187. package/cli/agents/solver-story-mobile.md +0 -39
  188. package/cli/agents/solver-story-qa.json +0 -15
  189. package/cli/agents/solver-story-qa.md +0 -39
  190. package/cli/agents/solver-story-security.json +0 -15
  191. package/cli/agents/solver-story-security.md +0 -39
  192. package/cli/agents/solver-story-solution-architect.json +0 -15
  193. package/cli/agents/solver-story-solution-architect.md +0 -39
  194. package/cli/agents/solver-story-test-architect.json +0 -15
  195. package/cli/agents/solver-story-test-architect.md +0 -39
  196. package/cli/agents/solver-story-ui.json +0 -15
  197. package/cli/agents/solver-story-ui.md +0 -39
  198. package/cli/agents/solver-story-ux.json +0 -15
  199. package/cli/agents/solver-story-ux.md +0 -39
  200. package/cli/agents/validator-epic-api.json +0 -93
  201. package/cli/agents/validator-epic-api.md +0 -137
  202. package/cli/agents/validator-epic-backend.json +0 -93
  203. package/cli/agents/validator-epic-backend.md +0 -130
  204. package/cli/agents/validator-epic-cloud.json +0 -93
  205. package/cli/agents/validator-epic-cloud.md +0 -137
  206. package/cli/agents/validator-epic-data.json +0 -93
  207. package/cli/agents/validator-epic-data.md +0 -130
  208. package/cli/agents/validator-epic-database.json +0 -93
  209. package/cli/agents/validator-epic-database.md +0 -137
  210. package/cli/agents/validator-epic-developer.json +0 -74
  211. package/cli/agents/validator-epic-developer.md +0 -153
  212. package/cli/agents/validator-epic-devops.json +0 -74
  213. package/cli/agents/validator-epic-devops.md +0 -153
  214. package/cli/agents/validator-epic-frontend.json +0 -74
  215. package/cli/agents/validator-epic-frontend.md +0 -153
  216. package/cli/agents/validator-epic-mobile.json +0 -93
  217. package/cli/agents/validator-epic-mobile.md +0 -130
  218. package/cli/agents/validator-epic-qa.json +0 -93
  219. package/cli/agents/validator-epic-qa.md +0 -130
  220. package/cli/agents/validator-epic-security.json +0 -74
  221. package/cli/agents/validator-epic-security.md +0 -154
  222. package/cli/agents/validator-epic-solution-architect.json +0 -74
  223. package/cli/agents/validator-epic-solution-architect.md +0 -156
  224. package/cli/agents/validator-epic-test-architect.json +0 -93
  225. package/cli/agents/validator-epic-test-architect.md +0 -130
  226. package/cli/agents/validator-epic-ui.json +0 -93
  227. package/cli/agents/validator-epic-ui.md +0 -130
  228. package/cli/agents/validator-epic-ux.json +0 -93
  229. package/cli/agents/validator-epic-ux.md +0 -130
  230. package/cli/agents/validator-story-api.json +0 -104
  231. package/cli/agents/validator-story-api.md +0 -152
  232. package/cli/agents/validator-story-backend.json +0 -104
  233. package/cli/agents/validator-story-backend.md +0 -152
  234. package/cli/agents/validator-story-cloud.json +0 -104
  235. package/cli/agents/validator-story-cloud.md +0 -152
  236. package/cli/agents/validator-story-data.json +0 -104
  237. package/cli/agents/validator-story-data.md +0 -152
  238. package/cli/agents/validator-story-database.json +0 -104
  239. package/cli/agents/validator-story-database.md +0 -152
  240. package/cli/agents/validator-story-developer.json +0 -104
  241. package/cli/agents/validator-story-developer.md +0 -152
  242. package/cli/agents/validator-story-devops.json +0 -104
  243. package/cli/agents/validator-story-devops.md +0 -152
  244. package/cli/agents/validator-story-frontend.json +0 -104
  245. package/cli/agents/validator-story-frontend.md +0 -152
  246. package/cli/agents/validator-story-mobile.json +0 -104
  247. package/cli/agents/validator-story-mobile.md +0 -152
  248. package/cli/agents/validator-story-qa.json +0 -104
  249. package/cli/agents/validator-story-qa.md +0 -152
  250. package/cli/agents/validator-story-security.json +0 -104
  251. package/cli/agents/validator-story-security.md +0 -152
  252. package/cli/agents/validator-story-solution-architect.json +0 -104
  253. package/cli/agents/validator-story-solution-architect.md +0 -152
  254. package/cli/agents/validator-story-test-architect.json +0 -104
  255. package/cli/agents/validator-story-test-architect.md +0 -152
  256. package/cli/agents/validator-story-ui.json +0 -104
  257. package/cli/agents/validator-story-ui.md +0 -152
  258. package/cli/agents/validator-story-ux.json +0 -104
  259. package/cli/agents/validator-story-ux.md +0 -152
  260. package/kanban/client/dist/assets/index-CiD8PS2e.js +0 -306
  261. package/kanban/client/dist/assets/index-nLh0m82Q.css +0 -1
@@ -0,0 +1,171 @@
1
+ {
2
+ "scope": "epic",
3
+ "tier": 2,
4
+ "checks": [
5
+ {
6
+ "id": "xref-sec-api-epic-01",
7
+ "tier": 2,
8
+ "perspectives": ["security", "api"],
9
+ "severity": "critical",
10
+ "category": "consistency",
11
+ "dependsOn": ["sec-epic-08", "api-epic-01"],
12
+ "question": "Security requires: {{sec-epic-08.evidence}}. API defines: {{api-epic-01.evidence}}. Are the named roles and permission boundaries consistent with the API endpoint definitions?",
13
+ "failDescription": "Security role model and API endpoint access control definitions are inconsistent",
14
+ "failSuggestion": "Align API endpoint authorization with the security role model — ensure every endpoint names which roles can access it"
15
+ },
16
+ {
17
+ "id": "xref-sec-api-epic-02",
18
+ "tier": 2,
19
+ "perspectives": ["security", "api"],
20
+ "severity": "major",
21
+ "category": "consistency",
22
+ "dependsOn": ["sec-epic-03", "api-epic-06"],
23
+ "question": "Security defines trust boundaries: {{sec-epic-03.evidence}}. API patterns: {{api-epic-06.evidence}}. Are API error codes consistent with the security error taxonomy?",
24
+ "failDescription": "Security error taxonomy and API error codes are inconsistent",
25
+ "failSuggestion": "Ensure API error codes (401/403/404/422/429) match the security-defined error taxonomy"
26
+ },
27
+ {
28
+ "id": "xref-sec-db-epic-01",
29
+ "tier": 2,
30
+ "perspectives": ["security", "database"],
31
+ "severity": "critical",
32
+ "category": "consistency",
33
+ "dependsOn": ["sec-epic-12", "db-epic-01"],
34
+ "question": "Security identifies PII fields: {{sec-epic-12.evidence}}. Database defines schema: {{db-epic-01.evidence}}. Are PII fields identified in the database schema with appropriate protection?",
35
+ "failDescription": "Security PII requirements and database schema protection are misaligned",
36
+ "failSuggestion": "Ensure PII fields identified by security are protected in the database schema (encryption at rest, access controls)"
37
+ },
38
+ {
39
+ "id": "xref-sec-db-epic-02",
40
+ "tier": 2,
41
+ "perspectives": ["security", "database"],
42
+ "severity": "major",
43
+ "category": "consistency",
44
+ "dependsOn": ["sec-epic-14", "db-epic-06"],
45
+ "question": "Security requires audit logging: {{sec-epic-14.evidence}}. Database architecture: {{db-epic-06.evidence}}. Is the audit log storage aligned with database architecture?",
46
+ "failDescription": "Security audit log requirements and database storage architecture are inconsistent",
47
+ "failSuggestion": "Align audit log storage with database architecture — define where and how audit events are persisted"
48
+ },
49
+ {
50
+ "id": "xref-be-api-epic-01",
51
+ "tier": 2,
52
+ "perspectives": ["backend", "api"],
53
+ "severity": "critical",
54
+ "category": "consistency",
55
+ "dependsOn": ["be-epic-01", "api-epic-01"],
56
+ "question": "Backend defines service boundaries: {{be-epic-01.evidence}}. API defines endpoint surface: {{api-epic-01.evidence}}. Are backend service boundaries consistent with API endpoint definitions?",
57
+ "failDescription": "Backend service boundaries and API endpoint surface are inconsistent",
58
+ "failSuggestion": "Align backend services with API endpoints — each API endpoint should map to a defined backend service"
59
+ },
60
+ {
61
+ "id": "xref-be-api-epic-02",
62
+ "tier": 2,
63
+ "perspectives": ["backend", "api"],
64
+ "severity": "major",
65
+ "category": "consistency",
66
+ "dependsOn": ["be-epic-07", "api-epic-07"],
67
+ "question": "Backend architecture patterns: {{be-epic-07.evidence}}. API performance: {{api-epic-07.evidence}}. Are backend architectural patterns supporting the API performance requirements?",
68
+ "failDescription": "Backend architecture does not adequately support API performance requirements",
69
+ "failSuggestion": "Ensure backend architecture (caching, async processing) supports API performance targets (latency, throughput)"
70
+ },
71
+ {
72
+ "id": "xref-devops-be-epic-01",
73
+ "tier": 2,
74
+ "perspectives": ["devops", "backend"],
75
+ "severity": "major",
76
+ "category": "consistency",
77
+ "dependsOn": ["devops-epic-08", "be-epic-01"],
78
+ "question": "DevOps infrastructure: {{devops-epic-08.evidence}}. Backend boundaries: {{be-epic-01.evidence}}. Are deployment infrastructure patterns aligned with backend service architecture?",
79
+ "failDescription": "DevOps deployment infrastructure and backend service architecture are misaligned",
80
+ "failSuggestion": "Align deployment infrastructure with backend architecture — each service should have a defined deployment strategy"
81
+ },
82
+ {
83
+ "id": "xref-devops-be-epic-02",
84
+ "tier": 2,
85
+ "perspectives": ["devops", "backend"],
86
+ "severity": "major",
87
+ "category": "consistency",
88
+ "dependsOn": ["devops-epic-10", "be-epic-08"],
89
+ "question": "DevOps observability: {{devops-epic-10.evidence}}. Backend performance: {{be-epic-08.evidence}}. Does the observability stack cover backend performance monitoring needs?",
90
+ "failDescription": "DevOps observability stack does not adequately cover backend performance monitoring",
91
+ "failSuggestion": "Ensure observability stack monitors backend performance metrics: latency, error rates, resource utilization"
92
+ },
93
+ {
94
+ "id": "xref-qa-dev-epic-01",
95
+ "tier": 2,
96
+ "perspectives": ["qa", "developer"],
97
+ "severity": "major",
98
+ "category": "consistency",
99
+ "dependsOn": ["qa-epic-01", "dev-epic-06"],
100
+ "question": "QA defines test boundaries: {{qa-epic-01.evidence}}. Developer testing strategy: {{dev-epic-06.evidence}}. Are QA quality gates aligned with the developer testing strategy?",
101
+ "failDescription": "QA quality gates and developer testing strategy are not aligned",
102
+ "failSuggestion": "Align QA quality gates with developer testing — ensure coverage targets, test types, and quality metrics are consistent"
103
+ },
104
+ {
105
+ "id": "xref-qa-sec-epic-01",
106
+ "tier": 2,
107
+ "perspectives": ["qa", "security"],
108
+ "severity": "major",
109
+ "category": "consistency",
110
+ "dependsOn": ["qa-epic-05", "sec-epic-01"],
111
+ "question": "QA test patterns: {{qa-epic-05.evidence}}. Security threat model: {{sec-epic-01.evidence}}. Does the QA test strategy include security testing for identified threat categories?",
112
+ "failDescription": "QA test strategy does not include security testing for identified threats",
113
+ "failSuggestion": "Include security test scenarios in QA strategy for each threat category: auth abuse, authz bypass, injection"
114
+ },
115
+ {
116
+ "id": "xref-sa-be-epic-01",
117
+ "tier": 2,
118
+ "perspectives": ["solution-architect", "backend"],
119
+ "severity": "major",
120
+ "category": "consistency",
121
+ "dependsOn": ["sa-epic-08", "be-epic-03"],
122
+ "question": "SA integration points: {{sa-epic-08.evidence}}. Backend dependencies: {{be-epic-03.evidence}}. Are architecture integration points consistent with backend service dependencies?",
123
+ "failDescription": "Architecture integration points and backend dependencies are inconsistent",
124
+ "failSuggestion": "Align integration points with backend dependencies — every consumed service should be listed in both places"
125
+ },
126
+ {
127
+ "id": "xref-sa-db-epic-01",
128
+ "tier": 2,
129
+ "perspectives": ["solution-architect", "database"],
130
+ "severity": "major",
131
+ "category": "consistency",
132
+ "dependsOn": ["sa-epic-05", "db-epic-01"],
133
+ "question": "SA database technology: {{sa-epic-05.evidence}}. Database boundaries: {{db-epic-01.evidence}}. Are the SA-specified database technology and the database schema design consistent?",
134
+ "failDescription": "SA database technology choice and database schema design are inconsistent",
135
+ "failSuggestion": "Ensure database technology matches across SA and database perspectives — same engine, same ORM, same conventions"
136
+ },
137
+ {
138
+ "id": "xref-fe-api-epic-01",
139
+ "tier": 2,
140
+ "perspectives": ["frontend", "api"],
141
+ "severity": "major",
142
+ "category": "consistency",
143
+ "dependsOn": ["fe-epic-02", "api-epic-01"],
144
+ "question": "Frontend server-state management: {{fe-epic-02.evidence}}. API boundaries: {{api-epic-01.evidence}}. Does the frontend data fetching strategy align with the API endpoint structure?",
145
+ "failDescription": "Frontend data fetching strategy and API endpoint structure are misaligned",
146
+ "failSuggestion": "Align frontend data fetching with API design — cache keys, refetch patterns, and pagination should match API contracts"
147
+ },
148
+ {
149
+ "id": "xref-fe-sec-epic-01",
150
+ "tier": 2,
151
+ "perspectives": ["frontend", "security"],
152
+ "severity": "major",
153
+ "category": "consistency",
154
+ "dependsOn": ["fe-epic-09", "sec-epic-04"],
155
+ "question": "Frontend accessibility standard: {{fe-epic-09.evidence}}. Security session lifecycle: {{sec-epic-04.evidence}}. Does the frontend handle session expiration and token refresh consistently with the security model?",
156
+ "failDescription": "Frontend session handling and security session lifecycle are inconsistent",
157
+ "failSuggestion": "Ensure frontend handles session expiration per security model: redirect on 401, refresh token flow, logout cleanup"
158
+ },
159
+ {
160
+ "id": "xref-ta-devops-epic-01",
161
+ "tier": 2,
162
+ "perspectives": ["test-architect", "devops"],
163
+ "severity": "minor",
164
+ "category": "consistency",
165
+ "dependsOn": ["ta-epic-01", "devops-epic-02"],
166
+ "question": "Test architecture: {{ta-epic-01.evidence}}. DevOps CI/CD: {{devops-epic-02.evidence}}. Is the test automation framework integrated into the CI/CD pipeline?",
167
+ "failDescription": "Test automation framework is not integrated into the CI/CD pipeline",
168
+ "failSuggestion": "Integrate test framework into CI/CD: run unit tests on commit, integration tests on PR, e2e tests before deploy"
169
+ }
170
+ ]
171
+ }
@@ -0,0 +1,149 @@
1
+ {
2
+ "scope": "story",
3
+ "tier": 2,
4
+ "checks": [
5
+ {
6
+ "id": "xref-sec-api-story-01",
7
+ "tier": 2,
8
+ "perspectives": ["security", "api"],
9
+ "severity": "major",
10
+ "category": "consistency",
11
+ "dependsOn": ["sec-story-04", "api-story-01"],
12
+ "question": "Security auth in story: {{sec-story-04.evidence}}. API contract: {{api-story-01.evidence}}. Are the story's authentication requirements consistent with its API endpoint definitions?",
13
+ "failDescription": "Story security auth model and API endpoint definitions are inconsistent",
14
+ "failSuggestion": "Align story's API endpoint auth with its security requirements"
15
+ },
16
+ {
17
+ "id": "xref-sec-api-story-02",
18
+ "tier": 2,
19
+ "perspectives": ["security", "api"],
20
+ "severity": "major",
21
+ "category": "consistency",
22
+ "dependsOn": ["sec-story-07", "api-story-03"],
23
+ "question": "Security input validation: {{sec-story-07.evidence}}. API inputs: {{api-story-03.evidence}}. Are input validation requirements consistent between security and API acceptance criteria?",
24
+ "failDescription": "Input validation requirements are inconsistent between security and API perspectives",
25
+ "failSuggestion": "Ensure every API input field has matching server-side validation from the security perspective"
26
+ },
27
+ {
28
+ "id": "xref-sec-api-story-03",
29
+ "tier": 2,
30
+ "perspectives": ["security", "api"],
31
+ "severity": "major",
32
+ "category": "consistency",
33
+ "dependsOn": ["sec-story-05", "api-story-02"],
34
+ "question": "Security authorization: {{sec-story-05.evidence}}. API authorization: {{api-story-02.evidence}}. Are IDOR/BOLA protections and role boundary definitions consistent?",
35
+ "failDescription": "Authorization protections differ between security and API perspectives",
36
+ "failSuggestion": "Align IDOR protection and role boundary checks across security and API acceptance criteria"
37
+ },
38
+ {
39
+ "id": "xref-sec-db-story-01",
40
+ "tier": 2,
41
+ "perspectives": ["security", "database"],
42
+ "severity": "major",
43
+ "category": "consistency",
44
+ "dependsOn": ["sec-story-09", "db-story-01"],
45
+ "question": "Security PII handling: {{sec-story-09.evidence}}. Database fields: {{db-story-01.evidence}}. Are PII fields handled consistently between security and database criteria?",
46
+ "failDescription": "PII handling differs between security and database acceptance criteria",
47
+ "failSuggestion": "Align PII field handling — database should reflect security's minimization and encryption requirements"
48
+ },
49
+ {
50
+ "id": "xref-sec-db-story-02",
51
+ "tier": 2,
52
+ "perspectives": ["security", "database"],
53
+ "severity": "major",
54
+ "category": "consistency",
55
+ "dependsOn": ["sec-story-10", "db-story-02"],
56
+ "question": "Security logging: {{sec-story-10.evidence}}. Database audit: {{db-story-02.evidence}}. Are audit logging requirements consistent?",
57
+ "failDescription": "Audit logging requirements differ between security and database perspectives",
58
+ "failSuggestion": "Ensure audit log events defined in security ACs have corresponding database persistence"
59
+ },
60
+ {
61
+ "id": "xref-be-api-story-01",
62
+ "tier": 2,
63
+ "perspectives": ["backend", "api"],
64
+ "severity": "major",
65
+ "category": "consistency",
66
+ "dependsOn": ["be-story-01", "api-story-01"],
67
+ "question": "Backend implementation: {{be-story-01.evidence}}. API contract: {{api-story-01.evidence}}. Are backend implementation details consistent with API contract definitions?",
68
+ "failDescription": "Backend implementation and API contract are misaligned",
69
+ "failSuggestion": "Align backend implementation with API contract — handlers should match endpoint definitions"
70
+ },
71
+ {
72
+ "id": "xref-be-api-story-02",
73
+ "tier": 2,
74
+ "perspectives": ["backend", "api"],
75
+ "severity": "major",
76
+ "category": "consistency",
77
+ "dependsOn": ["be-story-02", "api-story-03"],
78
+ "question": "Backend error handling: {{be-story-02.evidence}}. API errors: {{api-story-03.evidence}}. Are error handling patterns consistent?",
79
+ "failDescription": "Backend error handling doesn't match API error definitions",
80
+ "failSuggestion": "Align backend error paths with API error response specifications"
81
+ },
82
+ {
83
+ "id": "xref-devops-be-story-01",
84
+ "tier": 2,
85
+ "perspectives": ["devops", "backend"],
86
+ "severity": "minor",
87
+ "category": "consistency",
88
+ "dependsOn": ["devops-story-01", "be-story-03"],
89
+ "question": "DevOps requirements: {{devops-story-01.evidence}}. Backend architecture: {{be-story-03.evidence}}. Are deployment requirements consistent with the backend implementation?",
90
+ "failDescription": "DevOps and backend requirements are inconsistent",
91
+ "failSuggestion": "Align deployment configuration with backend runtime requirements"
92
+ },
93
+ {
94
+ "id": "xref-qa-dev-story-01",
95
+ "tier": 2,
96
+ "perspectives": ["test-architect", "developer"],
97
+ "severity": "major",
98
+ "category": "consistency",
99
+ "dependsOn": ["ta-story-01", "dev-story-04"],
100
+ "question": "Test architecture: {{ta-story-01.evidence}}. Developer testing: {{dev-story-04.evidence}}. Are test requirements consistent between test architect and developer perspectives?",
101
+ "failDescription": "Test requirements are misaligned between test architect and developer",
102
+ "failSuggestion": "Align test scenarios with test architecture layers (unit, integration, e2e)"
103
+ },
104
+ {
105
+ "id": "xref-qa-sec-story-01",
106
+ "tier": 2,
107
+ "perspectives": ["test-architect", "security"],
108
+ "severity": "major",
109
+ "category": "consistency",
110
+ "dependsOn": ["ta-story-02", "sec-story-11"],
111
+ "question": "Test coverage: {{ta-story-02.evidence}}. Security testing: {{sec-story-11.evidence}}. Does the test strategy cover security-specific scenarios (abuse, unauthorized access)?",
112
+ "failDescription": "Test strategy doesn't cover security-specific scenarios",
113
+ "failSuggestion": "Add test scenarios for security abuse paths (wrong credentials, forged tokens, unauthorized access)"
114
+ },
115
+ {
116
+ "id": "xref-qa-api-story-01",
117
+ "tier": 2,
118
+ "perspectives": ["test-architect", "api"],
119
+ "severity": "major",
120
+ "category": "consistency",
121
+ "dependsOn": ["ta-story-03", "api-story-01"],
122
+ "question": "Test approach: {{ta-story-03.evidence}}. API endpoints: {{api-story-01.evidence}}. Does the testing strategy include integration tests for the story's API endpoints?",
123
+ "failDescription": "Testing strategy doesn't cover API integration tests for this story",
124
+ "failSuggestion": "Add API integration test scenarios for each endpoint with success and error paths"
125
+ },
126
+ {
127
+ "id": "xref-sa-be-story-01",
128
+ "tier": 2,
129
+ "perspectives": ["solution-architect", "backend"],
130
+ "severity": "major",
131
+ "category": "consistency",
132
+ "dependsOn": ["sa-story-05", "be-story-01"],
133
+ "question": "SA dependencies: {{sa-story-05.evidence}}. Backend implementation: {{be-story-01.evidence}}. Are story dependencies and integration points consistent with backend implementation?",
134
+ "failDescription": "Story dependencies don't match backend implementation",
135
+ "failSuggestion": "Align story dependencies with actual backend service boundaries"
136
+ },
137
+ {
138
+ "id": "xref-sa-api-story-01",
139
+ "tier": 2,
140
+ "perspectives": ["solution-architect", "api"],
141
+ "severity": "major",
142
+ "category": "consistency",
143
+ "dependsOn": ["sa-story-01", "api-story-01"],
144
+ "question": "SA API contract: {{sa-story-01.evidence}}. API definition: {{api-story-01.evidence}}. Are SA-level API requirements consistent with detailed API definitions?",
145
+ "failDescription": "SA API requirements and detailed API definitions are inconsistent",
146
+ "failSuggestion": "Ensure SA endpoint requirements match the detailed API contract"
147
+ }
148
+ ]
149
+ }
@@ -0,0 +1,114 @@
1
+ {
2
+ "perspective": "api",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "api-epic-01",
7
+ "tier": 1,
8
+ "perspective": "api",
9
+ "severity": "critical",
10
+ "category": "completeness",
11
+ "universal": false,
12
+ "applicabilityQuestion": "Does this epic expose or consume APIs? (Does it define REST endpoints, GraphQL operations, or API contracts?)",
13
+ "question": "Does the epic scope clearly define API boundaries?",
14
+ "failDescription": "API boundaries are not defined — unclear which endpoints and resources are in scope",
15
+ "failSuggestion": "Define API boundaries: list endpoints, resource models, and API versioning strategy"
16
+ },
17
+ {
18
+ "id": "api-epic-02",
19
+ "tier": 1,
20
+ "perspective": "api",
21
+ "severity": "critical",
22
+ "category": "completeness",
23
+ "universal": false,
24
+ "applicabilityQuestion": "Does this epic expose or consume APIs?",
25
+ "question": "Are all critical API features identified?",
26
+ "failDescription": "Critical API features are missing — endpoints, auth, or error handling not fully identified",
27
+ "failSuggestion": "Identify critical API features: endpoint specifications, authentication, rate limiting, error handling, versioning"
28
+ },
29
+ {
30
+ "id": "api-epic-03",
31
+ "tier": 1,
32
+ "perspective": "api",
33
+ "severity": "major",
34
+ "category": "completeness",
35
+ "universal": false,
36
+ "applicabilityQuestion": "Does this epic depend on API services or infrastructure?",
37
+ "question": "Are dependencies on API services/infrastructure explicit?",
38
+ "failDescription": "API service dependencies are not explicit",
39
+ "failSuggestion": "Make API dependencies explicit: API gateway, authentication service, external APIs consumed"
40
+ },
41
+ {
42
+ "id": "api-epic-04",
43
+ "tier": 1,
44
+ "perspective": "api",
45
+ "severity": "major",
46
+ "category": "completeness",
47
+ "universal": false,
48
+ "applicabilityQuestion": "Does this epic expose or consume APIs?",
49
+ "question": "Are API success criteria measurable?",
50
+ "failDescription": "API success criteria are not measurable",
51
+ "failSuggestion": "Define measurable API criteria: response time, throughput, error rate, uptime SLA"
52
+ },
53
+ {
54
+ "id": "api-epic-05",
55
+ "tier": 1,
56
+ "perspective": "api",
57
+ "severity": "minor",
58
+ "category": "clarity",
59
+ "universal": false,
60
+ "applicabilityQuestion": "Does this epic expose or consume APIs?",
61
+ "question": "Is API terminology used correctly?",
62
+ "failDescription": "API terminology is used incorrectly or inconsistently",
63
+ "failSuggestion": "Review API terminology: REST methods, status codes, resource naming, pagination"
64
+ },
65
+ {
66
+ "id": "api-epic-06",
67
+ "tier": 1,
68
+ "perspective": "api",
69
+ "severity": "major",
70
+ "category": "technical-depth",
71
+ "universal": false,
72
+ "applicabilityQuestion": "Does this epic involve API design or architecture?",
73
+ "question": "Are API architectural patterns considered?",
74
+ "failDescription": "API architectural patterns are not considered",
75
+ "failSuggestion": "Consider API patterns: RESTful resource design, consistent error format, pagination, filtering, versioning"
76
+ },
77
+ {
78
+ "id": "api-epic-07",
79
+ "tier": 1,
80
+ "perspective": "api",
81
+ "severity": "major",
82
+ "category": "technical-depth",
83
+ "universal": false,
84
+ "applicabilityQuestion": "Does this epic expose APIs that need to handle load?",
85
+ "question": "Are performance/scalability concerns for API addressed?",
86
+ "failDescription": "API performance and scalability concerns are not addressed",
87
+ "failSuggestion": "Address API performance: rate limiting, caching headers, pagination limits, payload size constraints"
88
+ },
89
+ {
90
+ "id": "api-epic-08",
91
+ "tier": 1,
92
+ "perspective": "api",
93
+ "severity": "minor",
94
+ "category": "consistency",
95
+ "universal": false,
96
+ "applicabilityQuestion": "Does this epic expose or consume APIs?",
97
+ "question": "Does the API approach align with project context?",
98
+ "failDescription": "API approach does not align with project context",
99
+ "failSuggestion": "Ensure API approach aligns with project: consistent naming, versioning, and error handling conventions"
100
+ },
101
+ {
102
+ "id": "api-epic-09",
103
+ "tier": 1,
104
+ "perspective": "api",
105
+ "severity": "minor",
106
+ "category": "best-practices",
107
+ "universal": false,
108
+ "applicabilityQuestion": "Does this epic expose or consume APIs?",
109
+ "question": "Are industry-standard API patterns followed (REST/GraphQL principles)?",
110
+ "failDescription": "API best practices are not followed",
111
+ "failSuggestion": "Follow API best practices: proper HTTP methods, meaningful status codes, consistent resource naming"
112
+ }
113
+ ]
114
+ }
@@ -0,0 +1,126 @@
1
+ {
2
+ "perspective": "backend",
3
+ "scope": "epic",
4
+ "checks": [
5
+ {
6
+ "id": "be-epic-01",
7
+ "tier": 1,
8
+ "perspective": "backend",
9
+ "severity": "critical",
10
+ "category": "completeness",
11
+ "universal": false,
12
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services? (Does it include APIs, background jobs, data processing, or service-to-service communication?)",
13
+ "question": "Does the epic scope clearly define backend boundaries?",
14
+ "failDescription": "Backend boundaries are not defined — unclear which services and responsibilities are in scope",
15
+ "failSuggestion": "Define backend boundaries: which services, routes, and responsibilities belong to this epic"
16
+ },
17
+ {
18
+ "id": "be-epic-02",
19
+ "tier": 1,
20
+ "perspective": "backend",
21
+ "severity": "critical",
22
+ "category": "completeness",
23
+ "universal": false,
24
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
25
+ "question": "Are all critical backend features identified?",
26
+ "failDescription": "Critical backend features are missing — APIs, data access, or business logic not fully identified",
27
+ "failSuggestion": "Identify all critical backend features: API endpoints, data access patterns, business logic, background jobs"
28
+ },
29
+ {
30
+ "id": "be-epic-03",
31
+ "tier": 1,
32
+ "perspective": "backend",
33
+ "severity": "major",
34
+ "category": "completeness",
35
+ "universal": false,
36
+ "applicabilityQuestion": "Does this epic depend on backend services or infrastructure?",
37
+ "question": "Are dependencies on backend services/infrastructure explicit?",
38
+ "failDescription": "Backend service dependencies are not explicit",
39
+ "failSuggestion": "Make backend dependencies explicit: database, message queue, cache, external APIs, auth service"
40
+ },
41
+ {
42
+ "id": "be-epic-04",
43
+ "tier": 1,
44
+ "perspective": "backend",
45
+ "severity": "major",
46
+ "category": "completeness",
47
+ "universal": false,
48
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
49
+ "question": "Are backend success criteria measurable?",
50
+ "failDescription": "Backend success criteria are not measurable",
51
+ "failSuggestion": "Define measurable backend criteria: response time targets, throughput, error rates, test coverage"
52
+ },
53
+ {
54
+ "id": "be-epic-05",
55
+ "tier": 1,
56
+ "perspective": "backend",
57
+ "severity": "minor",
58
+ "category": "clarity",
59
+ "universal": false,
60
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
61
+ "question": "Is backend terminology used correctly?",
62
+ "failDescription": "Backend terminology is used incorrectly or inconsistently",
63
+ "failSuggestion": "Review backend terminology for accuracy: middleware, service layer, repository pattern, etc."
64
+ },
65
+ {
66
+ "id": "be-epic-06",
67
+ "tier": 1,
68
+ "perspective": "backend",
69
+ "severity": "minor",
70
+ "category": "clarity",
71
+ "universal": false,
72
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
73
+ "question": "Are features described in business value terms?",
74
+ "failDescription": "Backend features lack business value context",
75
+ "failSuggestion": "Frame backend features in business terms alongside technical specifications"
76
+ },
77
+ {
78
+ "id": "be-epic-07",
79
+ "tier": 1,
80
+ "perspective": "backend",
81
+ "severity": "major",
82
+ "category": "technical-depth",
83
+ "universal": false,
84
+ "applicabilityQuestion": "Does this epic involve backend architecture? (Does it need service design, async processing, or caching?)",
85
+ "question": "Are backend architectural patterns considered?",
86
+ "failDescription": "Backend architectural patterns are not considered",
87
+ "failSuggestion": "Consider backend patterns: service layer, repository pattern, CQRS, event sourcing, async processing"
88
+ },
89
+ {
90
+ "id": "be-epic-08",
91
+ "tier": 1,
92
+ "perspective": "backend",
93
+ "severity": "major",
94
+ "category": "technical-depth",
95
+ "universal": false,
96
+ "applicabilityQuestion": "Does this epic involve backend services that need to handle load?",
97
+ "question": "Are performance/scalability concerns for backend addressed?",
98
+ "failDescription": "Backend performance and scalability concerns are not addressed",
99
+ "failSuggestion": "Address backend performance: caching strategy, connection pooling, async processing, horizontal scaling"
100
+ },
101
+ {
102
+ "id": "be-epic-09",
103
+ "tier": 1,
104
+ "perspective": "backend",
105
+ "severity": "minor",
106
+ "category": "consistency",
107
+ "universal": false,
108
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
109
+ "question": "Does the backend approach align with project context?",
110
+ "failDescription": "Backend approach does not align with project context",
111
+ "failSuggestion": "Ensure backend approach aligns with project: consistent framework, patterns, and conventions"
112
+ },
113
+ {
114
+ "id": "be-epic-10",
115
+ "tier": 1,
116
+ "perspective": "backend",
117
+ "severity": "minor",
118
+ "category": "best-practices",
119
+ "universal": false,
120
+ "applicabilityQuestion": "Does this epic involve server-side logic or backend services?",
121
+ "question": "Are industry-standard backend patterns followed (separation of concerns, SOLID)?",
122
+ "failDescription": "Backend best practices are not followed",
123
+ "failSuggestion": "Follow backend best practices: separation of concerns, SOLID principles, error handling patterns"
124
+ }
125
+ ]
126
+ }