aios-core 2.1.5 → 2.2.0

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 (392) hide show
  1. package/.aios-core/core/README.md +229 -229
  2. package/.aios-core/core/data/agent-config-requirements.yaml +368 -368
  3. package/.aios-core/core/data/aios-kb.md +923 -923
  4. package/.aios-core/core/data/workflow-patterns.yaml +267 -267
  5. package/.aios-core/core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  6. package/.aios-core/core/docs/component-creation-guide.md +457 -457
  7. package/.aios-core/core/docs/session-update-pattern.md +307 -307
  8. package/.aios-core/core/docs/template-syntax.md +266 -266
  9. package/.aios-core/core/docs/troubleshooting-guide.md +624 -624
  10. package/.aios-core/core/elicitation/elicitation-engine.js +1 -1
  11. package/.aios-core/core/index.esm.js +42 -42
  12. package/.aios-core/core/index.js +1 -1
  13. package/.aios-core/core/migration/migration-config.yaml +83 -83
  14. package/.aios-core/core/migration/module-mapping.yaml +89 -89
  15. package/.aios-core/core/quality-gates/layer2-pr-automation.js +1 -1
  16. package/.aios-core/core/quality-gates/quality-gate-config.yaml +86 -86
  17. package/.aios-core/core/registry/README.md +179 -179
  18. package/.aios-core/core/utils/security-utils.js +1 -1
  19. package/.aios-core/core-config.yaml +391 -382
  20. package/.aios-core/data/agent-config-requirements.yaml +368 -368
  21. package/.aios-core/data/aios-kb.md +923 -923
  22. package/.aios-core/data/technical-preferences.md +3 -3
  23. package/.aios-core/data/workflow-patterns.yaml +267 -267
  24. package/.aios-core/development/README.md +142 -142
  25. package/.aios-core/development/agent-teams/team-all.yaml +15 -15
  26. package/.aios-core/development/agent-teams/team-fullstack.yaml +18 -18
  27. package/.aios-core/development/agent-teams/team-ide-minimal.yaml +10 -10
  28. package/.aios-core/development/agent-teams/team-no-ui.yaml +13 -13
  29. package/.aios-core/development/agent-teams/team-qa-focused.yaml +155 -155
  30. package/.aios-core/development/agents/aios-master.md +339 -339
  31. package/.aios-core/development/agents/analyst.md +195 -195
  32. package/.aios-core/development/agents/architect.md +359 -359
  33. package/.aios-core/development/agents/data-engineer.md +468 -468
  34. package/.aios-core/development/agents/dev.md +390 -390
  35. package/.aios-core/development/agents/devops.md +398 -398
  36. package/.aios-core/development/agents/pm.md +198 -198
  37. package/.aios-core/development/agents/po.md +256 -256
  38. package/.aios-core/development/agents/qa.md +312 -312
  39. package/.aios-core/development/agents/sm.md +220 -220
  40. package/.aios-core/development/agents/ux-design-expert.md +451 -451
  41. package/.aios-core/development/scripts/greeting-config-cli.js +85 -85
  42. package/.aios-core/development/tasks/add-mcp.md +319 -319
  43. package/.aios-core/development/tasks/advanced-elicitation.md +318 -318
  44. package/.aios-core/development/tasks/analyst-facilitate-brainstorming.md +341 -341
  45. package/.aios-core/development/tasks/analyze-brownfield.md +456 -0
  46. package/.aios-core/development/tasks/analyze-framework.md +696 -696
  47. package/.aios-core/development/tasks/analyze-performance.md +637 -637
  48. package/.aios-core/development/tasks/apply-qa-fixes.md +340 -340
  49. package/.aios-core/development/tasks/architect-analyze-impact.md +826 -826
  50. package/.aios-core/development/tasks/audit-codebase.md +429 -429
  51. package/.aios-core/development/tasks/audit-tailwind-config.md +270 -270
  52. package/.aios-core/development/tasks/audit-utilities.md +358 -358
  53. package/.aios-core/development/tasks/bootstrap-shadcn-library.md +286 -286
  54. package/.aios-core/development/tasks/brownfield-create-epic.md +485 -485
  55. package/.aios-core/development/tasks/brownfield-create-story.md +356 -356
  56. package/.aios-core/development/tasks/build-component.md +478 -478
  57. package/.aios-core/development/tasks/calculate-roi.md +455 -455
  58. package/.aios-core/development/tasks/ci-cd-configuration.md +764 -764
  59. package/.aios-core/development/tasks/cleanup-utilities.md +670 -670
  60. package/.aios-core/development/tasks/collaborative-edit.md +1108 -1108
  61. package/.aios-core/development/tasks/compose-molecule.md +284 -284
  62. package/.aios-core/development/tasks/consolidate-patterns.md +414 -414
  63. package/.aios-core/development/tasks/correct-course.md +279 -279
  64. package/.aios-core/development/tasks/create-agent.md +321 -321
  65. package/.aios-core/development/tasks/create-brownfield-story.md +726 -726
  66. package/.aios-core/development/tasks/create-deep-research-prompt.md +498 -498
  67. package/.aios-core/development/tasks/create-doc.md +316 -316
  68. package/.aios-core/development/tasks/create-next-story.md +774 -774
  69. package/.aios-core/development/tasks/create-suite.md +283 -283
  70. package/.aios-core/development/tasks/create-task.md +371 -371
  71. package/.aios-core/development/tasks/create-workflow.md +370 -370
  72. package/.aios-core/development/tasks/db-analyze-hotpaths.md +572 -572
  73. package/.aios-core/development/tasks/db-apply-migration.md +381 -381
  74. package/.aios-core/development/tasks/db-bootstrap.md +642 -642
  75. package/.aios-core/development/tasks/db-domain-modeling.md +693 -693
  76. package/.aios-core/development/tasks/db-dry-run.md +293 -293
  77. package/.aios-core/development/tasks/db-env-check.md +260 -260
  78. package/.aios-core/development/tasks/db-expansion-pack-integration.md +663 -663
  79. package/.aios-core/development/tasks/db-explain.md +631 -631
  80. package/.aios-core/development/tasks/db-impersonate.md +495 -495
  81. package/.aios-core/development/tasks/db-load-csv.md +593 -593
  82. package/.aios-core/development/tasks/db-policy-apply.md +653 -653
  83. package/.aios-core/development/tasks/db-rls-audit.md +411 -411
  84. package/.aios-core/development/tasks/db-rollback.md +739 -739
  85. package/.aios-core/development/tasks/db-run-sql.md +613 -613
  86. package/.aios-core/development/tasks/db-schema-audit.md +1011 -1011
  87. package/.aios-core/development/tasks/db-seed.md +390 -390
  88. package/.aios-core/development/tasks/db-smoke-test.md +351 -351
  89. package/.aios-core/development/tasks/db-snapshot.md +569 -569
  90. package/.aios-core/development/tasks/db-supabase-setup.md +712 -712
  91. package/.aios-core/development/tasks/db-verify-order.md +515 -515
  92. package/.aios-core/development/tasks/deprecate-component.md +956 -956
  93. package/.aios-core/development/tasks/dev-apply-qa-fixes.md +318 -318
  94. package/.aios-core/development/tasks/dev-backlog-debt.md +469 -469
  95. package/.aios-core/development/tasks/dev-develop-story.md +846 -846
  96. package/.aios-core/development/tasks/dev-improve-code-quality.md +872 -872
  97. package/.aios-core/development/tasks/dev-optimize-performance.md +1033 -1033
  98. package/.aios-core/development/tasks/dev-suggest-refactoring.md +870 -870
  99. package/.aios-core/development/tasks/dev-validate-next-story.md +348 -348
  100. package/.aios-core/development/tasks/document-project.md +552 -552
  101. package/.aios-core/development/tasks/environment-bootstrap.md +1311 -1311
  102. package/.aios-core/development/tasks/execute-checklist.md +301 -301
  103. package/.aios-core/development/tasks/export-design-tokens-dtcg.md +274 -274
  104. package/.aios-core/development/tasks/extend-pattern.md +269 -269
  105. package/.aios-core/development/tasks/extract-tokens.md +467 -467
  106. package/.aios-core/development/tasks/facilitate-brainstorming-session.md +518 -518
  107. package/.aios-core/development/tasks/generate-ai-frontend-prompt.md +260 -260
  108. package/.aios-core/development/tasks/generate-documentation.md +284 -284
  109. package/.aios-core/development/tasks/generate-migration-strategy.md +522 -522
  110. package/.aios-core/development/tasks/generate-shock-report.md +501 -501
  111. package/.aios-core/development/tasks/github-devops-github-pr-automation.md +427 -427
  112. package/.aios-core/development/tasks/github-devops-pre-push-quality-gate.md +733 -733
  113. package/.aios-core/development/tasks/github-devops-repository-cleanup.md +374 -374
  114. package/.aios-core/development/tasks/github-devops-version-management.md +483 -483
  115. package/.aios-core/development/tasks/improve-self.md +822 -822
  116. package/.aios-core/development/tasks/index-docs.md +387 -387
  117. package/.aios-core/development/tasks/init-project-status.md +506 -506
  118. package/.aios-core/development/tasks/integrate-expansion-pack.md +314 -314
  119. package/.aios-core/development/tasks/kb-mode-interaction.md +283 -283
  120. package/.aios-core/development/tasks/learn-patterns.md +900 -900
  121. package/.aios-core/development/tasks/mcp-workflow.md +437 -437
  122. package/.aios-core/development/tasks/modify-agent.md +381 -381
  123. package/.aios-core/development/tasks/modify-task.md +424 -424
  124. package/.aios-core/development/tasks/modify-workflow.md +465 -465
  125. package/.aios-core/development/tasks/po-backlog-add.md +370 -370
  126. package/.aios-core/development/tasks/po-manage-story-backlog.md +523 -523
  127. package/.aios-core/development/tasks/po-pull-story-from-clickup.md +540 -540
  128. package/.aios-core/development/tasks/po-pull-story.md +316 -316
  129. package/.aios-core/development/tasks/po-stories-index.md +351 -351
  130. package/.aios-core/development/tasks/po-sync-story-to-clickup.md +457 -457
  131. package/.aios-core/development/tasks/po-sync-story.md +303 -303
  132. package/.aios-core/development/tasks/pr-automation.md +701 -701
  133. package/.aios-core/development/tasks/propose-modification.md +842 -842
  134. package/.aios-core/development/tasks/qa-backlog-add-followup.md +425 -425
  135. package/.aios-core/development/tasks/qa-gate.md +373 -373
  136. package/.aios-core/development/tasks/qa-generate-tests.md +1174 -1174
  137. package/.aios-core/development/tasks/qa-nfr-assess.md +557 -557
  138. package/.aios-core/development/tasks/qa-review-proposal.md +1157 -1157
  139. package/.aios-core/development/tasks/qa-review-story.md +682 -682
  140. package/.aios-core/development/tasks/qa-risk-profile.md +566 -566
  141. package/.aios-core/development/tasks/qa-run-tests.md +277 -277
  142. package/.aios-core/development/tasks/qa-test-design.md +387 -387
  143. package/.aios-core/development/tasks/qa-trace-requirements.md +476 -476
  144. package/.aios-core/development/tasks/release-management.md +723 -723
  145. package/.aios-core/development/tasks/security-audit.md +554 -554
  146. package/.aios-core/development/tasks/security-scan.md +790 -790
  147. package/.aios-core/development/tasks/setup-database.md +741 -741
  148. package/.aios-core/development/tasks/setup-design-system.md +462 -462
  149. package/.aios-core/development/tasks/setup-github.md +874 -874
  150. package/.aios-core/development/tasks/setup-llm-routing.md +1 -1
  151. package/.aios-core/development/tasks/setup-mcp-docker.md +584 -584
  152. package/.aios-core/development/tasks/setup-project-docs.md +440 -0
  153. package/.aios-core/development/tasks/shard-doc.md +537 -537
  154. package/.aios-core/development/tasks/sm-create-next-story.md +480 -480
  155. package/.aios-core/development/tasks/sync-documentation.md +864 -864
  156. package/.aios-core/development/tasks/tailwind-upgrade.md +294 -294
  157. package/.aios-core/development/tasks/test-as-user.md +621 -621
  158. package/.aios-core/development/tasks/test-validation-task.md +171 -171
  159. package/.aios-core/development/tasks/undo-last.md +346 -346
  160. package/.aios-core/development/tasks/update-manifest.md +409 -409
  161. package/.aios-core/development/tasks/ux-create-wireframe.md +617 -617
  162. package/.aios-core/development/tasks/ux-ds-scan-artifact.md +672 -672
  163. package/.aios-core/development/tasks/ux-user-research.md +559 -559
  164. package/.aios-core/development/tasks/validate-next-story.md +422 -422
  165. package/.aios-core/development/workflows/README.md +83 -83
  166. package/.aios-core/development/workflows/brownfield-fullstack.yaml +297 -297
  167. package/.aios-core/development/workflows/brownfield-service.yaml +187 -187
  168. package/.aios-core/development/workflows/brownfield-ui.yaml +197 -197
  169. package/.aios-core/development/workflows/greenfield-fullstack.yaml +333 -333
  170. package/.aios-core/development/workflows/greenfield-service.yaml +206 -206
  171. package/.aios-core/development/workflows/greenfield-ui.yaml +235 -235
  172. package/.aios-core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  173. package/.aios-core/docs/component-creation-guide.md +457 -457
  174. package/.aios-core/docs/session-update-pattern.md +307 -307
  175. package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +572 -572
  176. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md +185 -185
  177. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md +354 -354
  178. package/.aios-core/docs/standards/AIOS-FRAMEWORK-MASTER.md +1963 -1963
  179. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md +821 -821
  180. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md +1190 -1190
  181. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1.md +439 -439
  182. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md +1339 -1339
  183. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO.md +5398 -5398
  184. package/.aios-core/docs/standards/EXECUTOR-DECISION-TREE.md +697 -697
  185. package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +511 -511
  186. package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md +556 -556
  187. package/.aios-core/docs/standards/STANDARDS-INDEX.md +210 -210
  188. package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +550 -550
  189. package/.aios-core/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1414 -1414
  190. package/.aios-core/docs/standards/V3-ARCHITECTURAL-DECISIONS.md +523 -523
  191. package/.aios-core/docs/template-syntax.md +266 -266
  192. package/.aios-core/docs/troubleshooting-guide.md +624 -624
  193. package/.aios-core/index.esm.js +15 -15
  194. package/.aios-core/index.js +1 -1
  195. package/.aios-core/infrastructure/README.md +126 -126
  196. package/.aios-core/infrastructure/integrations/pm-adapters/README.md +59 -59
  197. package/.aios-core/infrastructure/scripts/approval-workflow.js +1 -1
  198. package/.aios-core/infrastructure/scripts/batch-creator.js +1 -1
  199. package/.aios-core/infrastructure/scripts/component-generator.js +3 -3
  200. package/.aios-core/infrastructure/scripts/component-metadata.js +1 -1
  201. package/.aios-core/infrastructure/scripts/component-search.js +1 -1
  202. package/.aios-core/infrastructure/scripts/coverage-analyzer.js +1 -1
  203. package/.aios-core/infrastructure/scripts/dependency-analyzer.js +1 -1
  204. package/.aios-core/infrastructure/scripts/dependency-impact-analyzer.js +1 -1
  205. package/.aios-core/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +501 -0
  206. package/.aios-core/infrastructure/scripts/documentation-integrity/config-generator.js +368 -0
  207. package/.aios-core/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +308 -0
  208. package/.aios-core/infrastructure/scripts/documentation-integrity/doc-generator.js +331 -0
  209. package/.aios-core/infrastructure/scripts/documentation-integrity/gitignore-generator.js +312 -0
  210. package/.aios-core/infrastructure/scripts/documentation-integrity/index.js +74 -0
  211. package/.aios-core/infrastructure/scripts/documentation-integrity/mode-detector.js +389 -0
  212. package/.aios-core/infrastructure/scripts/framework-analyzer.js +1 -1
  213. package/.aios-core/infrastructure/scripts/improvement-engine.js +1 -1
  214. package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js +26 -13
  215. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -0
  216. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +108 -0
  217. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -0
  218. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +65 -0
  219. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -0
  220. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +16 -0
  221. package/.aios-core/infrastructure/scripts/llm-routing/usage-tracker/index.js +549 -0
  222. package/.aios-core/infrastructure/scripts/modification-risk-assessment.js +1 -1
  223. package/.aios-core/infrastructure/scripts/performance-analyzer.js +1 -1
  224. package/.aios-core/infrastructure/scripts/pm-adapter.js +134 -134
  225. package/.aios-core/infrastructure/scripts/repository-detector.js +3 -3
  226. package/.aios-core/infrastructure/scripts/template-engine.js +1 -1
  227. package/.aios-core/infrastructure/scripts/template-validator.js +1 -1
  228. package/.aios-core/infrastructure/scripts/test-generator.js +1 -1
  229. package/.aios-core/infrastructure/scripts/test-quality-assessment.js +1 -1
  230. package/.aios-core/infrastructure/scripts/transaction-manager.js +1 -1
  231. package/.aios-core/infrastructure/scripts/usage-analytics.js +1 -1
  232. package/.aios-core/infrastructure/scripts/visual-impact-generator.js +2 -2
  233. package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +176 -0
  234. package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +127 -0
  235. package/.aios-core/infrastructure/templates/github-workflows/README.md +109 -109
  236. package/.aios-core/infrastructure/templates/gitignore/gitignore-aios-base.tmpl +63 -0
  237. package/.aios-core/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +18 -0
  238. package/.aios-core/infrastructure/templates/gitignore/gitignore-node.tmpl +85 -0
  239. package/.aios-core/infrastructure/templates/gitignore/gitignore-python.tmpl +145 -0
  240. package/.aios-core/infrastructure/templates/project-docs/coding-standards-tmpl.md +346 -0
  241. package/.aios-core/infrastructure/templates/project-docs/source-tree-tmpl.md +177 -0
  242. package/.aios-core/infrastructure/templates/project-docs/tech-stack-tmpl.md +267 -0
  243. package/.aios-core/infrastructure/tests/regression-suite-v2.md +621 -621
  244. package/.aios-core/infrastructure/tools/README.md +222 -222
  245. package/.aios-core/infrastructure/tools/cli/github-cli.yaml +200 -200
  246. package/.aios-core/infrastructure/tools/cli/railway-cli.yaml +260 -260
  247. package/.aios-core/infrastructure/tools/cli/supabase-cli.yaml +224 -224
  248. package/.aios-core/infrastructure/tools/local/ffmpeg.yaml +261 -261
  249. package/.aios-core/infrastructure/tools/mcp/21st-dev-magic.yaml +127 -127
  250. package/.aios-core/infrastructure/tools/mcp/browser.yaml +103 -103
  251. package/.aios-core/infrastructure/tools/mcp/clickup.yaml +534 -534
  252. package/.aios-core/infrastructure/tools/mcp/context7.yaml +78 -78
  253. package/.aios-core/infrastructure/tools/mcp/desktop-commander.yaml +180 -180
  254. package/.aios-core/infrastructure/tools/mcp/exa.yaml +103 -103
  255. package/.aios-core/infrastructure/tools/mcp/google-workspace.yaml +930 -930
  256. package/.aios-core/infrastructure/tools/mcp/n8n.yaml +551 -551
  257. package/.aios-core/infrastructure/tools/mcp/supabase.yaml +808 -808
  258. package/.aios-core/install-manifest.yaml +347 -347
  259. package/.aios-core/product/README.md +56 -56
  260. package/.aios-core/product/checklists/accessibility-wcag-checklist.md +80 -0
  261. package/.aios-core/product/checklists/architect-checklist.md +443 -443
  262. package/.aios-core/product/checklists/change-checklist.md +182 -182
  263. package/.aios-core/product/checklists/component-quality-checklist.md +74 -0
  264. package/.aios-core/product/checklists/database-design-checklist.md +119 -119
  265. package/.aios-core/product/checklists/dba-predeploy-checklist.md +97 -97
  266. package/.aios-core/product/checklists/dba-rollback-checklist.md +99 -99
  267. package/.aios-core/product/checklists/migration-readiness-checklist.md +75 -0
  268. package/.aios-core/product/checklists/pattern-audit-checklist.md +88 -0
  269. package/.aios-core/product/checklists/pm-checklist.md +375 -375
  270. package/.aios-core/product/checklists/po-master-checklist.md +441 -441
  271. package/.aios-core/product/checklists/pre-push-checklist.md +108 -108
  272. package/.aios-core/product/checklists/release-checklist.md +122 -122
  273. package/.aios-core/product/checklists/story-dod-checklist.md +101 -101
  274. package/.aios-core/product/checklists/story-draft-checklist.md +215 -215
  275. package/.aios-core/product/data/atomic-design-principles.md +108 -0
  276. package/.aios-core/product/data/brainstorming-techniques.md +36 -36
  277. package/.aios-core/product/data/consolidation-algorithms.md +142 -0
  278. package/.aios-core/product/data/database-best-practices.md +182 -0
  279. package/.aios-core/product/data/design-token-best-practices.md +107 -0
  280. package/.aios-core/product/data/elicitation-methods.md +134 -134
  281. package/.aios-core/product/data/integration-patterns.md +207 -0
  282. package/.aios-core/product/data/migration-safety-guide.md +329 -0
  283. package/.aios-core/product/data/mode-selection-best-practices.md +471 -471
  284. package/.aios-core/product/data/postgres-tuning-guide.md +300 -0
  285. package/.aios-core/product/data/rls-security-patterns.md +333 -0
  286. package/.aios-core/product/data/roi-calculation-guide.md +142 -0
  287. package/.aios-core/product/data/supabase-patterns.md +330 -0
  288. package/.aios-core/product/data/test-levels-framework.md +148 -148
  289. package/.aios-core/product/data/test-priorities-matrix.md +174 -174
  290. package/.aios-core/product/data/wcag-compliance-guide.md +267 -0
  291. package/.aios-core/product/templates/1mcp-config.yaml +225 -225
  292. package/.aios-core/product/templates/activation-instructions-inline-greeting.yaml +63 -63
  293. package/.aios-core/product/templates/activation-instructions-template.md +258 -258
  294. package/.aios-core/product/templates/agent-template.yaml +120 -120
  295. package/.aios-core/product/templates/architecture-tmpl.yaml +650 -650
  296. package/.aios-core/product/templates/brainstorming-output-tmpl.yaml +155 -155
  297. package/.aios-core/product/templates/brownfield-architecture-tmpl.yaml +475 -475
  298. package/.aios-core/product/templates/brownfield-prd-tmpl.yaml +279 -279
  299. package/.aios-core/product/templates/changelog-template.md +134 -134
  300. package/.aios-core/product/templates/command-rationalization-matrix.md +152 -152
  301. package/.aios-core/product/templates/competitor-analysis-tmpl.yaml +292 -292
  302. package/.aios-core/product/templates/design-story-tmpl.yaml +587 -587
  303. package/.aios-core/product/templates/ds-artifact-analysis.md +70 -70
  304. package/.aios-core/product/templates/front-end-architecture-tmpl.yaml +205 -205
  305. package/.aios-core/product/templates/front-end-spec-tmpl.yaml +348 -348
  306. package/.aios-core/product/templates/fullstack-architecture-tmpl.yaml +804 -804
  307. package/.aios-core/product/templates/github-pr-template.md +67 -67
  308. package/.aios-core/product/templates/gordon-mcp.yaml +140 -140
  309. package/.aios-core/product/templates/ide-rules/antigravity-rules.md +115 -115
  310. package/.aios-core/product/templates/ide-rules/claude-rules.md +221 -221
  311. package/.aios-core/product/templates/ide-rules/cline-rules.md +84 -84
  312. package/.aios-core/product/templates/ide-rules/copilot-rules.md +92 -92
  313. package/.aios-core/product/templates/ide-rules/cursor-rules.md +115 -115
  314. package/.aios-core/product/templates/ide-rules/gemini-rules.md +85 -85
  315. package/.aios-core/product/templates/ide-rules/roo-rules.md +86 -86
  316. package/.aios-core/product/templates/ide-rules/trae-rules.md +104 -104
  317. package/.aios-core/product/templates/ide-rules/windsurf-rules.md +80 -80
  318. package/.aios-core/product/templates/index-strategy-tmpl.yaml +53 -53
  319. package/.aios-core/product/templates/market-research-tmpl.yaml +251 -251
  320. package/.aios-core/product/templates/mcp-workflow.js +271 -271
  321. package/.aios-core/product/templates/migration-plan-tmpl.yaml +1022 -1022
  322. package/.aios-core/product/templates/migration-strategy-tmpl.md +524 -524
  323. package/.aios-core/product/templates/personalized-agent-template.md +258 -258
  324. package/.aios-core/product/templates/personalized-checklist-template.md +340 -340
  325. package/.aios-core/product/templates/personalized-task-template-v2.md +905 -905
  326. package/.aios-core/product/templates/personalized-task-template.md +344 -344
  327. package/.aios-core/product/templates/personalized-template-file.yaml +322 -322
  328. package/.aios-core/product/templates/personalized-workflow-template.yaml +460 -460
  329. package/.aios-core/product/templates/prd-tmpl.yaml +201 -201
  330. package/.aios-core/product/templates/project-brief-tmpl.yaml +220 -220
  331. package/.aios-core/product/templates/qa-gate-tmpl.yaml +240 -240
  332. package/.aios-core/product/templates/rls-policies-tmpl.yaml +1203 -1203
  333. package/.aios-core/product/templates/schema-design-tmpl.yaml +428 -428
  334. package/.aios-core/product/templates/state-persistence-tmpl.yaml +219 -219
  335. package/.aios-core/product/templates/story-tmpl.yaml +331 -331
  336. package/.aios-core/product/templates/task-execution-report.md +495 -495
  337. package/.aios-core/product/templates/task-template.md +122 -122
  338. package/.aios-core/product/templates/token-exports-tailwind-tmpl.js +395 -395
  339. package/.aios-core/product/templates/tokens-schema-tmpl.yaml +305 -305
  340. package/.aios-core/product/templates/workflow-template.yaml +133 -133
  341. package/.aios-core/scripts/README.md +354 -354
  342. package/.aios-core/scripts/aios-doc-template.md +325 -325
  343. package/.aios-core/scripts/elicitation-engine.js +1 -1
  344. package/.aios-core/scripts/test-template-system.js +1 -1
  345. package/.aios-core/scripts/workflow-management.md +69 -69
  346. package/.aios-core/user-guide.md +1413 -1413
  347. package/.aios-core/working-in-the-brownfield.md +361 -361
  348. package/LICENSE +1 -1
  349. package/README.md +702 -703
  350. package/bin/aios-init-old.js +3 -3
  351. package/bin/aios-init-v4.js +1 -1
  352. package/bin/aios-init.backup-v1.1.4.js +1 -1
  353. package/bin/aios-init.js +3 -3
  354. package/bin/aios.js +279 -279
  355. package/bin/utils/install-errors.js +339 -339
  356. package/bin/utils/install-transaction.js +445 -445
  357. package/index.d.ts +18 -18
  358. package/index.esm.js +20 -20
  359. package/index.js +6 -6
  360. package/package.json +8 -10
  361. package/packages/installer/src/config/templates/env-template.js +27 -4
  362. package/packages/installer/src/detection/detect-project-type.js +81 -81
  363. package/packages/installer/src/wizard/wizard.js +185 -34
  364. package/packages/installer/tests/integration/environment-configuration.test.js +2 -1
  365. package/packages/installer/tests/integration/wizard-detection.test.js +8 -6
  366. package/packages/installer/tests/unit/env-template.test.js +11 -10
  367. package/src/config/ide-configs.js +1 -1
  368. package/src/wizard/feedback.js +2 -2
  369. package/src/wizard/index.js +1 -1
  370. package/src/wizard/validation/report-generator.js +1 -1
  371. package/src/wizard/validation/troubleshooting-system.js +13 -13
  372. package/.aios-core/development/tasks/validate-structure.md +0 -243
  373. package/.aios-core/infrastructure/scripts/_archived/final-todo-count.js +0 -122
  374. package/.aios-core/infrastructure/scripts/_archived/fix-yaml-formatting.js +0 -89
  375. package/.aios-core/infrastructure/scripts/_archived/migration-generator.js +0 -780
  376. package/.aios-core/infrastructure/scripts/_archived/migration-path-generator.js +0 -950
  377. package/.aios-core/infrastructure/scripts/_archived/phase2-entrada-saida-errors.js +0 -425
  378. package/.aios-core/infrastructure/scripts/_archived/phase2-spot-check.js +0 -132
  379. package/.aios-core/infrastructure/scripts/_archived/phase3-tools-scripts-validation.js +0 -381
  380. package/.aios-core/infrastructure/scripts/_archived/phase4-metadata-performance.js +0 -203
  381. package/.aios-core/infrastructure/scripts/_archived/test-yaml-parsing.js +0 -24
  382. package/.aios-core/infrastructure/scripts/_archived/verify-yaml-fix.js +0 -51
  383. package/.aios-core/infrastructure/scripts/source-tree-guardian/index.js +0 -375
  384. package/.aios-core/infrastructure/scripts/source-tree-guardian/manifest-generator.js +0 -410
  385. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/naming-rules.yaml +0 -285
  386. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/placement-rules.yaml +0 -262
  387. package/.aios-core/infrastructure/scripts/source-tree-guardian/validator.js +0 -468
  388. package/.aios-core/tasks/find-component.md.legacy +0 -391
  389. package/.aios-core/tasks/generate-commit-message.md.legacy +0 -426
  390. package/.aios-core/tasks/generate-migration.md.legacy +0 -382
  391. package/.aios-core/tasks/rollback-modification.md.legacy +0 -307
  392. package/.aios-core/tasks/update-tests.md.legacy +0 -283
