aios-core 2.1.6 → 2.2.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 (371) 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-framework.md +696 -696
  46. package/.aios-core/development/tasks/analyze-performance.md +637 -637
  47. package/.aios-core/development/tasks/apply-qa-fixes.md +340 -340
  48. package/.aios-core/development/tasks/architect-analyze-impact.md +826 -826
  49. package/.aios-core/development/tasks/audit-codebase.md +429 -429
  50. package/.aios-core/development/tasks/audit-tailwind-config.md +270 -270
  51. package/.aios-core/development/tasks/audit-utilities.md +358 -358
  52. package/.aios-core/development/tasks/bootstrap-shadcn-library.md +286 -286
  53. package/.aios-core/development/tasks/brownfield-create-epic.md +485 -485
  54. package/.aios-core/development/tasks/brownfield-create-story.md +356 -356
  55. package/.aios-core/development/tasks/build-component.md +478 -478
  56. package/.aios-core/development/tasks/calculate-roi.md +455 -455
  57. package/.aios-core/development/tasks/ci-cd-configuration.md +764 -764
  58. package/.aios-core/development/tasks/cleanup-utilities.md +670 -670
  59. package/.aios-core/development/tasks/collaborative-edit.md +1108 -1108
  60. package/.aios-core/development/tasks/compose-molecule.md +284 -284
  61. package/.aios-core/development/tasks/consolidate-patterns.md +414 -414
  62. package/.aios-core/development/tasks/correct-course.md +279 -279
  63. package/.aios-core/development/tasks/create-agent.md +321 -321
  64. package/.aios-core/development/tasks/create-brownfield-story.md +726 -726
  65. package/.aios-core/development/tasks/create-deep-research-prompt.md +498 -498
  66. package/.aios-core/development/tasks/create-doc.md +316 -316
  67. package/.aios-core/development/tasks/create-next-story.md +774 -774
  68. package/.aios-core/development/tasks/create-suite.md +283 -283
  69. package/.aios-core/development/tasks/create-task.md +371 -371
  70. package/.aios-core/development/tasks/create-workflow.md +370 -370
  71. package/.aios-core/development/tasks/db-analyze-hotpaths.md +572 -572
  72. package/.aios-core/development/tasks/db-apply-migration.md +381 -381
  73. package/.aios-core/development/tasks/db-bootstrap.md +642 -642
  74. package/.aios-core/development/tasks/db-domain-modeling.md +693 -693
  75. package/.aios-core/development/tasks/db-dry-run.md +293 -293
  76. package/.aios-core/development/tasks/db-env-check.md +260 -260
  77. package/.aios-core/development/tasks/db-expansion-pack-integration.md +663 -663
  78. package/.aios-core/development/tasks/db-explain.md +631 -631
  79. package/.aios-core/development/tasks/db-impersonate.md +495 -495
  80. package/.aios-core/development/tasks/db-load-csv.md +593 -593
  81. package/.aios-core/development/tasks/db-policy-apply.md +653 -653
  82. package/.aios-core/development/tasks/db-rls-audit.md +411 -411
  83. package/.aios-core/development/tasks/db-rollback.md +739 -739
  84. package/.aios-core/development/tasks/db-run-sql.md +613 -613
  85. package/.aios-core/development/tasks/db-schema-audit.md +1011 -1011
  86. package/.aios-core/development/tasks/db-seed.md +390 -390
  87. package/.aios-core/development/tasks/db-smoke-test.md +351 -351
  88. package/.aios-core/development/tasks/db-snapshot.md +569 -569
  89. package/.aios-core/development/tasks/db-supabase-setup.md +712 -712
  90. package/.aios-core/development/tasks/db-verify-order.md +515 -515
  91. package/.aios-core/development/tasks/deprecate-component.md +956 -956
  92. package/.aios-core/development/tasks/dev-apply-qa-fixes.md +318 -318
  93. package/.aios-core/development/tasks/dev-backlog-debt.md +469 -469
  94. package/.aios-core/development/tasks/dev-develop-story.md +846 -846
  95. package/.aios-core/development/tasks/dev-improve-code-quality.md +872 -872
  96. package/.aios-core/development/tasks/dev-optimize-performance.md +1033 -1033
  97. package/.aios-core/development/tasks/dev-suggest-refactoring.md +870 -870
  98. package/.aios-core/development/tasks/dev-validate-next-story.md +348 -348
  99. package/.aios-core/development/tasks/document-project.md +552 -552
  100. package/.aios-core/development/tasks/environment-bootstrap.md +1311 -1311
  101. package/.aios-core/development/tasks/execute-checklist.md +301 -301
  102. package/.aios-core/development/tasks/export-design-tokens-dtcg.md +274 -274
  103. package/.aios-core/development/tasks/extend-pattern.md +269 -269
  104. package/.aios-core/development/tasks/extract-tokens.md +467 -467
  105. package/.aios-core/development/tasks/facilitate-brainstorming-session.md +518 -518
  106. package/.aios-core/development/tasks/generate-ai-frontend-prompt.md +260 -260
  107. package/.aios-core/development/tasks/generate-documentation.md +284 -284
  108. package/.aios-core/development/tasks/generate-migration-strategy.md +522 -522
  109. package/.aios-core/development/tasks/generate-shock-report.md +501 -501
  110. package/.aios-core/development/tasks/github-devops-github-pr-automation.md +427 -427
  111. package/.aios-core/development/tasks/github-devops-pre-push-quality-gate.md +733 -733
  112. package/.aios-core/development/tasks/github-devops-repository-cleanup.md +374 -374
  113. package/.aios-core/development/tasks/github-devops-version-management.md +483 -483
  114. package/.aios-core/development/tasks/improve-self.md +822 -822
  115. package/.aios-core/development/tasks/index-docs.md +387 -387
  116. package/.aios-core/development/tasks/init-project-status.md +506 -506
  117. package/.aios-core/development/tasks/integrate-expansion-pack.md +314 -314
  118. package/.aios-core/development/tasks/kb-mode-interaction.md +283 -283
  119. package/.aios-core/development/tasks/learn-patterns.md +900 -900
  120. package/.aios-core/development/tasks/mcp-workflow.md +437 -437
  121. package/.aios-core/development/tasks/modify-agent.md +381 -381
  122. package/.aios-core/development/tasks/modify-task.md +424 -424
  123. package/.aios-core/development/tasks/modify-workflow.md +465 -465
  124. package/.aios-core/development/tasks/po-backlog-add.md +370 -370
  125. package/.aios-core/development/tasks/po-manage-story-backlog.md +523 -523
  126. package/.aios-core/development/tasks/po-pull-story-from-clickup.md +540 -540
  127. package/.aios-core/development/tasks/po-pull-story.md +316 -316
  128. package/.aios-core/development/tasks/po-stories-index.md +351 -351
  129. package/.aios-core/development/tasks/po-sync-story-to-clickup.md +457 -457
  130. package/.aios-core/development/tasks/po-sync-story.md +303 -303
  131. package/.aios-core/development/tasks/pr-automation.md +701 -701
  132. package/.aios-core/development/tasks/propose-modification.md +842 -842
  133. package/.aios-core/development/tasks/qa-backlog-add-followup.md +425 -425
  134. package/.aios-core/development/tasks/qa-gate.md +373 -373
  135. package/.aios-core/development/tasks/qa-generate-tests.md +1174 -1174
  136. package/.aios-core/development/tasks/qa-nfr-assess.md +557 -557
  137. package/.aios-core/development/tasks/qa-review-proposal.md +1157 -1157
  138. package/.aios-core/development/tasks/qa-review-story.md +682 -682
  139. package/.aios-core/development/tasks/qa-risk-profile.md +566 -566
  140. package/.aios-core/development/tasks/qa-run-tests.md +277 -277
  141. package/.aios-core/development/tasks/qa-test-design.md +387 -387
  142. package/.aios-core/development/tasks/qa-trace-requirements.md +476 -476
  143. package/.aios-core/development/tasks/release-management.md +723 -723
  144. package/.aios-core/development/tasks/security-audit.md +554 -554
  145. package/.aios-core/development/tasks/security-scan.md +790 -790
  146. package/.aios-core/development/tasks/setup-database.md +741 -741
  147. package/.aios-core/development/tasks/setup-design-system.md +462 -462
  148. package/.aios-core/development/tasks/setup-github.md +874 -874
  149. package/.aios-core/development/tasks/setup-llm-routing.md +1 -1
  150. package/.aios-core/development/tasks/setup-mcp-docker.md +584 -584
  151. package/.aios-core/development/tasks/setup-project-docs.md +1 -1
  152. package/.aios-core/development/tasks/shard-doc.md +537 -537
  153. package/.aios-core/development/tasks/sm-create-next-story.md +480 -480
  154. package/.aios-core/development/tasks/sync-documentation.md +864 -864
  155. package/.aios-core/development/tasks/tailwind-upgrade.md +294 -294
  156. package/.aios-core/development/tasks/test-as-user.md +621 -621
  157. package/.aios-core/development/tasks/test-validation-task.md +171 -171
  158. package/.aios-core/development/tasks/undo-last.md +346 -346
  159. package/.aios-core/development/tasks/update-manifest.md +409 -409
  160. package/.aios-core/development/tasks/ux-create-wireframe.md +617 -617
  161. package/.aios-core/development/tasks/ux-ds-scan-artifact.md +672 -672
  162. package/.aios-core/development/tasks/ux-user-research.md +559 -559
  163. package/.aios-core/development/tasks/validate-next-story.md +422 -422
  164. package/.aios-core/development/workflows/README.md +83 -83
  165. package/.aios-core/development/workflows/brownfield-fullstack.yaml +297 -297
  166. package/.aios-core/development/workflows/brownfield-service.yaml +187 -187
  167. package/.aios-core/development/workflows/brownfield-ui.yaml +197 -197
  168. package/.aios-core/development/workflows/greenfield-fullstack.yaml +333 -333
  169. package/.aios-core/development/workflows/greenfield-service.yaml +206 -206
  170. package/.aios-core/development/workflows/greenfield-ui.yaml +235 -235
  171. package/.aios-core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  172. package/.aios-core/docs/component-creation-guide.md +457 -457
  173. package/.aios-core/docs/session-update-pattern.md +307 -307
  174. package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +572 -572
  175. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md +185 -185
  176. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md +354 -354
  177. package/.aios-core/docs/standards/AIOS-FRAMEWORK-MASTER.md +1963 -1963
  178. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md +821 -821
  179. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md +1190 -1190
  180. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1.md +439 -439
  181. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md +1339 -1339
  182. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO.md +5398 -5398
  183. package/.aios-core/docs/standards/EXECUTOR-DECISION-TREE.md +697 -697
  184. package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +511 -511
  185. package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md +556 -556
  186. package/.aios-core/docs/standards/STANDARDS-INDEX.md +210 -210
  187. package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +550 -550
  188. package/.aios-core/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1414 -1414
  189. package/.aios-core/docs/standards/V3-ARCHITECTURAL-DECISIONS.md +523 -523
  190. package/.aios-core/docs/template-syntax.md +266 -266
  191. package/.aios-core/docs/troubleshooting-guide.md +624 -624
  192. package/.aios-core/index.esm.js +15 -15
  193. package/.aios-core/index.js +1 -1
  194. package/.aios-core/infrastructure/README.md +126 -126
  195. package/.aios-core/infrastructure/integrations/pm-adapters/README.md +59 -59
  196. package/.aios-core/infrastructure/scripts/approval-workflow.js +1 -1
  197. package/.aios-core/infrastructure/scripts/batch-creator.js +1 -1
  198. package/.aios-core/infrastructure/scripts/component-generator.js +3 -3
  199. package/.aios-core/infrastructure/scripts/component-metadata.js +1 -1
  200. package/.aios-core/infrastructure/scripts/component-search.js +1 -1
  201. package/.aios-core/infrastructure/scripts/coverage-analyzer.js +1 -1
  202. package/.aios-core/infrastructure/scripts/dependency-analyzer.js +1 -1
  203. package/.aios-core/infrastructure/scripts/dependency-impact-analyzer.js +1 -1
  204. package/.aios-core/infrastructure/scripts/framework-analyzer.js +1 -1
  205. package/.aios-core/infrastructure/scripts/improvement-engine.js +1 -1
  206. package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js +26 -13
  207. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -0
  208. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +108 -0
  209. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -0
  210. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +65 -0
  211. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -0
  212. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +16 -0
  213. package/.aios-core/infrastructure/scripts/llm-routing/usage-tracker/index.js +549 -0
  214. package/.aios-core/infrastructure/scripts/modification-risk-assessment.js +1 -1
  215. package/.aios-core/infrastructure/scripts/performance-analyzer.js +1 -1
  216. package/.aios-core/infrastructure/scripts/pm-adapter.js +134 -134
  217. package/.aios-core/infrastructure/scripts/repository-detector.js +3 -3
  218. package/.aios-core/infrastructure/scripts/template-engine.js +1 -1
  219. package/.aios-core/infrastructure/scripts/template-validator.js +1 -1
  220. package/.aios-core/infrastructure/scripts/test-generator.js +1 -1
  221. package/.aios-core/infrastructure/scripts/test-quality-assessment.js +1 -1
  222. package/.aios-core/infrastructure/scripts/transaction-manager.js +1 -1
  223. package/.aios-core/infrastructure/scripts/usage-analytics.js +1 -1
  224. package/.aios-core/infrastructure/scripts/visual-impact-generator.js +2 -2
  225. package/.aios-core/infrastructure/templates/github-workflows/README.md +109 -109
  226. package/.aios-core/infrastructure/tests/regression-suite-v2.md +621 -621
  227. package/.aios-core/infrastructure/tools/README.md +222 -222
  228. package/.aios-core/infrastructure/tools/cli/github-cli.yaml +200 -200
  229. package/.aios-core/infrastructure/tools/cli/railway-cli.yaml +260 -260
  230. package/.aios-core/infrastructure/tools/cli/supabase-cli.yaml +224 -224
  231. package/.aios-core/infrastructure/tools/local/ffmpeg.yaml +261 -261
  232. package/.aios-core/infrastructure/tools/mcp/21st-dev-magic.yaml +127 -127
  233. package/.aios-core/infrastructure/tools/mcp/browser.yaml +103 -103
  234. package/.aios-core/infrastructure/tools/mcp/clickup.yaml +534 -534
  235. package/.aios-core/infrastructure/tools/mcp/context7.yaml +78 -78
  236. package/.aios-core/infrastructure/tools/mcp/desktop-commander.yaml +180 -180
  237. package/.aios-core/infrastructure/tools/mcp/exa.yaml +103 -103
  238. package/.aios-core/infrastructure/tools/mcp/google-workspace.yaml +930 -930
  239. package/.aios-core/infrastructure/tools/mcp/n8n.yaml +551 -551
  240. package/.aios-core/infrastructure/tools/mcp/supabase.yaml +808 -808
  241. package/.aios-core/install-manifest.yaml +347 -347
  242. package/.aios-core/product/README.md +56 -56
  243. package/.aios-core/product/checklists/accessibility-wcag-checklist.md +80 -0
  244. package/.aios-core/product/checklists/architect-checklist.md +443 -443
  245. package/.aios-core/product/checklists/change-checklist.md +182 -182
  246. package/.aios-core/product/checklists/component-quality-checklist.md +74 -0
  247. package/.aios-core/product/checklists/database-design-checklist.md +119 -119
  248. package/.aios-core/product/checklists/dba-predeploy-checklist.md +97 -97
  249. package/.aios-core/product/checklists/dba-rollback-checklist.md +99 -99
  250. package/.aios-core/product/checklists/migration-readiness-checklist.md +75 -0
  251. package/.aios-core/product/checklists/pattern-audit-checklist.md +88 -0
  252. package/.aios-core/product/checklists/pm-checklist.md +375 -375
  253. package/.aios-core/product/checklists/po-master-checklist.md +441 -441
  254. package/.aios-core/product/checklists/pre-push-checklist.md +108 -108
  255. package/.aios-core/product/checklists/release-checklist.md +122 -122
  256. package/.aios-core/product/checklists/story-dod-checklist.md +101 -101
  257. package/.aios-core/product/checklists/story-draft-checklist.md +215 -215
  258. package/.aios-core/product/data/atomic-design-principles.md +108 -0
  259. package/.aios-core/product/data/brainstorming-techniques.md +36 -36
  260. package/.aios-core/product/data/consolidation-algorithms.md +142 -0
  261. package/.aios-core/product/data/database-best-practices.md +182 -0
  262. package/.aios-core/product/data/design-token-best-practices.md +107 -0
  263. package/.aios-core/product/data/elicitation-methods.md +134 -134
  264. package/.aios-core/product/data/integration-patterns.md +207 -0
  265. package/.aios-core/product/data/migration-safety-guide.md +329 -0
  266. package/.aios-core/product/data/mode-selection-best-practices.md +471 -471
  267. package/.aios-core/product/data/postgres-tuning-guide.md +300 -0
  268. package/.aios-core/product/data/rls-security-patterns.md +333 -0
  269. package/.aios-core/product/data/roi-calculation-guide.md +142 -0
  270. package/.aios-core/product/data/supabase-patterns.md +330 -0
  271. package/.aios-core/product/data/test-levels-framework.md +148 -148
  272. package/.aios-core/product/data/test-priorities-matrix.md +174 -174
  273. package/.aios-core/product/data/wcag-compliance-guide.md +267 -0
  274. package/.aios-core/product/templates/1mcp-config.yaml +225 -225
  275. package/.aios-core/product/templates/activation-instructions-inline-greeting.yaml +63 -63
  276. package/.aios-core/product/templates/activation-instructions-template.md +258 -258
  277. package/.aios-core/product/templates/agent-template.yaml +120 -120
  278. package/.aios-core/product/templates/architecture-tmpl.yaml +650 -650
  279. package/.aios-core/product/templates/brainstorming-output-tmpl.yaml +155 -155
  280. package/.aios-core/product/templates/brownfield-architecture-tmpl.yaml +475 -475
  281. package/.aios-core/product/templates/brownfield-prd-tmpl.yaml +279 -279
  282. package/.aios-core/product/templates/changelog-template.md +134 -134
  283. package/.aios-core/product/templates/command-rationalization-matrix.md +152 -152
  284. package/.aios-core/product/templates/competitor-analysis-tmpl.yaml +292 -292
  285. package/.aios-core/product/templates/design-story-tmpl.yaml +587 -587
  286. package/.aios-core/product/templates/ds-artifact-analysis.md +70 -70
  287. package/.aios-core/product/templates/front-end-architecture-tmpl.yaml +205 -205
  288. package/.aios-core/product/templates/front-end-spec-tmpl.yaml +348 -348
  289. package/.aios-core/product/templates/fullstack-architecture-tmpl.yaml +804 -804
  290. package/.aios-core/product/templates/github-pr-template.md +67 -67
  291. package/.aios-core/product/templates/gordon-mcp.yaml +140 -140
  292. package/.aios-core/product/templates/ide-rules/antigravity-rules.md +115 -115
  293. package/.aios-core/product/templates/ide-rules/claude-rules.md +221 -221
  294. package/.aios-core/product/templates/ide-rules/cline-rules.md +84 -84
  295. package/.aios-core/product/templates/ide-rules/copilot-rules.md +92 -92
  296. package/.aios-core/product/templates/ide-rules/cursor-rules.md +115 -115
  297. package/.aios-core/product/templates/ide-rules/gemini-rules.md +85 -85
  298. package/.aios-core/product/templates/ide-rules/roo-rules.md +86 -86
  299. package/.aios-core/product/templates/ide-rules/trae-rules.md +104 -104
  300. package/.aios-core/product/templates/ide-rules/windsurf-rules.md +80 -80
  301. package/.aios-core/product/templates/index-strategy-tmpl.yaml +53 -53
  302. package/.aios-core/product/templates/market-research-tmpl.yaml +251 -251
  303. package/.aios-core/product/templates/mcp-workflow.js +271 -271
  304. package/.aios-core/product/templates/migration-plan-tmpl.yaml +1022 -1022
  305. package/.aios-core/product/templates/migration-strategy-tmpl.md +524 -524
  306. package/.aios-core/product/templates/personalized-agent-template.md +258 -258
  307. package/.aios-core/product/templates/personalized-checklist-template.md +340 -340
  308. package/.aios-core/product/templates/personalized-task-template-v2.md +905 -905
  309. package/.aios-core/product/templates/personalized-task-template.md +344 -344
  310. package/.aios-core/product/templates/personalized-template-file.yaml +322 -322
  311. package/.aios-core/product/templates/personalized-workflow-template.yaml +460 -460
  312. package/.aios-core/product/templates/prd-tmpl.yaml +201 -201
  313. package/.aios-core/product/templates/project-brief-tmpl.yaml +220 -220
  314. package/.aios-core/product/templates/qa-gate-tmpl.yaml +240 -240
  315. package/.aios-core/product/templates/rls-policies-tmpl.yaml +1203 -1203
  316. package/.aios-core/product/templates/schema-design-tmpl.yaml +428 -428
  317. package/.aios-core/product/templates/state-persistence-tmpl.yaml +219 -219
  318. package/.aios-core/product/templates/story-tmpl.yaml +331 -331
  319. package/.aios-core/product/templates/task-execution-report.md +495 -495
  320. package/.aios-core/product/templates/task-template.md +122 -122
  321. package/.aios-core/product/templates/token-exports-tailwind-tmpl.js +395 -395
  322. package/.aios-core/product/templates/tokens-schema-tmpl.yaml +305 -305
  323. package/.aios-core/product/templates/workflow-template.yaml +133 -133
  324. package/.aios-core/scripts/README.md +354 -354
  325. package/.aios-core/scripts/aios-doc-template.md +325 -325
  326. package/.aios-core/scripts/elicitation-engine.js +1 -1
  327. package/.aios-core/scripts/test-template-system.js +1 -1
  328. package/.aios-core/scripts/workflow-management.md +69 -69
  329. package/.aios-core/user-guide.md +1413 -1413
  330. package/.aios-core/working-in-the-brownfield.md +361 -361
  331. package/LICENSE +1 -1
  332. package/README.md +704 -703
  333. package/bin/aios-init-old.js +3 -3
  334. package/bin/aios-init-v4.js +1 -1
  335. package/bin/aios-init.backup-v1.1.4.js +1 -1
  336. package/bin/aios-init.js +3 -3
  337. package/bin/aios.js +279 -279
  338. package/bin/utils/install-errors.js +339 -339
  339. package/bin/utils/install-transaction.js +445 -445
  340. package/index.d.ts +18 -18
  341. package/index.esm.js +20 -20
  342. package/index.js +6 -6
  343. package/package.json +8 -11
  344. package/packages/installer/src/config/templates/env-template.js +27 -4
  345. package/packages/installer/src/detection/detect-project-type.js +81 -81
  346. package/packages/installer/tests/integration/wizard-detection.test.js +8 -6
  347. package/packages/installer/tests/unit/env-template.test.js +8 -8
  348. package/src/config/ide-configs.js +1 -1
  349. package/src/wizard/feedback.js +2 -2
  350. package/src/wizard/index.js +1 -1
  351. package/src/wizard/validation/report-generator.js +1 -1
  352. package/src/wizard/validation/troubleshooting-system.js +13 -13
  353. package/tools/diagnose-installation.js +266 -0
  354. package/tools/diagnose-npx-issue.ps1 +96 -0
  355. package/tools/quick-diagnose.cmd +85 -0
  356. package/tools/quick-diagnose.ps1 +117 -0
  357. package/.aios-core/infrastructure/scripts/_archived/final-todo-count.js +0 -122
  358. package/.aios-core/infrastructure/scripts/_archived/fix-yaml-formatting.js +0 -89
  359. package/.aios-core/infrastructure/scripts/_archived/migration-generator.js +0 -780
  360. package/.aios-core/infrastructure/scripts/_archived/migration-path-generator.js +0 -950
  361. package/.aios-core/infrastructure/scripts/_archived/phase2-entrada-saida-errors.js +0 -425
  362. package/.aios-core/infrastructure/scripts/_archived/phase2-spot-check.js +0 -132
  363. package/.aios-core/infrastructure/scripts/_archived/phase3-tools-scripts-validation.js +0 -381
  364. package/.aios-core/infrastructure/scripts/_archived/phase4-metadata-performance.js +0 -203
  365. package/.aios-core/infrastructure/scripts/_archived/test-yaml-parsing.js +0 -24
  366. package/.aios-core/infrastructure/scripts/_archived/verify-yaml-fix.js +0 -51
  367. package/.aios-core/tasks/find-component.md.legacy +0 -391
  368. package/.aios-core/tasks/generate-commit-message.md.legacy +0 -426
  369. package/.aios-core/tasks/generate-migration.md.legacy +0 -382
  370. package/.aios-core/tasks/rollback-modification.md.legacy +0 -307
  371. package/.aios-core/tasks/update-tests.md.legacy +0 -283
