aios-core 2.1.5 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (392) hide show
  1. package/.aios-core/core/README.md +229 -229
  2. package/.aios-core/core/data/agent-config-requirements.yaml +368 -368
  3. package/.aios-core/core/data/aios-kb.md +923 -923
  4. package/.aios-core/core/data/workflow-patterns.yaml +267 -267
  5. package/.aios-core/core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  6. package/.aios-core/core/docs/component-creation-guide.md +457 -457
  7. package/.aios-core/core/docs/session-update-pattern.md +307 -307
  8. package/.aios-core/core/docs/template-syntax.md +266 -266
  9. package/.aios-core/core/docs/troubleshooting-guide.md +624 -624
  10. package/.aios-core/core/elicitation/elicitation-engine.js +1 -1
  11. package/.aios-core/core/index.esm.js +42 -42
  12. package/.aios-core/core/index.js +1 -1
  13. package/.aios-core/core/migration/migration-config.yaml +83 -83
  14. package/.aios-core/core/migration/module-mapping.yaml +89 -89
  15. package/.aios-core/core/quality-gates/layer2-pr-automation.js +1 -1
  16. package/.aios-core/core/quality-gates/quality-gate-config.yaml +86 -86
  17. package/.aios-core/core/registry/README.md +179 -179
  18. package/.aios-core/core/utils/security-utils.js +1 -1
  19. package/.aios-core/core-config.yaml +391 -382
  20. package/.aios-core/data/agent-config-requirements.yaml +368 -368
  21. package/.aios-core/data/aios-kb.md +923 -923
  22. package/.aios-core/data/technical-preferences.md +3 -3
  23. package/.aios-core/data/workflow-patterns.yaml +267 -267
  24. package/.aios-core/development/README.md +142 -142
  25. package/.aios-core/development/agent-teams/team-all.yaml +15 -15
  26. package/.aios-core/development/agent-teams/team-fullstack.yaml +18 -18
  27. package/.aios-core/development/agent-teams/team-ide-minimal.yaml +10 -10
  28. package/.aios-core/development/agent-teams/team-no-ui.yaml +13 -13
  29. package/.aios-core/development/agent-teams/team-qa-focused.yaml +155 -155
  30. package/.aios-core/development/agents/aios-master.md +339 -339
  31. package/.aios-core/development/agents/analyst.md +195 -195
  32. package/.aios-core/development/agents/architect.md +359 -359
  33. package/.aios-core/development/agents/data-engineer.md +468 -468
  34. package/.aios-core/development/agents/dev.md +390 -390
  35. package/.aios-core/development/agents/devops.md +398 -398
  36. package/.aios-core/development/agents/pm.md +198 -198
  37. package/.aios-core/development/agents/po.md +256 -256
  38. package/.aios-core/development/agents/qa.md +312 -312
  39. package/.aios-core/development/agents/sm.md +220 -220
  40. package/.aios-core/development/agents/ux-design-expert.md +451 -451
  41. package/.aios-core/development/scripts/greeting-config-cli.js +85 -85
  42. package/.aios-core/development/tasks/add-mcp.md +319 -319
  43. package/.aios-core/development/tasks/advanced-elicitation.md +318 -318
  44. package/.aios-core/development/tasks/analyst-facilitate-brainstorming.md +341 -341
  45. package/.aios-core/development/tasks/analyze-brownfield.md +456 -0
  46. package/.aios-core/development/tasks/analyze-framework.md +696 -696
  47. package/.aios-core/development/tasks/analyze-performance.md +637 -637
  48. package/.aios-core/development/tasks/apply-qa-fixes.md +340 -340
  49. package/.aios-core/development/tasks/architect-analyze-impact.md +826 -826
  50. package/.aios-core/development/tasks/audit-codebase.md +429 -429
  51. package/.aios-core/development/tasks/audit-tailwind-config.md +270 -270
  52. package/.aios-core/development/tasks/audit-utilities.md +358 -358
  53. package/.aios-core/development/tasks/bootstrap-shadcn-library.md +286 -286
  54. package/.aios-core/development/tasks/brownfield-create-epic.md +485 -485
  55. package/.aios-core/development/tasks/brownfield-create-story.md +356 -356
  56. package/.aios-core/development/tasks/build-component.md +478 -478
  57. package/.aios-core/development/tasks/calculate-roi.md +455 -455
  58. package/.aios-core/development/tasks/ci-cd-configuration.md +764 -764
  59. package/.aios-core/development/tasks/cleanup-utilities.md +670 -670
  60. package/.aios-core/development/tasks/collaborative-edit.md +1108 -1108
  61. package/.aios-core/development/tasks/compose-molecule.md +284 -284
  62. package/.aios-core/development/tasks/consolidate-patterns.md +414 -414
  63. package/.aios-core/development/tasks/correct-course.md +279 -279
  64. package/.aios-core/development/tasks/create-agent.md +321 -321
  65. package/.aios-core/development/tasks/create-brownfield-story.md +726 -726
  66. package/.aios-core/development/tasks/create-deep-research-prompt.md +498 -498
  67. package/.aios-core/development/tasks/create-doc.md +316 -316
  68. package/.aios-core/development/tasks/create-next-story.md +774 -774
  69. package/.aios-core/development/tasks/create-suite.md +283 -283
  70. package/.aios-core/development/tasks/create-task.md +371 -371
  71. package/.aios-core/development/tasks/create-workflow.md +370 -370
  72. package/.aios-core/development/tasks/db-analyze-hotpaths.md +572 -572
  73. package/.aios-core/development/tasks/db-apply-migration.md +381 -381
  74. package/.aios-core/development/tasks/db-bootstrap.md +642 -642
  75. package/.aios-core/development/tasks/db-domain-modeling.md +693 -693
  76. package/.aios-core/development/tasks/db-dry-run.md +293 -293
  77. package/.aios-core/development/tasks/db-env-check.md +260 -260
  78. package/.aios-core/development/tasks/db-expansion-pack-integration.md +663 -663
  79. package/.aios-core/development/tasks/db-explain.md +631 -631
  80. package/.aios-core/development/tasks/db-impersonate.md +495 -495
  81. package/.aios-core/development/tasks/db-load-csv.md +593 -593
  82. package/.aios-core/development/tasks/db-policy-apply.md +653 -653
  83. package/.aios-core/development/tasks/db-rls-audit.md +411 -411
  84. package/.aios-core/development/tasks/db-rollback.md +739 -739
  85. package/.aios-core/development/tasks/db-run-sql.md +613 -613
  86. package/.aios-core/development/tasks/db-schema-audit.md +1011 -1011
  87. package/.aios-core/development/tasks/db-seed.md +390 -390
  88. package/.aios-core/development/tasks/db-smoke-test.md +351 -351
  89. package/.aios-core/development/tasks/db-snapshot.md +569 -569
  90. package/.aios-core/development/tasks/db-supabase-setup.md +712 -712
  91. package/.aios-core/development/tasks/db-verify-order.md +515 -515
  92. package/.aios-core/development/tasks/deprecate-component.md +956 -956
  93. package/.aios-core/development/tasks/dev-apply-qa-fixes.md +318 -318
  94. package/.aios-core/development/tasks/dev-backlog-debt.md +469 -469
  95. package/.aios-core/development/tasks/dev-develop-story.md +846 -846
  96. package/.aios-core/development/tasks/dev-improve-code-quality.md +872 -872
  97. package/.aios-core/development/tasks/dev-optimize-performance.md +1033 -1033
  98. package/.aios-core/development/tasks/dev-suggest-refactoring.md +870 -870
  99. package/.aios-core/development/tasks/dev-validate-next-story.md +348 -348
  100. package/.aios-core/development/tasks/document-project.md +552 -552
  101. package/.aios-core/development/tasks/environment-bootstrap.md +1311 -1311
  102. package/.aios-core/development/tasks/execute-checklist.md +301 -301
  103. package/.aios-core/development/tasks/export-design-tokens-dtcg.md +274 -274
  104. package/.aios-core/development/tasks/extend-pattern.md +269 -269
  105. package/.aios-core/development/tasks/extract-tokens.md +467 -467
  106. package/.aios-core/development/tasks/facilitate-brainstorming-session.md +518 -518
  107. package/.aios-core/development/tasks/generate-ai-frontend-prompt.md +260 -260
  108. package/.aios-core/development/tasks/generate-documentation.md +284 -284
  109. package/.aios-core/development/tasks/generate-migration-strategy.md +522 -522
  110. package/.aios-core/development/tasks/generate-shock-report.md +501 -501
  111. package/.aios-core/development/tasks/github-devops-github-pr-automation.md +427 -427
  112. package/.aios-core/development/tasks/github-devops-pre-push-quality-gate.md +733 -733
  113. package/.aios-core/development/tasks/github-devops-repository-cleanup.md +374 -374
  114. package/.aios-core/development/tasks/github-devops-version-management.md +483 -483
  115. package/.aios-core/development/tasks/improve-self.md +822 -822
  116. package/.aios-core/development/tasks/index-docs.md +387 -387
  117. package/.aios-core/development/tasks/init-project-status.md +506 -506
  118. package/.aios-core/development/tasks/integrate-expansion-pack.md +314 -314
  119. package/.aios-core/development/tasks/kb-mode-interaction.md +283 -283
  120. package/.aios-core/development/tasks/learn-patterns.md +900 -900
  121. package/.aios-core/development/tasks/mcp-workflow.md +437 -437
  122. package/.aios-core/development/tasks/modify-agent.md +381 -381
  123. package/.aios-core/development/tasks/modify-task.md +424 -424
  124. package/.aios-core/development/tasks/modify-workflow.md +465 -465
  125. package/.aios-core/development/tasks/po-backlog-add.md +370 -370
  126. package/.aios-core/development/tasks/po-manage-story-backlog.md +523 -523
  127. package/.aios-core/development/tasks/po-pull-story-from-clickup.md +540 -540
  128. package/.aios-core/development/tasks/po-pull-story.md +316 -316
  129. package/.aios-core/development/tasks/po-stories-index.md +351 -351
  130. package/.aios-core/development/tasks/po-sync-story-to-clickup.md +457 -457
  131. package/.aios-core/development/tasks/po-sync-story.md +303 -303
  132. package/.aios-core/development/tasks/pr-automation.md +701 -701
  133. package/.aios-core/development/tasks/propose-modification.md +842 -842
  134. package/.aios-core/development/tasks/qa-backlog-add-followup.md +425 -425
  135. package/.aios-core/development/tasks/qa-gate.md +373 -373
  136. package/.aios-core/development/tasks/qa-generate-tests.md +1174 -1174
  137. package/.aios-core/development/tasks/qa-nfr-assess.md +557 -557
  138. package/.aios-core/development/tasks/qa-review-proposal.md +1157 -1157
  139. package/.aios-core/development/tasks/qa-review-story.md +682 -682
  140. package/.aios-core/development/tasks/qa-risk-profile.md +566 -566
  141. package/.aios-core/development/tasks/qa-run-tests.md +277 -277
  142. package/.aios-core/development/tasks/qa-test-design.md +387 -387
  143. package/.aios-core/development/tasks/qa-trace-requirements.md +476 -476
  144. package/.aios-core/development/tasks/release-management.md +723 -723
  145. package/.aios-core/development/tasks/security-audit.md +554 -554
  146. package/.aios-core/development/tasks/security-scan.md +790 -790
  147. package/.aios-core/development/tasks/setup-database.md +741 -741
  148. package/.aios-core/development/tasks/setup-design-system.md +462 -462
  149. package/.aios-core/development/tasks/setup-github.md +874 -874
  150. package/.aios-core/development/tasks/setup-llm-routing.md +1 -1
  151. package/.aios-core/development/tasks/setup-mcp-docker.md +584 -584
  152. package/.aios-core/development/tasks/setup-project-docs.md +440 -0
  153. package/.aios-core/development/tasks/shard-doc.md +537 -537
  154. package/.aios-core/development/tasks/sm-create-next-story.md +480 -480
  155. package/.aios-core/development/tasks/sync-documentation.md +864 -864
  156. package/.aios-core/development/tasks/tailwind-upgrade.md +294 -294
  157. package/.aios-core/development/tasks/test-as-user.md +621 -621
  158. package/.aios-core/development/tasks/test-validation-task.md +171 -171
  159. package/.aios-core/development/tasks/undo-last.md +346 -346
  160. package/.aios-core/development/tasks/update-manifest.md +409 -409
  161. package/.aios-core/development/tasks/ux-create-wireframe.md +617 -617
  162. package/.aios-core/development/tasks/ux-ds-scan-artifact.md +672 -672
  163. package/.aios-core/development/tasks/ux-user-research.md +559 -559
  164. package/.aios-core/development/tasks/validate-next-story.md +422 -422
  165. package/.aios-core/development/workflows/README.md +83 -83
  166. package/.aios-core/development/workflows/brownfield-fullstack.yaml +297 -297
  167. package/.aios-core/development/workflows/brownfield-service.yaml +187 -187
  168. package/.aios-core/development/workflows/brownfield-ui.yaml +197 -197
  169. package/.aios-core/development/workflows/greenfield-fullstack.yaml +333 -333
  170. package/.aios-core/development/workflows/greenfield-service.yaml +206 -206
  171. package/.aios-core/development/workflows/greenfield-ui.yaml +235 -235
  172. package/.aios-core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  173. package/.aios-core/docs/component-creation-guide.md +457 -457
  174. package/.aios-core/docs/session-update-pattern.md +307 -307
  175. package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +572 -572
  176. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md +185 -185
  177. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md +354 -354
  178. package/.aios-core/docs/standards/AIOS-FRAMEWORK-MASTER.md +1963 -1963
  179. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md +821 -821
  180. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md +1190 -1190
  181. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1.md +439 -439
  182. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md +1339 -1339
  183. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO.md +5398 -5398
  184. package/.aios-core/docs/standards/EXECUTOR-DECISION-TREE.md +697 -697
  185. package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +511 -511
  186. package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md +556 -556
  187. package/.aios-core/docs/standards/STANDARDS-INDEX.md +210 -210
  188. package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +550 -550
  189. package/.aios-core/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1414 -1414
  190. package/.aios-core/docs/standards/V3-ARCHITECTURAL-DECISIONS.md +523 -523
  191. package/.aios-core/docs/template-syntax.md +266 -266
  192. package/.aios-core/docs/troubleshooting-guide.md +624 -624
  193. package/.aios-core/index.esm.js +15 -15
  194. package/.aios-core/index.js +1 -1
  195. package/.aios-core/infrastructure/README.md +126 -126
  196. package/.aios-core/infrastructure/integrations/pm-adapters/README.md +59 -59
  197. package/.aios-core/infrastructure/scripts/approval-workflow.js +1 -1
  198. package/.aios-core/infrastructure/scripts/batch-creator.js +1 -1
  199. package/.aios-core/infrastructure/scripts/component-generator.js +3 -3
  200. package/.aios-core/infrastructure/scripts/component-metadata.js +1 -1
  201. package/.aios-core/infrastructure/scripts/component-search.js +1 -1
  202. package/.aios-core/infrastructure/scripts/coverage-analyzer.js +1 -1
  203. package/.aios-core/infrastructure/scripts/dependency-analyzer.js +1 -1
  204. package/.aios-core/infrastructure/scripts/dependency-impact-analyzer.js +1 -1
  205. package/.aios-core/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +501 -0
  206. package/.aios-core/infrastructure/scripts/documentation-integrity/config-generator.js +368 -0
  207. package/.aios-core/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +308 -0
  208. package/.aios-core/infrastructure/scripts/documentation-integrity/doc-generator.js +331 -0
  209. package/.aios-core/infrastructure/scripts/documentation-integrity/gitignore-generator.js +312 -0
  210. package/.aios-core/infrastructure/scripts/documentation-integrity/index.js +74 -0
  211. package/.aios-core/infrastructure/scripts/documentation-integrity/mode-detector.js +389 -0
  212. package/.aios-core/infrastructure/scripts/framework-analyzer.js +1 -1
  213. package/.aios-core/infrastructure/scripts/improvement-engine.js +1 -1
  214. package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js +26 -13
  215. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -0
  216. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +108 -0
  217. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -0
  218. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +65 -0
  219. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -0
  220. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +16 -0
  221. package/.aios-core/infrastructure/scripts/llm-routing/usage-tracker/index.js +549 -0
  222. package/.aios-core/infrastructure/scripts/modification-risk-assessment.js +1 -1
  223. package/.aios-core/infrastructure/scripts/performance-analyzer.js +1 -1
  224. package/.aios-core/infrastructure/scripts/pm-adapter.js +134 -134
  225. package/.aios-core/infrastructure/scripts/repository-detector.js +3 -3
  226. package/.aios-core/infrastructure/scripts/template-engine.js +1 -1
  227. package/.aios-core/infrastructure/scripts/template-validator.js +1 -1
  228. package/.aios-core/infrastructure/scripts/test-generator.js +1 -1
  229. package/.aios-core/infrastructure/scripts/test-quality-assessment.js +1 -1
  230. package/.aios-core/infrastructure/scripts/transaction-manager.js +1 -1
  231. package/.aios-core/infrastructure/scripts/usage-analytics.js +1 -1
  232. package/.aios-core/infrastructure/scripts/visual-impact-generator.js +2 -2
  233. package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +176 -0
  234. package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +127 -0
  235. package/.aios-core/infrastructure/templates/github-workflows/README.md +109 -109
  236. package/.aios-core/infrastructure/templates/gitignore/gitignore-aios-base.tmpl +63 -0
  237. package/.aios-core/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +18 -0
  238. package/.aios-core/infrastructure/templates/gitignore/gitignore-node.tmpl +85 -0
  239. package/.aios-core/infrastructure/templates/gitignore/gitignore-python.tmpl +145 -0
  240. package/.aios-core/infrastructure/templates/project-docs/coding-standards-tmpl.md +346 -0
  241. package/.aios-core/infrastructure/templates/project-docs/source-tree-tmpl.md +177 -0
  242. package/.aios-core/infrastructure/templates/project-docs/tech-stack-tmpl.md +267 -0
  243. package/.aios-core/infrastructure/tests/regression-suite-v2.md +621 -621
  244. package/.aios-core/infrastructure/tools/README.md +222 -222
  245. package/.aios-core/infrastructure/tools/cli/github-cli.yaml +200 -200
  246. package/.aios-core/infrastructure/tools/cli/railway-cli.yaml +260 -260
  247. package/.aios-core/infrastructure/tools/cli/supabase-cli.yaml +224 -224
  248. package/.aios-core/infrastructure/tools/local/ffmpeg.yaml +261 -261
  249. package/.aios-core/infrastructure/tools/mcp/21st-dev-magic.yaml +127 -127
  250. package/.aios-core/infrastructure/tools/mcp/browser.yaml +103 -103
  251. package/.aios-core/infrastructure/tools/mcp/clickup.yaml +534 -534
  252. package/.aios-core/infrastructure/tools/mcp/context7.yaml +78 -78
  253. package/.aios-core/infrastructure/tools/mcp/desktop-commander.yaml +180 -180
  254. package/.aios-core/infrastructure/tools/mcp/exa.yaml +103 -103
  255. package/.aios-core/infrastructure/tools/mcp/google-workspace.yaml +930 -930
  256. package/.aios-core/infrastructure/tools/mcp/n8n.yaml +551 -551
  257. package/.aios-core/infrastructure/tools/mcp/supabase.yaml +808 -808
  258. package/.aios-core/install-manifest.yaml +347 -347
  259. package/.aios-core/product/README.md +56 -56
  260. package/.aios-core/product/checklists/accessibility-wcag-checklist.md +80 -0
  261. package/.aios-core/product/checklists/architect-checklist.md +443 -443
  262. package/.aios-core/product/checklists/change-checklist.md +182 -182
  263. package/.aios-core/product/checklists/component-quality-checklist.md +74 -0
  264. package/.aios-core/product/checklists/database-design-checklist.md +119 -119
  265. package/.aios-core/product/checklists/dba-predeploy-checklist.md +97 -97
  266. package/.aios-core/product/checklists/dba-rollback-checklist.md +99 -99
  267. package/.aios-core/product/checklists/migration-readiness-checklist.md +75 -0
  268. package/.aios-core/product/checklists/pattern-audit-checklist.md +88 -0
  269. package/.aios-core/product/checklists/pm-checklist.md +375 -375
  270. package/.aios-core/product/checklists/po-master-checklist.md +441 -441
  271. package/.aios-core/product/checklists/pre-push-checklist.md +108 -108
  272. package/.aios-core/product/checklists/release-checklist.md +122 -122
  273. package/.aios-core/product/checklists/story-dod-checklist.md +101 -101
  274. package/.aios-core/product/checklists/story-draft-checklist.md +215 -215
  275. package/.aios-core/product/data/atomic-design-principles.md +108 -0
  276. package/.aios-core/product/data/brainstorming-techniques.md +36 -36
  277. package/.aios-core/product/data/consolidation-algorithms.md +142 -0
  278. package/.aios-core/product/data/database-best-practices.md +182 -0
  279. package/.aios-core/product/data/design-token-best-practices.md +107 -0
  280. package/.aios-core/product/data/elicitation-methods.md +134 -134
  281. package/.aios-core/product/data/integration-patterns.md +207 -0
  282. package/.aios-core/product/data/migration-safety-guide.md +329 -0
  283. package/.aios-core/product/data/mode-selection-best-practices.md +471 -471
  284. package/.aios-core/product/data/postgres-tuning-guide.md +300 -0
  285. package/.aios-core/product/data/rls-security-patterns.md +333 -0
  286. package/.aios-core/product/data/roi-calculation-guide.md +142 -0
  287. package/.aios-core/product/data/supabase-patterns.md +330 -0
  288. package/.aios-core/product/data/test-levels-framework.md +148 -148
  289. package/.aios-core/product/data/test-priorities-matrix.md +174 -174
  290. package/.aios-core/product/data/wcag-compliance-guide.md +267 -0
  291. package/.aios-core/product/templates/1mcp-config.yaml +225 -225
  292. package/.aios-core/product/templates/activation-instructions-inline-greeting.yaml +63 -63
  293. package/.aios-core/product/templates/activation-instructions-template.md +258 -258
  294. package/.aios-core/product/templates/agent-template.yaml +120 -120
  295. package/.aios-core/product/templates/architecture-tmpl.yaml +650 -650
  296. package/.aios-core/product/templates/brainstorming-output-tmpl.yaml +155 -155
  297. package/.aios-core/product/templates/brownfield-architecture-tmpl.yaml +475 -475
  298. package/.aios-core/product/templates/brownfield-prd-tmpl.yaml +279 -279
  299. package/.aios-core/product/templates/changelog-template.md +134 -134
  300. package/.aios-core/product/templates/command-rationalization-matrix.md +152 -152
  301. package/.aios-core/product/templates/competitor-analysis-tmpl.yaml +292 -292
  302. package/.aios-core/product/templates/design-story-tmpl.yaml +587 -587
  303. package/.aios-core/product/templates/ds-artifact-analysis.md +70 -70
  304. package/.aios-core/product/templates/front-end-architecture-tmpl.yaml +205 -205
  305. package/.aios-core/product/templates/front-end-spec-tmpl.yaml +348 -348
  306. package/.aios-core/product/templates/fullstack-architecture-tmpl.yaml +804 -804
  307. package/.aios-core/product/templates/github-pr-template.md +67 -67
  308. package/.aios-core/product/templates/gordon-mcp.yaml +140 -140
  309. package/.aios-core/product/templates/ide-rules/antigravity-rules.md +115 -115
  310. package/.aios-core/product/templates/ide-rules/claude-rules.md +221 -221
  311. package/.aios-core/product/templates/ide-rules/cline-rules.md +84 -84
  312. package/.aios-core/product/templates/ide-rules/copilot-rules.md +92 -92
  313. package/.aios-core/product/templates/ide-rules/cursor-rules.md +115 -115
  314. package/.aios-core/product/templates/ide-rules/gemini-rules.md +85 -85
  315. package/.aios-core/product/templates/ide-rules/roo-rules.md +86 -86
  316. package/.aios-core/product/templates/ide-rules/trae-rules.md +104 -104
  317. package/.aios-core/product/templates/ide-rules/windsurf-rules.md +80 -80
  318. package/.aios-core/product/templates/index-strategy-tmpl.yaml +53 -53
  319. package/.aios-core/product/templates/market-research-tmpl.yaml +251 -251
  320. package/.aios-core/product/templates/mcp-workflow.js +271 -271
  321. package/.aios-core/product/templates/migration-plan-tmpl.yaml +1022 -1022
  322. package/.aios-core/product/templates/migration-strategy-tmpl.md +524 -524
  323. package/.aios-core/product/templates/personalized-agent-template.md +258 -258
  324. package/.aios-core/product/templates/personalized-checklist-template.md +340 -340
  325. package/.aios-core/product/templates/personalized-task-template-v2.md +905 -905
  326. package/.aios-core/product/templates/personalized-task-template.md +344 -344
  327. package/.aios-core/product/templates/personalized-template-file.yaml +322 -322
  328. package/.aios-core/product/templates/personalized-workflow-template.yaml +460 -460
  329. package/.aios-core/product/templates/prd-tmpl.yaml +201 -201
  330. package/.aios-core/product/templates/project-brief-tmpl.yaml +220 -220
  331. package/.aios-core/product/templates/qa-gate-tmpl.yaml +240 -240
  332. package/.aios-core/product/templates/rls-policies-tmpl.yaml +1203 -1203
  333. package/.aios-core/product/templates/schema-design-tmpl.yaml +428 -428
  334. package/.aios-core/product/templates/state-persistence-tmpl.yaml +219 -219
  335. package/.aios-core/product/templates/story-tmpl.yaml +331 -331
  336. package/.aios-core/product/templates/task-execution-report.md +495 -495
  337. package/.aios-core/product/templates/task-template.md +122 -122
  338. package/.aios-core/product/templates/token-exports-tailwind-tmpl.js +395 -395
  339. package/.aios-core/product/templates/tokens-schema-tmpl.yaml +305 -305
  340. package/.aios-core/product/templates/workflow-template.yaml +133 -133
  341. package/.aios-core/scripts/README.md +354 -354
  342. package/.aios-core/scripts/aios-doc-template.md +325 -325
  343. package/.aios-core/scripts/elicitation-engine.js +1 -1
  344. package/.aios-core/scripts/test-template-system.js +1 -1
  345. package/.aios-core/scripts/workflow-management.md +69 -69
  346. package/.aios-core/user-guide.md +1413 -1413
  347. package/.aios-core/working-in-the-brownfield.md +361 -361
  348. package/LICENSE +1 -1
  349. package/README.md +702 -703
  350. package/bin/aios-init-old.js +3 -3
  351. package/bin/aios-init-v4.js +1 -1
  352. package/bin/aios-init.backup-v1.1.4.js +1 -1
  353. package/bin/aios-init.js +3 -3
  354. package/bin/aios.js +279 -279
  355. package/bin/utils/install-errors.js +339 -339
  356. package/bin/utils/install-transaction.js +445 -445
  357. package/index.d.ts +18 -18
  358. package/index.esm.js +20 -20
  359. package/index.js +6 -6
  360. package/package.json +8 -10
  361. package/packages/installer/src/config/templates/env-template.js +27 -4
  362. package/packages/installer/src/detection/detect-project-type.js +81 -81
  363. package/packages/installer/src/wizard/wizard.js +185 -34
  364. package/packages/installer/tests/integration/environment-configuration.test.js +2 -1
  365. package/packages/installer/tests/integration/wizard-detection.test.js +8 -6
  366. package/packages/installer/tests/unit/env-template.test.js +11 -10
  367. package/src/config/ide-configs.js +1 -1
  368. package/src/wizard/feedback.js +2 -2
  369. package/src/wizard/index.js +1 -1
  370. package/src/wizard/validation/report-generator.js +1 -1
  371. package/src/wizard/validation/troubleshooting-system.js +13 -13
  372. package/.aios-core/development/tasks/validate-structure.md +0 -243
  373. package/.aios-core/infrastructure/scripts/_archived/final-todo-count.js +0 -122
  374. package/.aios-core/infrastructure/scripts/_archived/fix-yaml-formatting.js +0 -89
  375. package/.aios-core/infrastructure/scripts/_archived/migration-generator.js +0 -780
  376. package/.aios-core/infrastructure/scripts/_archived/migration-path-generator.js +0 -950
  377. package/.aios-core/infrastructure/scripts/_archived/phase2-entrada-saida-errors.js +0 -425
  378. package/.aios-core/infrastructure/scripts/_archived/phase2-spot-check.js +0 -132
  379. package/.aios-core/infrastructure/scripts/_archived/phase3-tools-scripts-validation.js +0 -381
  380. package/.aios-core/infrastructure/scripts/_archived/phase4-metadata-performance.js +0 -203
  381. package/.aios-core/infrastructure/scripts/_archived/test-yaml-parsing.js +0 -24
  382. package/.aios-core/infrastructure/scripts/_archived/verify-yaml-fix.js +0 -51
  383. package/.aios-core/infrastructure/scripts/source-tree-guardian/index.js +0 -375
  384. package/.aios-core/infrastructure/scripts/source-tree-guardian/manifest-generator.js +0 -410
  385. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/naming-rules.yaml +0 -285
  386. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/placement-rules.yaml +0 -262
  387. package/.aios-core/infrastructure/scripts/source-tree-guardian/validator.js +0 -468
  388. package/.aios-core/tasks/find-component.md.legacy +0 -391
  389. package/.aios-core/tasks/generate-commit-message.md.legacy +0 -426
  390. package/.aios-core/tasks/generate-migration.md.legacy +0 -382
  391. package/.aios-core/tasks/rollback-modification.md.legacy +0 -307
  392. package/.aios-core/tasks/update-tests.md.legacy +0 -283