@@ -1,376 +1,376 @@
1
- # Product Manager (PM) Requirements Checklist
2
-
3
- This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
4
-
5
- [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
6
-
7
- Before proceeding with this checklist, ensure you have access to:
8
-
9
- 1. prd.md - The Product Requirements Document (check docs/prd.md)
10
- 2. Any user research, market analysis, or competitive analysis documents
11
- 3. Business goals and strategy documents
12
- 4. Any existing epic definitions or user stories
13
-
14
- IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
15
-
16
- VALIDATION APPROACH:
17
-
18
- 1. User-Centric - Every requirement should tie back to user value
19
- 2. MVP Focus - Ensure scope is truly minimal while viable
20
- 3. Clarity - Requirements should be unambiguous and testable
21
- 4. Completeness - All aspects of the product vision are covered
22
- 5. Feasibility - Requirements are technically achievable
23
-
24
- EXECUTION MODE:
25
- Ask the user if they want to work through the checklist:
26
-
27
- - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
28
- - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
29
-
30
- ## 1. PROBLEM DEFINITION & CONTEXT
31
-
32
- [[LLM: The foundation of any product is a clear problem statement. As you review this section:
33
-
34
- 1. Verify the problem is real and worth solving
35
- 2. Check that the target audience is specific, not "everyone"
36
- 3. Ensure success metrics are measurable, not vague aspirations
37
- 4. Look for evidence of user research, not just assumptions
38
- 5. Confirm the problem-solution fit is logical]]
39
-
40
- ### 1.1 Problem Statement
41
-
42
- - [ ] Clear articulation of the problem being solved
43
- - [ ] Identification of who experiences the problem
44
- - [ ] Explanation of why solving this problem matters
45
- - [ ] Quantification of problem impact (if possible)
46
- - [ ] Differentiation from existing solutions
47
-
48
- ### 1.2 Business Goals & Success Metrics
49
-
50
- - [ ] Specific, measurable business objectives defined
51
- - [ ] Clear success metrics and KPIs established
52
- - [ ] Metrics are tied to user and business value
53
- - [ ] Baseline measurements identified (if applicable)
54
- - [ ] Timeframe for achieving goals specified
55
-
56
- ### 1.3 User Research & Insights
57
-
58
- - [ ] Target user personas clearly defined
59
- - [ ] User needs and pain points documented
60
- - [ ] User research findings summarized (if available)
61
- - [ ] Competitive analysis included
62
- - [ ] Market context provided
63
-
64
- ## 2. MVP SCOPE DEFINITION
65
-
66
- [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
67
-
68
- 1. Is this truly minimal? Challenge every feature
69
- 2. Does each feature directly address the core problem?
70
- 3. Are "nice-to-haves" clearly separated from "must-haves"?
71
- 4. Is the rationale for inclusion/exclusion documented?
72
- 5. Can you ship this in the target timeframe?]]
73
-
74
- ### 2.1 Core Functionality
75
-
76
- - [ ] Essential features clearly distinguished from nice-to-haves
77
- - [ ] Features directly address defined problem statement
78
- - [ ] Each Epic ties back to specific user needs
79
- - [ ] Features and Stories are described from user perspective
80
- - [ ] Minimum requirements for success defined
81
-
82
- ### 2.2 Scope Boundaries
83
-
84
- - [ ] Clear articulation of what is OUT of scope
85
- - [ ] Future enhancements section included
86
- - [ ] Rationale for scope decisions documented
87
- - [ ] MVP minimizes functionality while maximizing learning
88
- - [ ] Scope has been reviewed and refined multiple times
89
-
90
- ### 2.3 MVP Validation Approach
91
-
92
- - [ ] Method for testing MVP success defined
93
- - [ ] Initial user feedback mechanisms planned
94
- - [ ] Criteria for moving beyond MVP specified
95
- - [ ] Learning goals for MVP articulated
96
- - [ ] Timeline expectations set
97
-
98
- ## 3. USER EXPERIENCE REQUIREMENTS
99
-
100
- [[LLM: UX requirements bridge user needs and technical implementation. Validate:
101
-
102
- 1. User flows cover the primary use cases completely
103
- 2. Edge cases are identified (even if deferred)
104
- 3. Accessibility isn't an afterthought
105
- 4. Performance expectations are realistic
106
- 5. Error states and recovery are planned]]
107
-
108
- ### 3.1 User Journeys & Flows
109
-
110
- - [ ] Primary user flows documented
111
- - [ ] Entry and exit points for each flow identified
112
- - [ ] Decision points and branches mapped
113
- - [ ] Critical path highlighted
114
- - [ ] Edge cases considered
115
-
116
- ### 3.2 Usability Requirements
117
-
118
- - [ ] Accessibility considerations documented
119
- - [ ] Platform/device compatibility specified
120
- - [ ] Performance expectations from user perspective defined
121
- - [ ] Error handling and recovery approaches outlined
122
- - [ ] User feedback mechanisms identified
123
-
124
- ### 3.3 UI Requirements
125
-
126
- - [ ] Information architecture outlined
127
- - [ ] Critical UI components identified
128
- - [ ] Visual design guidelines referenced (if applicable)
129
- - [ ] Content requirements specified
130
- - [ ] High-level navigation structure defined
131
-
132
- ## 4. FUNCTIONAL REQUIREMENTS
133
-
134
- [[LLM: Functional requirements must be clear enough for implementation. Check:
135
-
136
- 1. Requirements focus on WHAT not HOW (no implementation details)
137
- 2. Each requirement is testable (how would QA verify it?)
138
- 3. Dependencies are explicit (what needs to be built first?)
139
- 4. Requirements use consistent terminology
140
- 5. Complex features are broken into manageable pieces]]
141
-
142
- ### 4.1 Feature Completeness
143
-
144
- - [ ] All required features for MVP documented
145
- - [ ] Features have clear, user-focused descriptions
146
- - [ ] Feature priority/criticality indicated
147
- - [ ] Requirements are testable and verifiable
148
- - [ ] Dependencies between features identified
149
-
150
- ### 4.2 Requirements Quality
151
-
152
- - [ ] Requirements are specific and unambiguous
153
- - [ ] Requirements focus on WHAT not HOW
154
- - [ ] Requirements use consistent terminology
155
- - [ ] Complex requirements broken into simpler parts
156
- - [ ] Technical jargon minimized or explained
157
-
158
- ### 4.3 User Stories & Acceptance Criteria
159
-
160
- - [ ] Stories follow consistent format
161
- - [ ] Acceptance criteria are testable
162
- - [ ] Stories are sized appropriately (not too large)
163
- - [ ] Stories are independent where possible
164
- - [ ] Stories include necessary context
165
- - [ ] Local testability requirements (e.g., via CLI) defined in ACs for relevant backend/data stories
166
-
167
- ## 5. NON-FUNCTIONAL REQUIREMENTS
168
-
169
- ### 5.1 Performance Requirements
170
-
171
- - [ ] Response time expectations defined
172
- - [ ] Throughput/capacity requirements specified
173
- - [ ] Scalability needs documented
174
- - [ ] Resource utilization constraints identified
175
- - [ ] Load handling expectations set
176
-
177
- ### 5.2 Security & Compliance
178
-
179
- - [ ] Data protection requirements specified
180
- - [ ] Authentication/authorization needs defined
181
- - [ ] Compliance requirements documented
182
- - [ ] Security testing requirements outlined
183
- - [ ] Privacy considerations addressed
184
-
185
- ### 5.3 Reliability & Resilience
186
-
187
- - [ ] Availability requirements defined
188
- - [ ] Backup and recovery needs documented
189
- - [ ] Fault tolerance expectations set
190
- - [ ] Error handling requirements specified
191
- - [ ] Maintenance and support considerations included
192
-
193
- ### 5.4 Technical Constraints
194
-
195
- - [ ] Platform/technology constraints documented
196
- - [ ] Integration requirements outlined
197
- - [ ] Third-party service dependencies identified
198
- - [ ] Infrastructure requirements specified
199
- - [ ] Development environment needs identified
200
-
201
- ## 6. EPIC & STORY STRUCTURE
202
-
203
- ### 6.1 Epic Definition
204
-
205
- - [ ] Epics represent cohesive units of functionality
206
- - [ ] Epics focus on user/business value delivery
207
- - [ ] Epic goals clearly articulated
208
- - [ ] Epics are sized appropriately for incremental delivery
209
- - [ ] Epic sequence and dependencies identified
210
-
211
- ### 6.2 Story Breakdown
212
-
213
- - [ ] Stories are broken down to appropriate size
214
- - [ ] Stories have clear, independent value
215
- - [ ] Stories include appropriate acceptance criteria
216
- - [ ] Story dependencies and sequence documented
217
- - [ ] Stories aligned with epic goals
218
-
219
- ### 6.3 First Epic Completeness
220
-
221
- - [ ] First epic includes all necessary setup steps
222
- - [ ] Project scaffolding and initialization addressed
223
- - [ ] Core infrastructure setup included
224
- - [ ] Development environment setup addressed
225
- - [ ] Local testability established early
226
-
227
- ## 7. TECHNICAL GUIDANCE
228
-
229
- ### 7.1 Architecture Guidance
230
-
231
- - [ ] Initial architecture direction provided
232
- - [ ] Technical constraints clearly communicated
233
- - [ ] Integration points identified
234
- - [ ] Performance considerations highlighted
235
- - [ ] Security requirements articulated
236
- - [ ] Known areas of high complexity or technical risk flagged for architectural deep-dive
237
-
238
- ### 7.2 Technical Decision Framework
239
-
240
- - [ ] Decision criteria for technical choices provided
241
- - [ ] Trade-offs articulated for key decisions
242
- - [ ] Rationale for selecting primary approach over considered alternatives documented (for key design/feature choices)
243
- - [ ] Non-negotiable technical requirements highlighted
244
- - [ ] Areas requiring technical investigation identified
245
- - [ ] Guidance on technical debt approach provided
246
-
247
- ### 7.3 Implementation Considerations
248
-
249
- - [ ] Development approach guidance provided
250
- - [ ] Testing requirements articulated
251
- - [ ] Deployment expectations set
252
- - [ ] Monitoring needs identified
253
- - [ ] Documentation requirements specified
254
-
255
- ## 8. CROSS-FUNCTIONAL REQUIREMENTS
256
-
257
- ### 8.1 Data Requirements
258
-
259
- - [ ] Data entities and relationships identified
260
- - [ ] Data storage requirements specified
261
- - [ ] Data quality requirements defined
262
- - [ ] Data retention policies identified
263
- - [ ] Data migration needs addressed (if applicable)
264
- - [ ] Schema changes planned iteratively, tied to stories requiring them
265
-
266
- ### 8.2 Integration Requirements
267
-
268
- - [ ] External system integrations identified
269
- - [ ] API requirements documented
270
- - [ ] Authentication for integrations specified
271
- - [ ] Data exchange formats defined
272
- - [ ] Integration testing requirements outlined
273
-
274
- ### 8.3 Operational Requirements
275
-
276
- - [ ] Deployment frequency expectations set
277
- - [ ] Environment requirements defined
278
- - [ ] Monitoring and alerting needs identified
279
- - [ ] Support requirements documented
280
- - [ ] Performance monitoring approach specified
281
-
282
- ## 9. CLARITY & COMMUNICATION
283
-
284
- ### 9.1 Documentation Quality
285
-
286
- - [ ] Documents use clear, consistent language
287
- - [ ] Documents are well-structured and organized
288
- - [ ] Technical terms are defined where necessary
289
- - [ ] Diagrams/visuals included where helpful
290
- - [ ] Documentation is versioned appropriately
291
-
292
- ### 9.2 Stakeholder Alignment
293
-
294
- - [ ] Key stakeholders identified
295
- - [ ] Stakeholder input incorporated
296
- - [ ] Potential areas of disagreement addressed
297
- - [ ] Communication plan for updates established
298
- - [ ] Approval process defined
299
-
300
- ## PRD & EPIC VALIDATION SUMMARY
301
-
302
- [[LLM: FINAL PM CHECKLIST REPORT GENERATION
303
-
304
- Create a comprehensive validation report that includes:
305
-
306
- 1. Executive Summary
307
-
308
- - Overall PRD completeness (percentage)
309
- - MVP scope appropriateness (Too Large/Just Right/Too Small)
310
- - Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
311
- - Most critical gaps or concerns
312
-
313
- 2. Category Analysis Table
314
- Fill in the actual table with:
315
-
316
- - Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
317
- - Critical Issues: Specific problems that block progress
318
-
319
- 3. Top Issues by Priority
320
-
321
- - BLOCKERS: Must fix before architect can proceed
322
- - HIGH: Should fix for quality
323
- - MEDIUM: Would improve clarity
324
- - LOW: Nice to have
325
-
326
- 4. MVP Scope Assessment
327
-
328
- - Features that might be cut for true MVP
329
- - Missing features that are essential
330
- - Complexity concerns
331
- - Timeline realism
332
-
333
- 5. Technical Readiness
334
-
335
- - Clarity of technical constraints
336
- - Identified technical risks
337
- - Areas needing architect investigation
338
-
339
- 6. Recommendations
340
- - Specific actions to address each blocker
341
- - Suggested improvements
342
- - Next steps
343
-
344
- After presenting the report, ask if the user wants:
345
-
346
- - Detailed analysis of any failed sections
347
- - Suggestions for improving specific areas
348
- - Help with refining MVP scope]]
349
-
350
- ### Category Statuses
351
-
352
- | Category | Status | Critical Issues |
353
- | -------------------------------- | ------ | --------------- |
354
- | 1. Problem Definition & Context | _TBD_ | |
355
- | 2. MVP Scope Definition | _TBD_ | |
356
- | 3. User Experience Requirements | _TBD_ | |
357
- | 4. Functional Requirements | _TBD_ | |
358
- | 5. Non-Functional Requirements | _TBD_ | |
359
- | 6. Epic & Story Structure | _TBD_ | |
360
- | 7. Technical Guidance | _TBD_ | |
361
- | 8. Cross-Functional Requirements | _TBD_ | |
362
- | 9. Clarity & Communication | _TBD_ | |
363
-
364
- ### Critical Deficiencies
365
-
366
- (To be populated during validation)
367
-
368
- ### Recommendations
369
-
370
- (To be populated during validation)
371
-
372
- ### Final Decision
373
-
374
- - **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
375
- - **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
1
+ # Product Manager (PM) Requirements Checklist
2
+
3
+ This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
4
+
5
+ [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
6
+
7
+ Before proceeding with this checklist, ensure you have access to:
8
+
9
+ 1. prd.md - The Product Requirements Document (check docs/prd.md)
10
+ 2. Any user research, market analysis, or competitive analysis documents
11
+ 3. Business goals and strategy documents
12
+ 4. Any existing epic definitions or user stories
13
+
14
+ IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
15
+
16
+ VALIDATION APPROACH:
17
+
18
+ 1. User-Centric - Every requirement should tie back to user value
19
+ 2. MVP Focus - Ensure scope is truly minimal while viable
20
+ 3. Clarity - Requirements should be unambiguous and testable
21
+ 4. Completeness - All aspects of the product vision are covered
22
+ 5. Feasibility - Requirements are technically achievable
23
+
24
+ EXECUTION MODE:
25
+ Ask the user if they want to work through the checklist:
26
+
27
+ - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
28
+ - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
29
+
30
+ ## 1. PROBLEM DEFINITION & CONTEXT
31
+
32
+ [[LLM: The foundation of any product is a clear problem statement. As you review this section:
33
+
34
+ 1. Verify the problem is real and worth solving
35
+ 2. Check that the target audience is specific, not "everyone"
36
+ 3. Ensure success metrics are measurable, not vague aspirations
37
+ 4. Look for evidence of user research, not just assumptions
38
+ 5. Confirm the problem-solution fit is logical]]
39
+
40
+ ### 1.1 Problem Statement
41
+
42
+ - [ ] Clear articulation of the problem being solved
43
+ - [ ] Identification of who experiences the problem
44
+ - [ ] Explanation of why solving this problem matters
45
+ - [ ] Quantification of problem impact (if possible)
46
+ - [ ] Differentiation from existing solutions
47
+
48
+ ### 1.2 Business Goals & Success Metrics
49
+
50
+ - [ ] Specific, measurable business objectives defined
51
+ - [ ] Clear success metrics and KPIs established
52
+ - [ ] Metrics are tied to user and business value
53
+ - [ ] Baseline measurements identified (if applicable)
54
+ - [ ] Timeframe for achieving goals specified
55
+
56
+ ### 1.3 User Research & Insights
57
+
58
+ - [ ] Target user personas clearly defined
59
+ - [ ] User needs and pain points documented
60
+ - [ ] User research findings summarized (if available)
61
+ - [ ] Competitive analysis included
62
+ - [ ] Market context provided
63
+
64
+ ## 2. MVP SCOPE DEFINITION
65
+
66
+ [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
67
+
68
+ 1. Is this truly minimal? Challenge every feature
69
+ 2. Does each feature directly address the core problem?
70
+ 3. Are "nice-to-haves" clearly separated from "must-haves"?
71
+ 4. Is the rationale for inclusion/exclusion documented?
72
+ 5. Can you ship this in the target timeframe?]]
73
+
74
+ ### 2.1 Core Functionality
75
+
76
+ - [ ] Essential features clearly distinguished from nice-to-haves
77
+ - [ ] Features directly address defined problem statement
78
+ - [ ] Each Epic ties back to specific user needs
79
+ - [ ] Features and Stories are described from user perspective
80
+ - [ ] Minimum requirements for success defined
81
+
82
+ ### 2.2 Scope Boundaries
83
+
84
+ - [ ] Clear articulation of what is OUT of scope
85
+ - [ ] Future enhancements section included
86
+ - [ ] Rationale for scope decisions documented
87
+ - [ ] MVP minimizes functionality while maximizing learning
88
+ - [ ] Scope has been reviewed and refined multiple times
89
+
90
+ ### 2.3 MVP Validation Approach
91
+
92
+ - [ ] Method for testing MVP success defined
93
+ - [ ] Initial user feedback mechanisms planned
94
+ - [ ] Criteria for moving beyond MVP specified
95
+ - [ ] Learning goals for MVP articulated
96
+ - [ ] Timeline expectations set
97
+
98
+ ## 3. USER EXPERIENCE REQUIREMENTS
99
+
100
+ [[LLM: UX requirements bridge user needs and technical implementation. Validate:
101
+
102
+ 1. User flows cover the primary use cases completely
103
+ 2. Edge cases are identified (even if deferred)
104
+ 3. Accessibility isn't an afterthought
105
+ 4. Performance expectations are realistic
106
+ 5. Error states and recovery are planned]]
107
+
108
+ ### 3.1 User Journeys & Flows
109
+
110
+ - [ ] Primary user flows documented
111
+ - [ ] Entry and exit points for each flow identified
112
+ - [ ] Decision points and branches mapped
113
+ - [ ] Critical path highlighted
114
+ - [ ] Edge cases considered
115
+
116
+ ### 3.2 Usability Requirements
117
+
118
+ - [ ] Accessibility considerations documented
119
+ - [ ] Platform/device compatibility specified
120
+ - [ ] Performance expectations from user perspective defined
121
+ - [ ] Error handling and recovery approaches outlined
122
+ - [ ] User feedback mechanisms identified
123
+
124
+ ### 3.3 UI Requirements
125
+
126
+ - [ ] Information architecture outlined
127
+ - [ ] Critical UI components identified
128
+ - [ ] Visual design guidelines referenced (if applicable)
129
+ - [ ] Content requirements specified
130
+ - [ ] High-level navigation structure defined
131
+
132
+ ## 4. FUNCTIONAL REQUIREMENTS
133
+
134
+ [[LLM: Functional requirements must be clear enough for implementation. Check:
135
+
136
+ 1. Requirements focus on WHAT not HOW (no implementation details)
137
+ 2. Each requirement is testable (how would QA verify it?)
138
+ 3. Dependencies are explicit (what needs to be built first?)
139
+ 4. Requirements use consistent terminology
140
+ 5. Complex features are broken into manageable pieces]]
141
+
142
+ ### 4.1 Feature Completeness
143
+
144
+ - [ ] All required features for MVP documented
145
+ - [ ] Features have clear, user-focused descriptions
146
+ - [ ] Feature priority/criticality indicated
147
+ - [ ] Requirements are testable and verifiable
148
+ - [ ] Dependencies between features identified
149
+
150
+ ### 4.2 Requirements Quality
151
+
152
+ - [ ] Requirements are specific and unambiguous
153
+ - [ ] Requirements focus on WHAT not HOW
154
+ - [ ] Requirements use consistent terminology
155
+ - [ ] Complex requirements broken into simpler parts
156
+ - [ ] Technical jargon minimized or explained
157
+
158
+ ### 4.3 User Stories & Acceptance Criteria
159
+
160
+ - [ ] Stories follow consistent format
161
+ - [ ] Acceptance criteria are testable
162
+ - [ ] Stories are sized appropriately (not too large)
163
+ - [ ] Stories are independent where possible
164
+ - [ ] Stories include necessary context
165
+ - [ ] Local testability requirements (e.g., via CLI) defined in ACs for relevant backend/data stories
166
+
167
+ ## 5. NON-FUNCTIONAL REQUIREMENTS
168
+
169
+ ### 5.1 Performance Requirements
170
+
171
+ - [ ] Response time expectations defined
172
+ - [ ] Throughput/capacity requirements specified
173
+ - [ ] Scalability needs documented
174
+ - [ ] Resource utilization constraints identified
175
+ - [ ] Load handling expectations set
176
+
177
+ ### 5.2 Security & Compliance
178
+
179
+ - [ ] Data protection requirements specified
180
+ - [ ] Authentication/authorization needs defined
181
+ - [ ] Compliance requirements documented
182
+ - [ ] Security testing requirements outlined
183
+ - [ ] Privacy considerations addressed
184
+
185
+ ### 5.3 Reliability & Resilience
186
+
187
+ - [ ] Availability requirements defined
188
+ - [ ] Backup and recovery needs documented
189
+ - [ ] Fault tolerance expectations set
190
+ - [ ] Error handling requirements specified
191
+ - [ ] Maintenance and support considerations included
192
+
193
+ ### 5.4 Technical Constraints
194
+
195
+ - [ ] Platform/technology constraints documented
196
+ - [ ] Integration requirements outlined
197
+ - [ ] Third-party service dependencies identified
198
+ - [ ] Infrastructure requirements specified
199
+ - [ ] Development environment needs identified
200
+
201
+ ## 6. EPIC & STORY STRUCTURE
202
+
203
+ ### 6.1 Epic Definition
204
+
205
+ - [ ] Epics represent cohesive units of functionality
206
+ - [ ] Epics focus on user/business value delivery
207
+ - [ ] Epic goals clearly articulated
208
+ - [ ] Epics are sized appropriately for incremental delivery
209
+ - [ ] Epic sequence and dependencies identified
210
+
211
+ ### 6.2 Story Breakdown
212
+
213
+ - [ ] Stories are broken down to appropriate size
214
+ - [ ] Stories have clear, independent value
215
+ - [ ] Stories include appropriate acceptance criteria
216
+ - [ ] Story dependencies and sequence documented
217
+ - [ ] Stories aligned with epic goals
218
+
219
+ ### 6.3 First Epic Completeness
220
+
221
+ - [ ] First epic includes all necessary setup steps
222
+ - [ ] Project scaffolding and initialization addressed
223
+ - [ ] Core infrastructure setup included
224
+ - [ ] Development environment setup addressed
225
+ - [ ] Local testability established early
226
+
227
+ ## 7. TECHNICAL GUIDANCE
228
+
229
+ ### 7.1 Architecture Guidance
230
+
231
+ - [ ] Initial architecture direction provided
232
+ - [ ] Technical constraints clearly communicated
233
+ - [ ] Integration points identified
234
+ - [ ] Performance considerations highlighted
235
+ - [ ] Security requirements articulated
236
+ - [ ] Known areas of high complexity or technical risk flagged for architectural deep-dive
237
+
238
+ ### 7.2 Technical Decision Framework
239
+
240
+ - [ ] Decision criteria for technical choices provided
241
+ - [ ] Trade-offs articulated for key decisions
242
+ - [ ] Rationale for selecting primary approach over considered alternatives documented (for key design/feature choices)
243
+ - [ ] Non-negotiable technical requirements highlighted
244
+ - [ ] Areas requiring technical investigation identified
245
+ - [ ] Guidance on technical debt approach provided
246
+
247
+ ### 7.3 Implementation Considerations
248
+
249
+ - [ ] Development approach guidance provided
250
+ - [ ] Testing requirements articulated
251
+ - [ ] Deployment expectations set
252
+ - [ ] Monitoring needs identified
253
+ - [ ] Documentation requirements specified
254
+
255
+ ## 8. CROSS-FUNCTIONAL REQUIREMENTS
256
+
257
+ ### 8.1 Data Requirements
258
+
259
+ - [ ] Data entities and relationships identified
260
+ - [ ] Data storage requirements specified
261
+ - [ ] Data quality requirements defined
262
+ - [ ] Data retention policies identified
263
+ - [ ] Data migration needs addressed (if applicable)
264
+ - [ ] Schema changes planned iteratively, tied to stories requiring them
265
+
266
+ ### 8.2 Integration Requirements
267
+
268
+ - [ ] External system integrations identified
269
+ - [ ] API requirements documented
270
+ - [ ] Authentication for integrations specified
271
+ - [ ] Data exchange formats defined
272
+ - [ ] Integration testing requirements outlined
273
+
274
+ ### 8.3 Operational Requirements
275
+
276
+ - [ ] Deployment frequency expectations set
277
+ - [ ] Environment requirements defined
278
+ - [ ] Monitoring and alerting needs identified
279
+ - [ ] Support requirements documented
280
+ - [ ] Performance monitoring approach specified
281
+
282
+ ## 9. CLARITY & COMMUNICATION
283
+
284
+ ### 9.1 Documentation Quality
285
+
286
+ - [ ] Documents use clear, consistent language
287
+ - [ ] Documents are well-structured and organized
288
+ - [ ] Technical terms are defined where necessary
289
+ - [ ] Diagrams/visuals included where helpful
290
+ - [ ] Documentation is versioned appropriately
291
+
292
+ ### 9.2 Stakeholder Alignment
293
+
294
+ - [ ] Key stakeholders identified
295
+ - [ ] Stakeholder input incorporated
296
+ - [ ] Potential areas of disagreement addressed
297
+ - [ ] Communication plan for updates established
298
+ - [ ] Approval process defined
299
+
300
+ ## PRD & EPIC VALIDATION SUMMARY
301
+
302
+ [[LLM: FINAL PM CHECKLIST REPORT GENERATION
303
+
304
+ Create a comprehensive validation report that includes:
305
+
306
+ 1. Executive Summary
307
+
308
+ - Overall PRD completeness (percentage)
309
+ - MVP scope appropriateness (Too Large/Just Right/Too Small)
310
+ - Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
311
+ - Most critical gaps or concerns
312
+
313
+ 2. Category Analysis Table
314
+ Fill in the actual table with:
315
+
316
+ - Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
317
+ - Critical Issues: Specific problems that block progress
318
+
319
+ 3. Top Issues by Priority
320
+
321
+ - BLOCKERS: Must fix before architect can proceed
322
+ - HIGH: Should fix for quality
323
+ - MEDIUM: Would improve clarity
324
+ - LOW: Nice to have
325
+
326
+ 4. MVP Scope Assessment
327
+
328
+ - Features that might be cut for true MVP
329
+ - Missing features that are essential
330
+ - Complexity concerns
331
+ - Timeline realism
332
+
333
+ 5. Technical Readiness
334
+
335
+ - Clarity of technical constraints
336
+ - Identified technical risks
337
+ - Areas needing architect investigation
338
+
339
+ 6. Recommendations
340
+ - Specific actions to address each blocker
341
+ - Suggested improvements
342
+ - Next steps
343
+
344
+ After presenting the report, ask if the user wants:
345
+
346
+ - Detailed analysis of any failed sections
347
+ - Suggestions for improving specific areas
348
+ - Help with refining MVP scope]]
349
+
350
+ ### Category Statuses
351
+
352
+ | Category | Status | Critical Issues |
353
+ | -------------------------------- | ------ | --------------- |
354
+ | 1. Problem Definition & Context | _TBD_ | |
355
+ | 2. MVP Scope Definition | _TBD_ | |
356
+ | 3. User Experience Requirements | _TBD_ | |
357
+ | 4. Functional Requirements | _TBD_ | |
358
+ | 5. Non-Functional Requirements | _TBD_ | |
359
+ | 6. Epic & Story Structure | _TBD_ | |
360
+ | 7. Technical Guidance | _TBD_ | |
361
+ | 8. Cross-Functional Requirements | _TBD_ | |
362
+ | 9. Clarity & Communication | _TBD_ | |
363
+
364
+ ### Critical Deficiencies
365
+
366
+ (To be populated during validation)
367
+
368
+ ### Recommendations
369
+
370
+ (To be populated during validation)
371
+
372
+ ### Final Decision
373
+
374
+ - **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
375
+ - **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
376
376