@@ -1,108 +1,108 @@
1
- # Pre-Push Quality Gate Checklist
2
-
3
- ## Instructions for DevOps Agent
4
-
5
- Before pushing code to the remote repository, go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
-
7
- [[LLM: INITIALIZATION INSTRUCTIONS - PRE-PUSH VALIDATION
8
-
9
- This checklist is for DEVOPS AGENTS validating code before pushing to remote.
10
-
11
- IMPORTANT: Pushing broken code affects the entire team. This checklist ensures quality.
12
-
13
- EXECUTION APPROACH:
14
-
15
- 1. Run all automated checks first
16
- 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
- 3. Add comments for any failures or concerns
18
- 4. Block push if any critical items fail
19
- 5. Get user confirmation before pushing
20
-
21
- Quality gates protect everyone.]]
22
-
23
- ## Checklist Items
24
-
25
- 1. **Code Quality:**
26
-
27
- [[LLM: Code must pass all quality checks]]
28
-
29
- - [ ] `npm run lint` passes with no errors
30
- - [ ] `npm run typecheck` passes (if TypeScript)
31
- - [ ] `npm run build` completes successfully
32
- - [ ] No console.log or debugging statements in production code
33
- - [ ] No commented-out code blocks
34
-
35
- 2. **Testing:**
36
-
37
- [[LLM: Tests prove the code works]]
38
-
39
- - [ ] `npm test` passes with all tests green
40
- - [ ] No skipped tests without documented reason
41
- - [ ] Test coverage meets project standards
42
- - [ ] New features have corresponding tests
43
- - [ ] No flaky tests introduced
44
-
45
- 3. **Security:**
46
-
47
- [[LLM: Security vulnerabilities must be caught before push]]
48
-
49
- - [ ] No hardcoded credentials or secrets
50
- - [ ] No API keys or tokens in code
51
- - [ ] `.env` files not staged for commit
52
- - [ ] `npm audit` shows no high/critical vulnerabilities
53
- - [ ] No sensitive data in logs or error messages
54
-
55
- 4. **CodeRabbit Review:**
56
-
57
- [[LLM: Automated code review catches issues humans miss]]
58
-
59
- - [ ] CodeRabbit review executed (if available)
60
- - [ ] No CRITICAL issues identified
61
- - [ ] HIGH issues addressed or documented
62
- - [ ] Security concerns resolved
63
- - [ ] Performance issues noted
64
-
65
- 5. **Git State:**
66
-
67
- [[LLM: Clean git state prevents merge problems]]
68
-
69
- - [ ] Working directory is clean (no uncommitted changes)
70
- - [ ] All intended changes are committed
71
- - [ ] Commit messages follow conventional commits format
72
- - [ ] No merge conflicts pending
73
- - [ ] Branch is up to date with target branch
74
-
75
- 6. **Story Compliance:**
76
-
77
- [[LLM: Code should match story requirements]]
78
-
79
- - [ ] All story acceptance criteria met
80
- - [ ] Story status is "Ready for Review" or "Done"
81
- - [ ] File List in story is complete
82
- - [ ] No scope creep (only story-related changes)
83
- - [ ] Story checkboxes updated
84
-
85
- 7. **Documentation:**
86
-
87
- [[LLM: Changes should be documented]]
88
-
89
- - [ ] README updated if needed
90
- - [ ] API documentation updated if endpoints changed
91
- - [ ] Breaking changes documented
92
- - [ ] Changelog entry prepared (if release)
93
-
94
- ## Final Confirmation
95
-
96
- [[LLM: FINAL PRE-PUSH SUMMARY
97
-
98
- After completing the checklist:
99
-
100
- 1. Summarize what is being pushed
101
- 2. List any items marked as [ ] Not Done with explanations
102
- 3. Confirm all critical gates pass
103
- 4. Note any concerns for reviewers
104
- 5. Get user approval before executing push
105
-
106
- Only push when confident in quality.]]
107
-
108
- - [ ] I, the DevOps Agent, confirm that all quality gates have passed and the code is safe to push to remote.
1
+ # Pre-Push Quality Gate Checklist
2
+
3
+ ## Instructions for DevOps Agent
4
+
5
+ Before pushing code to the remote repository, go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
+
7
+ [[LLM: INITIALIZATION INSTRUCTIONS - PRE-PUSH VALIDATION
8
+
9
+ This checklist is for DEVOPS AGENTS validating code before pushing to remote.
10
+
11
+ IMPORTANT: Pushing broken code affects the entire team. This checklist ensures quality.
12
+
13
+ EXECUTION APPROACH:
14
+
15
+ 1. Run all automated checks first
16
+ 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
+ 3. Add comments for any failures or concerns
18
+ 4. Block push if any critical items fail
19
+ 5. Get user confirmation before pushing
20
+
21
+ Quality gates protect everyone.]]
22
+
23
+ ## Checklist Items
24
+
25
+ 1. **Code Quality:**
26
+
27
+ [[LLM: Code must pass all quality checks]]
28
+
29
+ - [ ] `npm run lint` passes with no errors
30
+ - [ ] `npm run typecheck` passes (if TypeScript)
31
+ - [ ] `npm run build` completes successfully
32
+ - [ ] No console.log or debugging statements in production code
33
+ - [ ] No commented-out code blocks
34
+
35
+ 2. **Testing:**
36
+
37
+ [[LLM: Tests prove the code works]]
38
+
39
+ - [ ] `npm test` passes with all tests green
40
+ - [ ] No skipped tests without documented reason
41
+ - [ ] Test coverage meets project standards
42
+ - [ ] New features have corresponding tests
43
+ - [ ] No flaky tests introduced
44
+
45
+ 3. **Security:**
46
+
47
+ [[LLM: Security vulnerabilities must be caught before push]]
48
+
49
+ - [ ] No hardcoded credentials or secrets
50
+ - [ ] No API keys or tokens in code
51
+ - [ ] `.env` files not staged for commit
52
+ - [ ] `npm audit` shows no high/critical vulnerabilities
53
+ - [ ] No sensitive data in logs or error messages
54
+
55
+ 4. **CodeRabbit Review:**
56
+
57
+ [[LLM: Automated code review catches issues humans miss]]
58
+
59
+ - [ ] CodeRabbit review executed (if available)
60
+ - [ ] No CRITICAL issues identified
61
+ - [ ] HIGH issues addressed or documented
62
+ - [ ] Security concerns resolved
63
+ - [ ] Performance issues noted
64
+
65
+ 5. **Git State:**
66
+
67
+ [[LLM: Clean git state prevents merge problems]]
68
+
69
+ - [ ] Working directory is clean (no uncommitted changes)
70
+ - [ ] All intended changes are committed
71
+ - [ ] Commit messages follow conventional commits format
72
+ - [ ] No merge conflicts pending
73
+ - [ ] Branch is up to date with target branch
74
+
75
+ 6. **Story Compliance:**
76
+
77
+ [[LLM: Code should match story requirements]]
78
+
79
+ - [ ] All story acceptance criteria met
80
+ - [ ] Story status is "Ready for Review" or "Done"
81
+ - [ ] File List in story is complete
82
+ - [ ] No scope creep (only story-related changes)
83
+ - [ ] Story checkboxes updated
84
+
85
+ 7. **Documentation:**
86
+
87
+ [[LLM: Changes should be documented]]
88
+
89
+ - [ ] README updated if needed
90
+ - [ ] API documentation updated if endpoints changed
91
+ - [ ] Breaking changes documented
92
+ - [ ] Changelog entry prepared (if release)
93
+
94
+ ## Final Confirmation
95
+
96
+ [[LLM: FINAL PRE-PUSH SUMMARY
97
+
98
+ After completing the checklist:
99
+
100
+ 1. Summarize what is being pushed
101
+ 2. List any items marked as [ ] Not Done with explanations
102
+ 3. Confirm all critical gates pass
103
+ 4. Note any concerns for reviewers
104
+ 5. Get user approval before executing push
105
+
106
+ Only push when confident in quality.]]
107
+
108
+ - [ ] I, the DevOps Agent, confirm that all quality gates have passed and the code is safe to push to remote.
@@ -1,122 +1,122 @@
1
- # Release Checklist
2
-
3
- ## Instructions for DevOps Agent
4
-
5
- Before creating a release, go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
-
7
- [[LLM: INITIALIZATION INSTRUCTIONS - RELEASE VALIDATION
8
-
9
- This checklist is for DEVOPS AGENTS preparing releases.
10
-
11
- IMPORTANT: Releases are public milestones. This checklist ensures release quality.
12
-
13
- EXECUTION APPROACH:
14
-
15
- 1. Complete all pre-release tasks
16
- 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
- 3. Add comments for any incomplete items
18
- 4. Get stakeholder approval before release
19
- 5. Follow semantic versioning strictly
20
-
21
- Releases represent commitment to quality.]]
22
-
23
- ## Checklist Items
24
-
25
- 1. **Version Management:**
26
-
27
- [[LLM: Version numbers communicate change significance]]
28
-
29
- - [ ] Version number follows semantic versioning (MAJOR.MINOR.PATCH)
30
- - [ ] Version bump type is appropriate for changes:
31
- - MAJOR: Breaking changes
32
- - MINOR: New features (backward compatible)
33
- - PATCH: Bug fixes only
34
- - [ ] Version updated in package.json
35
- - [ ] Version updated in all relevant files
36
- - [ ] Git tag prepared with v prefix (e.g., v4.32.0)
37
-
38
- 2. **Quality Gates:**
39
-
40
- [[LLM: All quality checks must pass before release]]
41
-
42
- - [ ] All pre-push checklist items completed
43
- - [ ] All tests pass on release branch
44
- - [ ] Build succeeds for all target environments
45
- - [ ] CodeRabbit review completed with no CRITICAL issues
46
- - [ ] No known blocking bugs
47
-
48
- 3. **Changelog:**
49
-
50
- [[LLM: Changelog communicates what changed to users]]
51
-
52
- - [ ] CHANGELOG.md updated with new version section
53
- - [ ] All significant changes documented
54
- - [ ] Breaking changes clearly marked
55
- - [ ] Contributors credited (if applicable)
56
- - [ ] Date of release included
57
-
58
- 4. **Documentation:**
59
-
60
- [[LLM: Users need updated documentation]]
61
-
62
- - [ ] README reflects current state
63
- - [ ] Installation instructions verified
64
- - [ ] API documentation current
65
- - [ ] Migration guide written (if breaking changes)
66
- - [ ] Known issues documented
67
-
68
- 5. **Pre-Release Testing:**
69
-
70
- [[LLM: Final verification before going public]]
71
-
72
- - [ ] Release candidate tested in staging environment
73
- - [ ] Critical user flows verified
74
- - [ ] Upgrade path tested (from previous version)
75
- - [ ] Fresh installation tested
76
- - [ ] Smoke tests passed
77
-
78
- 6. **Communication:**
79
-
80
- [[LLM: Stakeholders need to know about releases]]
81
-
82
- - [ ] Release notes prepared for GitHub
83
- - [ ] Team notified of pending release
84
- - [ ] Users notified of breaking changes (if any)
85
- - [ ] Support team briefed on changes
86
- - [ ] Marketing notified (if significant release)
87
-
88
- 7. **Rollback Plan:**
89
-
90
- [[LLM: Always have a way back]]
91
-
92
- - [ ] Previous version tagged and accessible
93
- - [ ] Rollback procedure documented
94
- - [ ] Database rollback scripts ready (if applicable)
95
- - [ ] Monitoring in place to detect issues
96
- - [ ] On-call support available post-release
97
-
98
- 8. **Release Execution:**
99
-
100
- [[LLM: Execute release carefully]]
101
-
102
- - [ ] All commits included in release
103
- - [ ] Tag created and pushed
104
- - [ ] GitHub release created with notes
105
- - [ ] npm publish executed (if npm package)
106
- - [ ] Release artifacts verified
107
-
108
- ## Final Confirmation
109
-
110
- [[LLM: FINAL RELEASE SUMMARY
111
-
112
- After completing the checklist:
113
-
114
- 1. Summarize what is in this release
115
- 2. List version number and release type
116
- 3. Document any known issues or limitations
117
- 4. Confirm stakeholder approval received
118
- 5. Confirm readiness to execute release
119
-
120
- Releases are public commitments to quality.]]
121
-
122
- - [ ] I, the DevOps Agent, confirm that all release criteria have been met and the release is ready to proceed.
1
+ # Release Checklist
2
+
3
+ ## Instructions for DevOps Agent
4
+
5
+ Before creating a release, go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
+
7
+ [[LLM: INITIALIZATION INSTRUCTIONS - RELEASE VALIDATION
8
+
9
+ This checklist is for DEVOPS AGENTS preparing releases.
10
+
11
+ IMPORTANT: Releases are public milestones. This checklist ensures release quality.
12
+
13
+ EXECUTION APPROACH:
14
+
15
+ 1. Complete all pre-release tasks
16
+ 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
+ 3. Add comments for any incomplete items
18
+ 4. Get stakeholder approval before release
19
+ 5. Follow semantic versioning strictly
20
+
21
+ Releases represent commitment to quality.]]
22
+
23
+ ## Checklist Items
24
+
25
+ 1. **Version Management:**
26
+
27
+ [[LLM: Version numbers communicate change significance]]
28
+
29
+ - [ ] Version number follows semantic versioning (MAJOR.MINOR.PATCH)
30
+ - [ ] Version bump type is appropriate for changes:
31
+ - MAJOR: Breaking changes
32
+ - MINOR: New features (backward compatible)
33
+ - PATCH: Bug fixes only
34
+ - [ ] Version updated in package.json
35
+ - [ ] Version updated in all relevant files
36
+ - [ ] Git tag prepared with v prefix (e.g., v4.32.0)
37
+
38
+ 2. **Quality Gates:**
39
+
40
+ [[LLM: All quality checks must pass before release]]
41
+
42
+ - [ ] All pre-push checklist items completed
43
+ - [ ] All tests pass on release branch
44
+ - [ ] Build succeeds for all target environments
45
+ - [ ] CodeRabbit review completed with no CRITICAL issues
46
+ - [ ] No known blocking bugs
47
+
48
+ 3. **Changelog:**
49
+
50
+ [[LLM: Changelog communicates what changed to users]]
51
+
52
+ - [ ] CHANGELOG.md updated with new version section
53
+ - [ ] All significant changes documented
54
+ - [ ] Breaking changes clearly marked
55
+ - [ ] Contributors credited (if applicable)
56
+ - [ ] Date of release included
57
+
58
+ 4. **Documentation:**
59
+
60
+ [[LLM: Users need updated documentation]]
61
+
62
+ - [ ] README reflects current state
63
+ - [ ] Installation instructions verified
64
+ - [ ] API documentation current
65
+ - [ ] Migration guide written (if breaking changes)
66
+ - [ ] Known issues documented
67
+
68
+ 5. **Pre-Release Testing:**
69
+
70
+ [[LLM: Final verification before going public]]
71
+
72
+ - [ ] Release candidate tested in staging environment
73
+ - [ ] Critical user flows verified
74
+ - [ ] Upgrade path tested (from previous version)
75
+ - [ ] Fresh installation tested
76
+ - [ ] Smoke tests passed
77
+
78
+ 6. **Communication:**
79
+
80
+ [[LLM: Stakeholders need to know about releases]]
81
+
82
+ - [ ] Release notes prepared for GitHub
83
+ - [ ] Team notified of pending release
84
+ - [ ] Users notified of breaking changes (if any)
85
+ - [ ] Support team briefed on changes
86
+ - [ ] Marketing notified (if significant release)
87
+
88
+ 7. **Rollback Plan:**
89
+
90
+ [[LLM: Always have a way back]]
91
+
92
+ - [ ] Previous version tagged and accessible
93
+ - [ ] Rollback procedure documented
94
+ - [ ] Database rollback scripts ready (if applicable)
95
+ - [ ] Monitoring in place to detect issues
96
+ - [ ] On-call support available post-release
97
+
98
+ 8. **Release Execution:**
99
+
100
+ [[LLM: Execute release carefully]]
101
+
102
+ - [ ] All commits included in release
103
+ - [ ] Tag created and pushed
104
+ - [ ] GitHub release created with notes
105
+ - [ ] npm publish executed (if npm package)
106
+ - [ ] Release artifacts verified
107
+
108
+ ## Final Confirmation
109
+
110
+ [[LLM: FINAL RELEASE SUMMARY
111
+
112
+ After completing the checklist:
113
+
114
+ 1. Summarize what is in this release
115
+ 2. List version number and release type
116
+ 3. Document any known issues or limitations
117
+ 4. Confirm stakeholder approval received
118
+ 5. Confirm readiness to execute release
119
+
120
+ Releases are public commitments to quality.]]
121
+
122
+ - [ ] I, the DevOps Agent, confirm that all release criteria have been met and the release is ready to proceed.
@@ -1,102 +1,102 @@
1
- # Story Definition of Done (DoD) Checklist
2
-
3
- ## Instructions for Developer Agent
4
-
5
- Before marking a story as 'Review', please go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
-
7
- [[LLM: INITIALIZATION INSTRUCTIONS - STORY DOD VALIDATION
8
-
9
- This checklist is for DEVELOPER AGENTS to self-validate their work before marking a story complete.
10
-
11
- IMPORTANT: This is a self-assessment. Be honest about what's actually done vs what should be done. It's better to identify issues now than have them found in review.
12
-
13
- EXECUTION APPROACH:
14
-
15
- 1. Go through each section systematically
16
- 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
- 3. Add brief comments explaining any [ ] or [N/A] items
18
- 4. Be specific about what was actually implemented
19
- 5. Flag any concerns or technical debt created
20
-
21
- The goal is quality delivery, not just checking boxes.]]
22
-
23
- ## Checklist Items
24
-
25
- 1. **Requirements Met:**
26
-
27
- [[LLM: Be specific - list each requirement and whether it's complete]]
28
-
29
- - [ ] All functional requirements specified in the story are implemented.
30
- - [ ] All acceptance criteria defined in the story are met.
31
-
32
- 2. **Coding Standards & Project Structure:**
33
-
34
- [[LLM: Code quality matters for maintainability. Check each item carefully]]
35
-
36
- - [ ] All new/modified code strictly adheres to `Operational Guidelines`.
37
- - [ ] All new/modified code aligns with `Project Structure` (file locations, naming, etc.).
38
- - [ ] Adherence to `Tech Stack` for technologies/versions used (if story introduces or modifies tech usage).
39
- - [ ] Adherence to `Api Reference` and `Data Models` (if story involves API or data model changes).
40
- - [ ] Basic security best practices (e.g., input validation, proper error handling, no hardcoded secrets) applied for new/modified code.
41
- - [ ] No new linter errors or warnings introduced.
42
- - [ ] Code is well-commented where necessary (clarifying complex logic, not obvious statements).
43
-
44
- 3. **Testing:**
45
-
46
- [[LLM: Testing proves your code works. Be honest about test coverage]]
47
-
48
- - [ ] All required unit tests as per the story and `Operational Guidelines` Testing Strategy are implemented.
49
- - [ ] All required integration tests (if applicable) as per the story and `Operational Guidelines` Testing Strategy are implemented.
50
- - [ ] All tests (unit, integration, E2E if applicable) pass successfully.
51
- - [ ] Test coverage meets project standards (if defined).
52
-
53
- 4. **Functionality & Verification:**
54
-
55
- [[LLM: Did you actually run and test your code? Be specific about what you tested]]
56
-
57
- - [ ] Functionality has been manually verified by the developer (e.g., running the app locally, checking UI, testing API endpoints).
58
- - [ ] Edge cases and potential error conditions considered and handled gracefully.
59
-
60
- 5. **Story Administration:**
61
-
62
- [[LLM: Documentation helps the next developer. What should they know?]]
63
-
64
- - [ ] All tasks within the story file are marked as complete.
65
- - [ ] Any clarifications or decisions made during development are documented in the story file or linked appropriately.
66
- - [ ] The story wrap up section has been completed with notes of changes or information relevant to the next story or overall project, the agent model that was primarily used during development, and the changelog of any changes is properly updated.
67
-
68
- 6. **Dependencies, Build & Configuration:**
69
-
70
- [[LLM: Build issues block everyone. Ensure everything compiles and runs cleanly]]
71
-
72
- - [ ] Project builds successfully without errors.
73
- - [ ] Project linting passes
74
- - [ ] Any new dependencies added were either pre-approved in the story requirements OR explicitly approved by the user during development (approval documented in story file).
75
- - [ ] If new dependencies were added, they are recorded in the appropriate project files (e.g., `package.json`, `requirements.txt`) with justification.
76
- - [ ] No known security vulnerabilities introduced by newly added and approved dependencies.
77
- - [ ] If new environment variables or configurations were introduced by the story, they are documented and handled securely.
78
-
79
- 7. **Documentation (If Applicable):**
80
-
81
- [[LLM: Good documentation prevents future confusion. What needs explaining?]]
82
-
83
- - [ ] Relevant inline code documentation (e.g., JSDoc, TSDoc, Python docstrings) for new public APIs or complex logic is complete.
84
- - [ ] User-facing documentation updated, if changes impact users.
85
- - [ ] Technical documentation (e.g., READMEs, system diagrams) updated if significant architectural changes were made.
86
-
87
- ## Final Confirmation
88
-
89
- [[LLM: FINAL DOD SUMMARY
90
-
91
- After completing the checklist:
92
-
93
- 1. Summarize what was accomplished in this story
94
- 2. List any items marked as [ ] Not Done with explanations
95
- 3. Identify any technical debt or follow-up work needed
96
- 4. Note any challenges or learnings for future stories
97
- 5. Confirm whether the story is truly ready for review
98
-
99
- Be honest - it's better to flag issues now than have them discovered later.]]
100
-
101
- - [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
1
+ # Story Definition of Done (DoD) Checklist
2
+
3
+ ## Instructions for Developer Agent
4
+
5
+ Before marking a story as 'Review', please go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
6
+
7
+ [[LLM: INITIALIZATION INSTRUCTIONS - STORY DOD VALIDATION
8
+
9
+ This checklist is for DEVELOPER AGENTS to self-validate their work before marking a story complete.
10
+
11
+ IMPORTANT: This is a self-assessment. Be honest about what's actually done vs what should be done. It's better to identify issues now than have them found in review.
12
+
13
+ EXECUTION APPROACH:
14
+
15
+ 1. Go through each section systematically
16
+ 2. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
17
+ 3. Add brief comments explaining any [ ] or [N/A] items
18
+ 4. Be specific about what was actually implemented
19
+ 5. Flag any concerns or technical debt created
20
+
21
+ The goal is quality delivery, not just checking boxes.]]
22
+
23
+ ## Checklist Items
24
+
25
+ 1. **Requirements Met:**
26
+
27
+ [[LLM: Be specific - list each requirement and whether it's complete]]
28
+
29
+ - [ ] All functional requirements specified in the story are implemented.
30
+ - [ ] All acceptance criteria defined in the story are met.
31
+
32
+ 2. **Coding Standards & Project Structure:**
33
+
34
+ [[LLM: Code quality matters for maintainability. Check each item carefully]]
35
+
36
+ - [ ] All new/modified code strictly adheres to `Operational Guidelines`.
37
+ - [ ] All new/modified code aligns with `Project Structure` (file locations, naming, etc.).
38
+ - [ ] Adherence to `Tech Stack` for technologies/versions used (if story introduces or modifies tech usage).
39
+ - [ ] Adherence to `Api Reference` and `Data Models` (if story involves API or data model changes).
40
+ - [ ] Basic security best practices (e.g., input validation, proper error handling, no hardcoded secrets) applied for new/modified code.
41
+ - [ ] No new linter errors or warnings introduced.
42
+ - [ ] Code is well-commented where necessary (clarifying complex logic, not obvious statements).
43
+
44
+ 3. **Testing:**
45
+
46
+ [[LLM: Testing proves your code works. Be honest about test coverage]]
47
+
48
+ - [ ] All required unit tests as per the story and `Operational Guidelines` Testing Strategy are implemented.
49
+ - [ ] All required integration tests (if applicable) as per the story and `Operational Guidelines` Testing Strategy are implemented.
50
+ - [ ] All tests (unit, integration, E2E if applicable) pass successfully.
51
+ - [ ] Test coverage meets project standards (if defined).
52
+
53
+ 4. **Functionality & Verification:**
54
+
55
+ [[LLM: Did you actually run and test your code? Be specific about what you tested]]
56
+
57
+ - [ ] Functionality has been manually verified by the developer (e.g., running the app locally, checking UI, testing API endpoints).
58
+ - [ ] Edge cases and potential error conditions considered and handled gracefully.
59
+
60
+ 5. **Story Administration:**
61
+
62
+ [[LLM: Documentation helps the next developer. What should they know?]]
63
+
64
+ - [ ] All tasks within the story file are marked as complete.
65
+ - [ ] Any clarifications or decisions made during development are documented in the story file or linked appropriately.
66
+ - [ ] The story wrap up section has been completed with notes of changes or information relevant to the next story or overall project, the agent model that was primarily used during development, and the changelog of any changes is properly updated.
67
+
68
+ 6. **Dependencies, Build & Configuration:**
69
+
70
+ [[LLM: Build issues block everyone. Ensure everything compiles and runs cleanly]]
71
+
72
+ - [ ] Project builds successfully without errors.
73
+ - [ ] Project linting passes
74
+ - [ ] Any new dependencies added were either pre-approved in the story requirements OR explicitly approved by the user during development (approval documented in story file).
75
+ - [ ] If new dependencies were added, they are recorded in the appropriate project files (e.g., `package.json`, `requirements.txt`) with justification.
76
+ - [ ] No known security vulnerabilities introduced by newly added and approved dependencies.
77
+ - [ ] If new environment variables or configurations were introduced by the story, they are documented and handled securely.
78
+
79
+ 7. **Documentation (If Applicable):**
80
+
81
+ [[LLM: Good documentation prevents future confusion. What needs explaining?]]
82
+
83
+ - [ ] Relevant inline code documentation (e.g., JSDoc, TSDoc, Python docstrings) for new public APIs or complex logic is complete.
84
+ - [ ] User-facing documentation updated, if changes impact users.
85
+ - [ ] Technical documentation (e.g., READMEs, system diagrams) updated if significant architectural changes were made.
86
+
87
+ ## Final Confirmation
88
+
89
+ [[LLM: FINAL DOD SUMMARY
90
+
91
+ After completing the checklist:
92
+
93
+ 1. Summarize what was accomplished in this story
94
+ 2. List any items marked as [ ] Not Done with explanations
95
+ 3. Identify any technical debt or follow-up work needed
96
+ 4. Note any challenges or learnings for future stories
97
+ 5. Confirm whether the story is truly ready for review
98
+
99
+ Be honest - it's better to flag issues now than have them discovered later.]]
100
+
101
+ - [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
102
102