@@ -1,86 +1,86 @@
1
- # AIOS-FULLSTACK Development Rules for Roo Code
2
-
3
- You are working with AIOS-FULLSTACK, an AI-Orchestrated System for Full Stack Development.
4
-
5
- ## Core Framework Understanding
6
-
7
- AIOS-FULLSTACK is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
8
-
9
- ## Agent System
10
-
11
- ### Agent Activation (Roo Mode Selector)
12
- - Use the mode selector in the status bar to switch agents
13
- - Available modes: bmad-dev, bmad-qa, bmad-architect, bmad-pm, bmad-po, bmad-sm, bmad-analyst
14
- - Agent commands use the * prefix: *help, *create-story, *task, *exit
15
-
16
- ### Agent Context
17
- When an agent mode is active:
18
- - Follow that agent's specific persona and expertise
19
- - Use the agent's designated workflow patterns
20
- - Maintain the agent's perspective throughout the interaction
21
-
22
- ## Development Methodology
23
-
24
- ### Story-Driven Development
25
- 1. **Work from stories** - All development starts with a story in `docs/stories/`
26
- 2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
27
- 3. **Track changes** - Maintain the File List section in the story
28
- 4. **Follow criteria** - Implement exactly what the acceptance criteria specify
29
-
30
- ### Code Standards
31
- - Write clean, self-documenting code
32
- - Follow existing patterns in the codebase
33
- - Include comprehensive error handling
34
- - Add unit tests for all new functionality
35
- - Use TypeScript/JavaScript best practices
36
-
37
- ### Testing Requirements
38
- - Run all tests before marking tasks complete
39
- - Ensure linting passes: `npm run lint`
40
- - Verify type checking: `npm run typecheck`
41
- - Add tests for new features
42
- - Test edge cases and error scenarios
43
-
44
- ## AIOS Framework Structure
45
-
46
- ```
47
- aios-core/
48
- ├── agents/ # Agent persona definitions (YAML/Markdown)
49
- ├── tasks/ # Executable task workflows
50
- ├── workflows/ # Multi-step workflow definitions
51
- ├── templates/ # Document and code templates
52
- ├── checklists/ # Validation and review checklists
53
- └── rules/ # Framework rules and patterns
54
-
55
- docs/
56
- ├── stories/ # Development stories (numbered)
57
- ├── prd/ # Product requirement documents
58
- ├── architecture/ # System architecture documentation
59
- └── guides/ # User and developer guides
60
- ```
61
-
62
- ## Roo Code-Specific Configuration
63
-
64
- ### Mode Configuration
65
- - Modes are defined in `.roomodes` file
66
- - Each mode corresponds to an AIOS agent persona
67
- - Switching modes automatically loads the appropriate context
68
-
69
- ### Available Modes
70
- | Mode | Agent | Purpose |
71
- |------|-------|---------|
72
- | bmad-dev | Developer | Full-stack development |
73
- | bmad-qa | QA | Quality assurance, testing |
74
- | bmad-architect | Architect | System design |
75
- | bmad-pm | PM | Project management |
76
- | bmad-po | PO | Product ownership |
77
- | bmad-sm | SM | Scrum facilitation |
78
- | bmad-analyst | Analyst | Business analysis |
79
-
80
- ### Performance Tips
81
- - Use mode-specific context for focused assistance
82
- - Switch modes when changing task types
83
- - Leverage auto-apply for suggested changes
84
-
85
- ---
86
- *AIOS-FULLSTACK Roo Code Configuration v2.1*
1
+ # Synkra AIOS Development Rules for Roo Code
2
+
3
+ You are working with Synkra AIOS, an AI-Orchestrated System for Full Stack Development.
4
+
5
+ ## Core Framework Understanding
6
+
7
+ Synkra AIOS is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
8
+
9
+ ## Agent System
10
+
11
+ ### Agent Activation (Roo Mode Selector)
12
+ - Use the mode selector in the status bar to switch agents
13
+ - Available modes: bmad-dev, bmad-qa, bmad-architect, bmad-pm, bmad-po, bmad-sm, bmad-analyst
14
+ - Agent commands use the * prefix: *help, *create-story, *task, *exit
15
+
16
+ ### Agent Context
17
+ When an agent mode is active:
18
+ - Follow that agent's specific persona and expertise
19
+ - Use the agent's designated workflow patterns
20
+ - Maintain the agent's perspective throughout the interaction
21
+
22
+ ## Development Methodology
23
+
24
+ ### Story-Driven Development
25
+ 1. **Work from stories** - All development starts with a story in `docs/stories/`
26
+ 2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
27
+ 3. **Track changes** - Maintain the File List section in the story
28
+ 4. **Follow criteria** - Implement exactly what the acceptance criteria specify
29
+
30
+ ### Code Standards
31
+ - Write clean, self-documenting code
32
+ - Follow existing patterns in the codebase
33
+ - Include comprehensive error handling
34
+ - Add unit tests for all new functionality
35
+ - Use TypeScript/JavaScript best practices
36
+
37
+ ### Testing Requirements
38
+ - Run all tests before marking tasks complete
39
+ - Ensure linting passes: `npm run lint`
40
+ - Verify type checking: `npm run typecheck`
41
+ - Add tests for new features
42
+ - Test edge cases and error scenarios
43
+
44
+ ## AIOS Framework Structure
45
+
46
+ ```
47
+ aios-core/
48
+ ├── agents/ # Agent persona definitions (YAML/Markdown)
49
+ ├── tasks/ # Executable task workflows
50
+ ├── workflows/ # Multi-step workflow definitions
51
+ ├── templates/ # Document and code templates
52
+ ├── checklists/ # Validation and review checklists
53
+ └── rules/ # Framework rules and patterns
54
+
55
+ docs/
56
+ ├── stories/ # Development stories (numbered)
57
+ ├── prd/ # Product requirement documents
58
+ ├── architecture/ # System architecture documentation
59
+ └── guides/ # User and developer guides
60
+ ```
61
+
62
+ ## Roo Code-Specific Configuration
63
+
64
+ ### Mode Configuration
65
+ - Modes are defined in `.roomodes` file
66
+ - Each mode corresponds to an AIOS agent persona
67
+ - Switching modes automatically loads the appropriate context
68
+
69
+ ### Available Modes
70
+ | Mode | Agent | Purpose |
71
+ |------|-------|---------|
72
+ | bmad-dev | Developer | Full-stack development |
73
+ | bmad-qa | QA | Quality assurance, testing |
74
+ | bmad-architect | Architect | System design |
75
+ | bmad-pm | PM | Project management |
76
+ | bmad-po | PO | Product ownership |
77
+ | bmad-sm | SM | Scrum facilitation |
78
+ | bmad-analyst | Analyst | Business analysis |
79
+
80
+ ### Performance Tips
81
+ - Use mode-specific context for focused assistance
82
+ - Switch modes when changing task types
83
+ - Leverage auto-apply for suggested changes
84
+
85
+ ---
86
+ *Synkra AIOS Roo Code Configuration v2.1*
@@ -1,104 +1,104 @@
1
- # AIOS-FULLSTACK Development Rules for Trae
2
-
3
- You are working with AIOS-FULLSTACK, an AI-Orchestrated System for Full Stack Development.
4
-
5
- ## Core Framework Understanding
6
-
7
- AIOS-FULLSTACK is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
8
-
9
- ## Agent System
10
-
11
- ### Agent Activation
12
- - Agents are activated with @agent-name syntax: @dev, @qa, @architect, @pm, @po, @sm, @analyst
13
- - The master agent is activated with @aios-master
14
- - Agent commands use the * prefix: *help, *create-story, *task, *exit
15
-
16
- ### Agent Context
17
- When an agent is active:
18
- - Follow that agent's specific persona and expertise
19
- - Use the agent's designated workflow patterns
20
- - Maintain the agent's perspective throughout the interaction
21
-
22
- ## Development Methodology
23
-
24
- ### Story-Driven Development
25
- 1. **Work from stories** - All development starts with a story in `docs/stories/`
26
- 2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
27
- 3. **Track changes** - Maintain the File List section in the story
28
- 4. **Follow criteria** - Implement exactly what the acceptance criteria specify
29
-
30
- ### Code Standards
31
- - Write clean, self-documenting code
32
- - Follow existing patterns in the codebase
33
- - Include comprehensive error handling
34
- - Add unit tests for all new functionality
35
- - Use TypeScript/JavaScript best practices
36
-
37
- ### Testing Requirements
38
- - Run all tests before marking tasks complete
39
- - Ensure linting passes: `npm run lint`
40
- - Verify type checking: `npm run typecheck`
41
- - Add tests for new features
42
- - Test edge cases and error scenarios
43
-
44
- ## AIOS Framework Structure
45
-
46
- ```
47
- aios-core/
48
- ├── agents/ # Agent persona definitions (YAML/Markdown)
49
- ├── tasks/ # Executable task workflows
50
- ├── workflows/ # Multi-step workflow definitions
51
- ├── templates/ # Document and code templates
52
- ├── checklists/ # Validation and review checklists
53
- └── rules/ # Framework rules and patterns
54
-
55
- docs/
56
- ├── stories/ # Development stories (numbered)
57
- ├── prd/ # Product requirement documents
58
- ├── architecture/ # System architecture documentation
59
- └── guides/ # User and developer guides
60
- ```
61
-
62
- ## Workflow Execution
63
-
64
- ### Task Execution Pattern
65
- 1. Read the complete task/workflow definition
66
- 2. Understand all elicitation points
67
- 3. Execute steps sequentially
68
- 4. Handle errors gracefully
69
- 5. Provide clear feedback
70
-
71
- ### Interactive Workflows
72
- - Workflows with `elicit: true` require user input
73
- - Present options clearly
74
- - Validate user responses
75
- - Provide helpful defaults
76
-
77
- ## Best Practices
78
-
79
- ### When implementing features:
80
- - Check existing patterns first
81
- - Reuse components and utilities
82
- - Follow naming conventions
83
- - Keep functions focused and testable
84
- - Document complex logic
85
-
86
- ### When working with agents:
87
- - Respect agent boundaries
88
- - Use appropriate agent for each task
89
- - Follow agent communication patterns
90
- - Maintain agent context
91
-
92
- ## Trae-Specific Configuration
93
-
94
- ### Agent Rules Location
95
- - Rules are stored in `.trae/rules/`
96
- - Use @agent-name to activate agents in chat
97
-
98
- ### Performance Tips
99
- - Use Trae's inline suggestions for quick edits
100
- - Leverage the chat panel for complex discussions
101
- - Use context providers to include relevant files
102
-
103
- ---
104
- *AIOS-FULLSTACK Trae Configuration v2.1*
1
+ # Synkra AIOS Development Rules for Trae
2
+
3
+ You are working with Synkra AIOS, an AI-Orchestrated System for Full Stack Development.
4
+
5
+ ## Core Framework Understanding
6
+
7
+ Synkra AIOS is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
8
+
9
+ ## Agent System
10
+
11
+ ### Agent Activation
12
+ - Agents are activated with @agent-name syntax: @dev, @qa, @architect, @pm, @po, @sm, @analyst
13
+ - The master agent is activated with @aios-master
14
+ - Agent commands use the * prefix: *help, *create-story, *task, *exit
15
+
16
+ ### Agent Context
17
+ When an agent is active:
18
+ - Follow that agent's specific persona and expertise
19
+ - Use the agent's designated workflow patterns
20
+ - Maintain the agent's perspective throughout the interaction
21
+
22
+ ## Development Methodology
23
+
24
+ ### Story-Driven Development
25
+ 1. **Work from stories** - All development starts with a story in `docs/stories/`
26
+ 2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
27
+ 3. **Track changes** - Maintain the File List section in the story
28
+ 4. **Follow criteria** - Implement exactly what the acceptance criteria specify
29
+
30
+ ### Code Standards
31
+ - Write clean, self-documenting code
32
+ - Follow existing patterns in the codebase
33
+ - Include comprehensive error handling
34
+ - Add unit tests for all new functionality
35
+ - Use TypeScript/JavaScript best practices
36
+
37
+ ### Testing Requirements
38
+ - Run all tests before marking tasks complete
39
+ - Ensure linting passes: `npm run lint`
40
+ - Verify type checking: `npm run typecheck`
41
+ - Add tests for new features
42
+ - Test edge cases and error scenarios
43
+
44
+ ## AIOS Framework Structure
45
+
46
+ ```
47
+ aios-core/
48
+ ├── agents/ # Agent persona definitions (YAML/Markdown)
49
+ ├── tasks/ # Executable task workflows
50
+ ├── workflows/ # Multi-step workflow definitions
51
+ ├── templates/ # Document and code templates
52
+ ├── checklists/ # Validation and review checklists
53
+ └── rules/ # Framework rules and patterns
54
+
55
+ docs/
56
+ ├── stories/ # Development stories (numbered)
57
+ ├── prd/ # Product requirement documents
58
+ ├── architecture/ # System architecture documentation
59
+ └── guides/ # User and developer guides
60
+ ```
61
+
62
+ ## Workflow Execution
63
+
64
+ ### Task Execution Pattern
65
+ 1. Read the complete task/workflow definition
66
+ 2. Understand all elicitation points
67
+ 3. Execute steps sequentially
68
+ 4. Handle errors gracefully
69
+ 5. Provide clear feedback
70
+
71
+ ### Interactive Workflows
72
+ - Workflows with `elicit: true` require user input
73
+ - Present options clearly
74
+ - Validate user responses
75
+ - Provide helpful defaults
76
+
77
+ ## Best Practices
78
+
79
+ ### When implementing features:
80
+ - Check existing patterns first
81
+ - Reuse components and utilities
82
+ - Follow naming conventions
83
+ - Keep functions focused and testable
84
+ - Document complex logic
85
+
86
+ ### When working with agents:
87
+ - Respect agent boundaries
88
+ - Use appropriate agent for each task
89
+ - Follow agent communication patterns
90
+ - Maintain agent context
91
+
92
+ ## Trae-Specific Configuration
93
+
94
+ ### Agent Rules Location
95
+ - Rules are stored in `.trae/rules/`
96
+ - Use @agent-name to activate agents in chat
97
+
98
+ ### Performance Tips
99
+ - Use Trae's inline suggestions for quick edits
100
+ - Leverage the chat panel for complex discussions
101
+ - Use context providers to include relevant files
102
+
103
+ ---
104
+ *Synkra AIOS Trae Configuration v2.1*
@@ -1,80 +1,80 @@
1
- # AIOS-FULLSTACK Development Rules for Windsurf
2
-
3
- ## AIOS Agent Integration
4
-
5
- When working with AIOS agents in Windsurf:
6
- - Use `@agent-name` to activate specific agents (e.g., `@dev`, `@qa`, `@architect`)
7
- - Agent commands always start with `*` (e.g., `*help`, `*create-story`)
8
- - Follow the agent's specific workflow and commands
9
-
10
- ## Development Workflow
11
-
12
- ### Story-Driven Development
13
- 1. Stories are your primary work units - always reference the current story
14
- 2. Update story checkboxes as you complete tasks
15
- 3. Keep the File List section updated with all changes
16
- 4. Follow the story's acceptance criteria exactly
17
-
18
- ### Code Standards
19
- - Write clean, self-documenting code
20
- - Follow existing patterns in the codebase
21
- - Add comprehensive error handling
22
- - Include unit tests for new functionality
23
-
24
- ### Testing Requirements
25
- - Run tests before marking any task complete
26
- - Use `npm test` or equivalent for your tech stack
27
- - Ensure all tests pass before updating story status
28
- - Add new tests for new functionality
29
-
30
- ### Documentation
31
- - Update relevant documentation when changing functionality
32
- - Keep README files current
33
- - Document complex logic with clear comments
34
- - Update API documentation for endpoint changes
35
-
36
- ## AIOS-Specific Patterns
37
-
38
- ### Working with Workflows
39
- - Workflows are in `aios-core/workflows/`
40
- - Tasks are in `aios-core/tasks/`
41
- - Follow YAML frontmatter conventions
42
- - Use elicit: true for interactive workflows
43
-
44
- ### Agent Commands
45
- Common commands across agents:
46
- - `*help` - Show available commands
47
- - `*exit` - Exit current agent
48
- - `*task {name}` - Execute specific task
49
- - `*create-doc {template}` - Create document from template
50
-
51
- ### File Organization
52
- ```
53
- project/
54
- ├── aios-core/ # AIOS framework files
55
- │ ├── agents/ # Agent definitions
56
- │ ├── tasks/ # Executable tasks
57
- │ ├── workflows/ # Workflow definitions
58
- │ └── templates/ # Document templates
59
- ├── docs/ # Project documentation
60
- │ ├── stories/ # Development stories
61
- │ └── architecture/ # Architecture docs
62
- └── src/ # Your source code
63
- ```
64
-
65
- ## Best Practices
66
-
67
- 1. **Always backup before major changes**
68
- 2. **Test in isolation before integration**
69
- 3. **Follow the story acceptance criteria**
70
- 4. **Update documentation as you code**
71
- 5. **Communicate blockers immediately**
72
-
73
- ## GitHub Integration
74
- - Ensure GitHub CLI is installed: `gh --version`
75
- - Authenticate before pushing: `gh auth status`
76
- - Follow conventional commit messages
77
- - Reference story IDs in commits
78
-
79
- ---
80
- *AIOS-FULLSTACK Configuration v1.0*
1
+ # Synkra AIOS Development Rules for Windsurf
2
+
3
+ ## AIOS Agent Integration
4
+
5
+ When working with AIOS agents in Windsurf:
6
+ - Use `@agent-name` to activate specific agents (e.g., `@dev`, `@qa`, `@architect`)
7
+ - Agent commands always start with `*` (e.g., `*help`, `*create-story`)
8
+ - Follow the agent's specific workflow and commands
9
+
10
+ ## Development Workflow
11
+
12
+ ### Story-Driven Development
13
+ 1. Stories are your primary work units - always reference the current story
14
+ 2. Update story checkboxes as you complete tasks
15
+ 3. Keep the File List section updated with all changes
16
+ 4. Follow the story's acceptance criteria exactly
17
+
18
+ ### Code Standards
19
+ - Write clean, self-documenting code
20
+ - Follow existing patterns in the codebase
21
+ - Add comprehensive error handling
22
+ - Include unit tests for new functionality
23
+
24
+ ### Testing Requirements
25
+ - Run tests before marking any task complete
26
+ - Use `npm test` or equivalent for your tech stack
27
+ - Ensure all tests pass before updating story status
28
+ - Add new tests for new functionality
29
+
30
+ ### Documentation
31
+ - Update relevant documentation when changing functionality
32
+ - Keep README files current
33
+ - Document complex logic with clear comments
34
+ - Update API documentation for endpoint changes
35
+
36
+ ## AIOS-Specific Patterns
37
+
38
+ ### Working with Workflows
39
+ - Workflows are in `aios-core/workflows/`
40
+ - Tasks are in `aios-core/tasks/`
41
+ - Follow YAML frontmatter conventions
42
+ - Use elicit: true for interactive workflows
43
+
44
+ ### Agent Commands
45
+ Common commands across agents:
46
+ - `*help` - Show available commands
47
+ - `*exit` - Exit current agent
48
+ - `*task {name}` - Execute specific task
49
+ - `*create-doc {template}` - Create document from template
50
+
51
+ ### File Organization
52
+ ```
53
+ project/
54
+ ├── aios-core/ # AIOS framework files
55
+ │ ├── agents/ # Agent definitions
56
+ │ ├── tasks/ # Executable tasks
57
+ │ ├── workflows/ # Workflow definitions
58
+ │ └── templates/ # Document templates
59
+ ├── docs/ # Project documentation
60
+ │ ├── stories/ # Development stories
61
+ │ └── architecture/ # Architecture docs
62
+ └── src/ # Your source code
63
+ ```
64
+
65
+ ## Best Practices
66
+
67
+ 1. **Always backup before major changes**
68
+ 2. **Test in isolation before integration**
69
+ 3. **Follow the story acceptance criteria**
70
+ 4. **Update documentation as you code**
71
+ 5. **Communicate blockers immediately**
72
+
73
+ ## GitHub Integration
74
+ - Ensure GitHub CLI is installed: `gh --version`
75
+ - Authenticate before pushing: `gh auth status`
76
+ - Follow conventional commit messages
77
+ - Reference story IDs in commits
78
+
79
+ ---
80
+ *Synkra AIOS Configuration v1.0*
@@ -1,53 +1,53 @@
1
- ---
2
- template_name: "Indexing Strategy"
3
- template_version: "1.0.0"
4
- output_format: "markdown"
5
- destination: "index-strategy.md"
6
- description: "Purpose-built index plan tied to access patterns"
7
-
8
- sections:
9
- - id: overview
10
- title: "Indexing Overview"
11
- instruction: |
12
- - Goals: latency targets, load profile
13
- - Read/Write trade-offs
14
- - Engine features in use (B-Tree, GIN, GiST, BRIN, partial, covering)
15
- elicit: true
16
-
17
- - id: patterns
18
- title: "Access Patterns Mapping"
19
- instruction: |
20
- For each frequent query:
21
- - Query shape & filters
22
- - ORDER BY requirements
23
- - Estimated cardinality/selectivity
24
- - Proposed index(es) with rationale
25
- elicit: true
26
-
27
- - id: catalog
28
- title: "Index Catalog"
29
- instruction: |
30
- For each table:
31
- ## table_name
32
- - Existing indexes (name → columns, where, include)
33
- - Proposed new indexes
34
- - Partial indexes (predicates)
35
- - Covering indexes (INCLUDE)
36
- - Maintenance notes (bloat risk, reindex cadence)
37
- elicit: true
38
-
39
- - id: fulltext
40
- title: "Full-Text & Search"
41
- instruction: |
42
- - tsvector generated columns
43
- - GIN/Trigram usage
44
- - Ranking functions and query samples
45
- elicit: true
46
-
47
- - id: maintenance
48
- title: "Monitoring & Maintenance"
49
- instruction: |
50
- - pg_stat_user_indexes + idx scan ratio targets
51
- - Unused index detection policy
52
- - Reindex strategy, autovacuum considerations
53
- elicit: true
1
+ ---
2
+ template_name: "Indexing Strategy"
3
+ template_version: "1.0.0"
4
+ output_format: "markdown"
5
+ destination: "index-strategy.md"
6
+ description: "Purpose-built index plan tied to access patterns"
7
+
8
+ sections:
9
+ - id: overview
10
+ title: "Indexing Overview"
11
+ instruction: |
12
+ - Goals: latency targets, load profile
13
+ - Read/Write trade-offs
14
+ - Engine features in use (B-Tree, GIN, GiST, BRIN, partial, covering)
15
+ elicit: true
16
+
17
+ - id: patterns
18
+ title: "Access Patterns Mapping"
19
+ instruction: |
20
+ For each frequent query:
21
+ - Query shape & filters
22
+ - ORDER BY requirements
23
+ - Estimated cardinality/selectivity
24
+ - Proposed index(es) with rationale
25
+ elicit: true
26
+
27
+ - id: catalog
28
+ title: "Index Catalog"
29
+ instruction: |
30
+ For each table:
31
+ ## table_name
32
+ - Existing indexes (name → columns, where, include)
33
+ - Proposed new indexes
34
+ - Partial indexes (predicates)
35
+ - Covering indexes (INCLUDE)
36
+ - Maintenance notes (bloat risk, reindex cadence)
37
+ elicit: true
38
+
39
+ - id: fulltext
40
+ title: "Full-Text & Search"
41
+ instruction: |
42
+ - tsvector generated columns
43
+ - GIN/Trigram usage
44
+ - Ranking functions and query samples
45
+ elicit: true
46
+
47
+ - id: maintenance
48
+ title: "Monitoring & Maintenance"
49
+ instruction: |
50
+ - pg_stat_user_indexes + idx scan ratio targets
51
+ - Unused index detection policy
52
+ - Reindex strategy, autovacuum considerations
53
+ elicit: true