aios-core 2.1.6 → 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 (367) 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 +702 -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 -10
  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/.aios-core/infrastructure/scripts/_archived/final-todo-count.js +0 -122
  354. package/.aios-core/infrastructure/scripts/_archived/fix-yaml-formatting.js +0 -89
  355. package/.aios-core/infrastructure/scripts/_archived/migration-generator.js +0 -780
  356. package/.aios-core/infrastructure/scripts/_archived/migration-path-generator.js +0 -950
  357. package/.aios-core/infrastructure/scripts/_archived/phase2-entrada-saida-errors.js +0 -425
  358. package/.aios-core/infrastructure/scripts/_archived/phase2-spot-check.js +0 -132
  359. package/.aios-core/infrastructure/scripts/_archived/phase3-tools-scripts-validation.js +0 -381
  360. package/.aios-core/infrastructure/scripts/_archived/phase4-metadata-performance.js +0 -203
  361. package/.aios-core/infrastructure/scripts/_archived/test-yaml-parsing.js +0 -24
  362. package/.aios-core/infrastructure/scripts/_archived/verify-yaml-fix.js +0 -51
  363. package/.aios-core/tasks/find-component.md.legacy +0 -391
  364. package/.aios-core/tasks/generate-commit-message.md.legacy +0 -426
  365. package/.aios-core/tasks/generate-migration.md.legacy +0 -382
  366. package/.aios-core/tasks/rollback-modification.md.legacy +0 -307
  367. package/.aios-core/tasks/update-tests.md.legacy +0 -283
@@ -1,67 +1,67 @@
1
- # Pull Request
2
-
3
- ## Summary
4
- <!-- Brief description of changes (1-3 sentences) -->
5
-
6
-
7
- ## Type of Change
8
- <!-- Mark the appropriate option with [x] -->
9
- - [ ] Bug fix (non-breaking change that fixes an issue)
10
- - [ ] New feature (non-breaking change that adds functionality)
11
- - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
12
- - [ ] Documentation update
13
- - [ ] Refactoring (no functional changes)
14
- - [ ] Performance improvement
15
- - [ ] Test update
16
-
17
- ## Related Issues
18
- <!-- Link to related issues/stories -->
19
- - Closes #
20
- - Related to #
21
-
22
- ## Changes Made
23
- <!-- Describe your changes in detail -->
24
- -
25
- -
26
- -
27
-
28
- ## Testing
29
- <!-- Describe testing performed -->
30
- ### Test Plan
31
- - [ ] Unit tests added/updated
32
- - [ ] Integration tests added/updated
33
- - [ ] Manual testing performed
34
-
35
- ### Test Results
36
- ```
37
- # Paste test output here
38
- npm test
39
- ```
40
-
41
- ## Quality Checks
42
- <!-- Confirm quality gates passed -->
43
- - [ ] `npm run lint` passes
44
- - [ ] `npm test` passes
45
- - [ ] `npm run typecheck` passes (if TypeScript)
46
- - [ ] `npm run build` succeeds
47
- - [ ] CodeRabbit review completed (if available)
48
-
49
- ## Screenshots
50
- <!-- If UI changes, add before/after screenshots -->
51
-
52
- ## Checklist
53
- <!-- Confirm before requesting review -->
54
- - [ ] My code follows the project's style guidelines
55
- - [ ] I have performed a self-review of my code
56
- - [ ] I have commented my code, particularly in hard-to-understand areas
57
- - [ ] I have made corresponding changes to the documentation
58
- - [ ] My changes generate no new warnings
59
- - [ ] Any dependent changes have been merged and published
60
-
61
- ## Reviewer Notes
62
- <!-- Any specific areas that need careful review -->
63
-
64
-
65
- ---
66
- <!-- Do not edit below this line -->
67
- Generated by AIOS-FullStack @github-devops agent
1
+ # Pull Request
2
+
3
+ ## Summary
4
+ <!-- Brief description of changes (1-3 sentences) -->
5
+
6
+
7
+ ## Type of Change
8
+ <!-- Mark the appropriate option with [x] -->
9
+ - [ ] Bug fix (non-breaking change that fixes an issue)
10
+ - [ ] New feature (non-breaking change that adds functionality)
11
+ - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
12
+ - [ ] Documentation update
13
+ - [ ] Refactoring (no functional changes)
14
+ - [ ] Performance improvement
15
+ - [ ] Test update
16
+
17
+ ## Related Issues
18
+ <!-- Link to related issues/stories -->
19
+ - Closes #
20
+ - Related to #
21
+
22
+ ## Changes Made
23
+ <!-- Describe your changes in detail -->
24
+ -
25
+ -
26
+ -
27
+
28
+ ## Testing
29
+ <!-- Describe testing performed -->
30
+ ### Test Plan
31
+ - [ ] Unit tests added/updated
32
+ - [ ] Integration tests added/updated
33
+ - [ ] Manual testing performed
34
+
35
+ ### Test Results
36
+ ```
37
+ # Paste test output here
38
+ npm test
39
+ ```
40
+
41
+ ## Quality Checks
42
+ <!-- Confirm quality gates passed -->
43
+ - [ ] `npm run lint` passes
44
+ - [ ] `npm test` passes
45
+ - [ ] `npm run typecheck` passes (if TypeScript)
46
+ - [ ] `npm run build` succeeds
47
+ - [ ] CodeRabbit review completed (if available)
48
+
49
+ ## Screenshots
50
+ <!-- If UI changes, add before/after screenshots -->
51
+
52
+ ## Checklist
53
+ <!-- Confirm before requesting review -->
54
+ - [ ] My code follows the project's style guidelines
55
+ - [ ] I have performed a self-review of my code
56
+ - [ ] I have commented my code, particularly in hard-to-understand areas
57
+ - [ ] I have made corresponding changes to the documentation
58
+ - [ ] My changes generate no new warnings
59
+ - [ ] Any dependent changes have been merged and published
60
+
61
+ ## Reviewer Notes
62
+ <!-- Any specific areas that need careful review -->
63
+
64
+
65
+ ---
66
+ <!-- Do not edit below this line -->
67
+ Generated by AIOS-FullStack @github-devops agent
@@ -1,140 +1,140 @@
1
- # Docker MCP Gordon Configuration Template
2
- # AIOS-FULLSTACK Framework
3
- # Version: 1.0.0
4
- #
5
- # Usage:
6
- # This template is used by the *setup-mcp-docker task to generate
7
- # project-specific Docker MCP configurations.
8
- #
9
- # Variables:
10
- # {{PROJECT_ROOT}} - Project root path
11
- # {{GITHUB_TOKEN_ENV}} - GitHub token environment variable name
12
- # {{ENABLED_MCPS}} - List of enabled MCPs
13
- # {{PRESET_NAME}} - Active preset name
14
-
15
- version: '3.8'
16
-
17
- services:
18
- # ============================================
19
- # CORE MCPs
20
- # ============================================
21
-
22
- # Filesystem Access
23
- # Required for all workflows - read/write project files
24
- fs:
25
- image: mcp/filesystem
26
- command:
27
- - /workspace
28
- volumes:
29
- - {{PROJECT_ROOT}}:/workspace:rw
30
- labels:
31
- mcp.core: "true"
32
- mcp.preset: "core,dev,research,full"
33
- mcp.description: "File system access for project files"
34
-
35
- # GitHub Operations
36
- # Optional - requires GITHUB_TOKEN
37
- github:
38
- image: mcp/github
39
- environment:
40
- - GITHUB_TOKEN=${{GITHUB_TOKEN_ENV:-GITHUB_TOKEN}}
41
- labels:
42
- mcp.core: "true"
43
- mcp.preset: "core,dev,full"
44
- mcp.description: "GitHub API for repos, issues, PRs"
45
- mcp.requires_auth: "true"
46
-
47
- # HTTP Fetch
48
- # Optional - for web requests and scraping
49
- fetch:
50
- image: mcp/fetch
51
- labels:
52
- mcp.core: "true"
53
- mcp.preset: "core,research,full"
54
- mcp.description: "HTTP requests and web scraping"
55
-
56
- # ============================================
57
- # OPTIONAL MCPs - Uncomment as needed
58
- # ============================================
59
-
60
- # PostgreSQL Database Access
61
- # postgres:
62
- # image: mcp/postgres
63
- # environment:
64
- # - DATABASE_URL=${DATABASE_URL}
65
- # labels:
66
- # mcp.preset: "full,db"
67
- # mcp.description: "PostgreSQL database operations"
68
- # mcp.requires_auth: "true"
69
-
70
- # SQLite Database Access
71
- # sqlite:
72
- # image: mcp/sqlite
73
- # volumes:
74
- # - {{PROJECT_ROOT}}/data:/data:rw
75
- # labels:
76
- # mcp.preset: "full,db"
77
- # mcp.description: "SQLite database operations"
78
-
79
- # Browser Automation (Puppeteer)
80
- # puppeteer:
81
- # image: mcp/puppeteer
82
- # labels:
83
- # mcp.preset: "full,automation"
84
- # mcp.description: "Browser automation"
85
-
86
- # Notion Integration
87
- # notion:
88
- # image: mcp/notion
89
- # environment:
90
- # - NOTION_API_KEY=${NOTION_API_KEY}
91
- # labels:
92
- # mcp.preset: "full,productivity"
93
- # mcp.description: "Notion workspace integration"
94
- # mcp.requires_auth: "true"
95
-
96
- # Slack Integration
97
- # slack:
98
- # image: mcp/slack
99
- # environment:
100
- # - SLACK_BOT_TOKEN=${SLACK_BOT_TOKEN}
101
- # labels:
102
- # mcp.preset: "full,productivity"
103
- # mcp.description: "Slack messaging"
104
- # mcp.requires_auth: "true"
105
-
106
- # ============================================
107
- # NETWORK CONFIGURATION
108
- # ============================================
109
-
110
- networks:
111
- default:
112
- name: mcp-network-{{PRESET_NAME:-default}}
113
- driver: bridge
114
-
115
- # ============================================
116
- # VOLUMES (Optional - for persistent data)
117
- # ============================================
118
-
119
- # volumes:
120
- # mcp-data:
121
- # driver: local
122
-
123
- # ============================================
124
- # TEMPLATE NOTES
125
- # ============================================
126
- #
127
- # This template supports variable substitution:
128
- #
129
- # 1. Environment variables: ${VAR_NAME} or ${VAR_NAME:-default}
130
- # 2. Template variables: {{VAR_NAME}} (replaced at generation time)
131
- #
132
- # To generate a configuration:
133
- # *setup-mcp-docker --project /path/to/project
134
- #
135
- # To add MCPs dynamically:
136
- # docker mcp server add <name>
137
- # *add-mcp <name>
138
- #
139
- # To create custom presets:
140
- # docker mcp preset create <name> --servers fs,github
1
+ # Docker MCP Gordon Configuration Template
2
+ # Synkra AIOS Framework
3
+ # Version: 1.0.0
4
+ #
5
+ # Usage:
6
+ # This template is used by the *setup-mcp-docker task to generate
7
+ # project-specific Docker MCP configurations.
8
+ #
9
+ # Variables:
10
+ # {{PROJECT_ROOT}} - Project root path
11
+ # {{GITHUB_TOKEN_ENV}} - GitHub token environment variable name
12
+ # {{ENABLED_MCPS}} - List of enabled MCPs
13
+ # {{PRESET_NAME}} - Active preset name
14
+
15
+ version: '3.8'
16
+
17
+ services:
18
+ # ============================================
19
+ # CORE MCPs
20
+ # ============================================
21
+
22
+ # Filesystem Access
23
+ # Required for all workflows - read/write project files
24
+ fs:
25
+ image: mcp/filesystem
26
+ command:
27
+ - /workspace
28
+ volumes:
29
+ - {{PROJECT_ROOT}}:/workspace:rw
30
+ labels:
31
+ mcp.core: "true"
32
+ mcp.preset: "core,dev,research,full"
33
+ mcp.description: "File system access for project files"
34
+
35
+ # GitHub Operations
36
+ # Optional - requires GITHUB_TOKEN
37
+ github:
38
+ image: mcp/github
39
+ environment:
40
+ - GITHUB_TOKEN=${{GITHUB_TOKEN_ENV:-GITHUB_TOKEN}}
41
+ labels:
42
+ mcp.core: "true"
43
+ mcp.preset: "core,dev,full"
44
+ mcp.description: "GitHub API for repos, issues, PRs"
45
+ mcp.requires_auth: "true"
46
+
47
+ # HTTP Fetch
48
+ # Optional - for web requests and scraping
49
+ fetch:
50
+ image: mcp/fetch
51
+ labels:
52
+ mcp.core: "true"
53
+ mcp.preset: "core,research,full"
54
+ mcp.description: "HTTP requests and web scraping"
55
+
56
+ # ============================================
57
+ # OPTIONAL MCPs - Uncomment as needed
58
+ # ============================================
59
+
60
+ # PostgreSQL Database Access
61
+ # postgres:
62
+ # image: mcp/postgres
63
+ # environment:
64
+ # - DATABASE_URL=${DATABASE_URL}
65
+ # labels:
66
+ # mcp.preset: "full,db"
67
+ # mcp.description: "PostgreSQL database operations"
68
+ # mcp.requires_auth: "true"
69
+
70
+ # SQLite Database Access
71
+ # sqlite:
72
+ # image: mcp/sqlite
73
+ # volumes:
74
+ # - {{PROJECT_ROOT}}/data:/data:rw
75
+ # labels:
76
+ # mcp.preset: "full,db"
77
+ # mcp.description: "SQLite database operations"
78
+
79
+ # Browser Automation (Puppeteer)
80
+ # puppeteer:
81
+ # image: mcp/puppeteer
82
+ # labels:
83
+ # mcp.preset: "full,automation"
84
+ # mcp.description: "Browser automation"
85
+
86
+ # Notion Integration
87
+ # notion:
88
+ # image: mcp/notion
89
+ # environment:
90
+ # - NOTION_API_KEY=${NOTION_API_KEY}
91
+ # labels:
92
+ # mcp.preset: "full,productivity"
93
+ # mcp.description: "Notion workspace integration"
94
+ # mcp.requires_auth: "true"
95
+
96
+ # Slack Integration
97
+ # slack:
98
+ # image: mcp/slack
99
+ # environment:
100
+ # - SLACK_BOT_TOKEN=${SLACK_BOT_TOKEN}
101
+ # labels:
102
+ # mcp.preset: "full,productivity"
103
+ # mcp.description: "Slack messaging"
104
+ # mcp.requires_auth: "true"
105
+
106
+ # ============================================
107
+ # NETWORK CONFIGURATION
108
+ # ============================================
109
+
110
+ networks:
111
+ default:
112
+ name: mcp-network-{{PRESET_NAME:-default}}
113
+ driver: bridge
114
+
115
+ # ============================================
116
+ # VOLUMES (Optional - for persistent data)
117
+ # ============================================
118
+
119
+ # volumes:
120
+ # mcp-data:
121
+ # driver: local
122
+
123
+ # ============================================
124
+ # TEMPLATE NOTES
125
+ # ============================================
126
+ #
127
+ # This template supports variable substitution:
128
+ #
129
+ # 1. Environment variables: ${VAR_NAME} or ${VAR_NAME:-default}
130
+ # 2. Template variables: {{VAR_NAME}} (replaced at generation time)
131
+ #
132
+ # To generate a configuration:
133
+ # *setup-mcp-docker --project /path/to/project
134
+ #
135
+ # To add MCPs dynamically:
136
+ # docker mcp server add <name>
137
+ # *add-mcp <name>
138
+ #
139
+ # To create custom presets:
140
+ # docker mcp preset create <name> --servers fs,github
@@ -1,115 +1,115 @@
1
- # AIOS-FULLSTACK Development Rules for AntiGravity
2
-
3
- You are working with AIOS-FULLSTACK, an AI-Orchestrated System for Full Stack Development.
4
-
5
- ## Core Development Rules
6
-
7
- ### Agent Integration
8
- - Recognize AIOS agent activations: @dev, @qa, @architect, @pm, @po, @sm, @analyst
9
- - Agent commands use * prefix: *help, *create-story, *task, *exit
10
- - Follow agent-specific workflows and patterns
11
-
12
- ### Story-Driven Development
13
- 1. **Always work from a story file** in docs/stories/
14
- 2. **Update story checkboxes** as you complete tasks: [ ] → [x]
15
- 3. **Maintain the File List** section with all created/modified files
16
- 4. **Follow acceptance criteria** exactly as written
17
-
18
- ### Code Quality Standards
19
- - Write clean, maintainable code following project conventions
20
- - Include comprehensive error handling
21
- - Add unit tests for all new functionality
22
- - Follow existing patterns in the codebase
23
-
24
- ### Testing Protocol
25
- - Run all tests before marking tasks complete
26
- - Ensure linting passes: `npm run lint`
27
- - Verify type checking: `npm run typecheck`
28
- - Add tests for new features
29
-
30
- ## AIOS Framework Structure
31
-
32
- ```
33
- aios-core/
34
- ├── agents/ # Agent persona definitions
35
- ├── tasks/ # Executable task workflows
36
- ├── workflows/ # Multi-step workflows
37
- ├── templates/ # Document templates
38
- └── checklists/ # Validation checklists
39
-
40
- docs/
41
- ├── stories/ # Development stories
42
- ├── prd/ # Sharded PRD sections
43
- └── architecture/ # Sharded architecture
44
- ```
45
-
46
- ## Development Workflow
47
-
48
- 1. **Read the story** - Understand requirements fully
49
- 2. **Implement sequentially** - Follow task order
50
- 3. **Test thoroughly** - Validate each step
51
- 4. **Update story** - Mark completed items
52
- 5. **Document changes** - Update File List
53
-
54
- ## Best Practices
55
-
56
- ### When implementing:
57
- - Check existing patterns first
58
- - Reuse components and utilities
59
- - Follow naming conventions
60
- - Keep functions focused and small
61
-
62
- ### When testing:
63
- - Write tests alongside implementation
64
- - Test edge cases
65
- - Verify error handling
66
- - Run full test suite
67
-
68
- ### When documenting:
69
- - Update README for new features
70
- - Document API changes
71
- - Add inline comments for complex logic
72
- - Keep story File List current
73
-
74
- ## Git & GitHub
75
-
76
- - Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
77
- - Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
78
- - Ensure GitHub CLI is configured: `gh auth status`
79
- - Push regularly to avoid conflicts
80
-
81
- ## Common Patterns
82
-
83
- ### Error Handling
84
- ```javascript
85
- try {
86
- // Operation
87
- } catch (error) {
88
- console.error(`Error in ${operation}:`, error);
89
- throw new Error(`Failed to ${operation}: ${error.message}`);
90
- }
91
- ```
92
-
93
- ### File Operations
94
- ```javascript
95
- const fs = require('fs-extra');
96
- const path = require('path');
97
-
98
- // Always use absolute paths
99
- const filePath = path.join(__dirname, 'relative/path');
100
- ```
101
-
102
- ### Async/Await
103
- ```javascript
104
- async function operation() {
105
- try {
106
- const result = await asyncOperation();
107
- return result;
108
- } catch (error) {
109
- // Handle error appropriately
110
- }
111
- }
112
- ```
113
-
114
- ---
115
- *AIOS-FULLSTACK AntiGravity Configuration v1.0*
1
+ # Synkra AIOS Development Rules for AntiGravity
2
+
3
+ You are working with Synkra AIOS, an AI-Orchestrated System for Full Stack Development.
4
+
5
+ ## Core Development Rules
6
+
7
+ ### Agent Integration
8
+ - Recognize AIOS agent activations: @dev, @qa, @architect, @pm, @po, @sm, @analyst
9
+ - Agent commands use * prefix: *help, *create-story, *task, *exit
10
+ - Follow agent-specific workflows and patterns
11
+
12
+ ### Story-Driven Development
13
+ 1. **Always work from a story file** in docs/stories/
14
+ 2. **Update story checkboxes** as you complete tasks: [ ] → [x]
15
+ 3. **Maintain the File List** section with all created/modified files
16
+ 4. **Follow acceptance criteria** exactly as written
17
+
18
+ ### Code Quality Standards
19
+ - Write clean, maintainable code following project conventions
20
+ - Include comprehensive error handling
21
+ - Add unit tests for all new functionality
22
+ - Follow existing patterns in the codebase
23
+
24
+ ### Testing Protocol
25
+ - Run all tests before marking tasks complete
26
+ - Ensure linting passes: `npm run lint`
27
+ - Verify type checking: `npm run typecheck`
28
+ - Add tests for new features
29
+
30
+ ## AIOS Framework Structure
31
+
32
+ ```
33
+ aios-core/
34
+ ├── agents/ # Agent persona definitions
35
+ ├── tasks/ # Executable task workflows
36
+ ├── workflows/ # Multi-step workflows
37
+ ├── templates/ # Document templates
38
+ └── checklists/ # Validation checklists
39
+
40
+ docs/
41
+ ├── stories/ # Development stories
42
+ ├── prd/ # Sharded PRD sections
43
+ └── architecture/ # Sharded architecture
44
+ ```
45
+
46
+ ## Development Workflow
47
+
48
+ 1. **Read the story** - Understand requirements fully
49
+ 2. **Implement sequentially** - Follow task order
50
+ 3. **Test thoroughly** - Validate each step
51
+ 4. **Update story** - Mark completed items
52
+ 5. **Document changes** - Update File List
53
+
54
+ ## Best Practices
55
+
56
+ ### When implementing:
57
+ - Check existing patterns first
58
+ - Reuse components and utilities
59
+ - Follow naming conventions
60
+ - Keep functions focused and small
61
+
62
+ ### When testing:
63
+ - Write tests alongside implementation
64
+ - Test edge cases
65
+ - Verify error handling
66
+ - Run full test suite
67
+
68
+ ### When documenting:
69
+ - Update README for new features
70
+ - Document API changes
71
+ - Add inline comments for complex logic
72
+ - Keep story File List current
73
+
74
+ ## Git & GitHub
75
+
76
+ - Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
77
+ - Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
78
+ - Ensure GitHub CLI is configured: `gh auth status`
79
+ - Push regularly to avoid conflicts
80
+
81
+ ## Common Patterns
82
+
83
+ ### Error Handling
84
+ ```javascript
85
+ try {
86
+ // Operation
87
+ } catch (error) {
88
+ console.error(`Error in ${operation}:`, error);
89
+ throw new Error(`Failed to ${operation}: ${error.message}`);
90
+ }
91
+ ```
92
+
93
+ ### File Operations
94
+ ```javascript
95
+ const fs = require('fs-extra');
96
+ const path = require('path');
97
+
98
+ // Always use absolute paths
99
+ const filePath = path.join(__dirname, 'relative/path');
100
+ ```
101
+
102
+ ### Async/Await
103
+ ```javascript
104
+ async function operation() {
105
+ try {
106
+ const result = await asyncOperation();
107
+ return result;
108
+ } catch (error) {
109
+ // Handle error appropriately
110
+ }
111
+ }
112
+ ```
113
+
114
+ ---
115
+ *Synkra AIOS AntiGravity Configuration v1.0*