sinapse-ai 5.0.8 → 6.0.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 (660) hide show
  1. package/.claude/CLAUDE.md +1 -1
  2. package/.claude/rules/agent-authority.md +10 -10
  3. package/.claude/rules/agent-memory-imports.md +4 -4
  4. package/.claude/rules/coderabbit-integration.md +4 -4
  5. package/.claude/rules/ids-principles.md +5 -5
  6. package/.claude/rules/story-lifecycle.md +15 -15
  7. package/.claude/rules/workflow-execution.md +11 -11
  8. package/.sinapse-ai/constitution.md +3 -3
  9. package/.sinapse-ai/core/code-intel/helpers/dev-helper.js +1 -1
  10. package/.sinapse-ai/core/code-intel/helpers/qa-helper.js +1 -1
  11. package/.sinapse-ai/core/code-intel/helpers/story-helper.js +7 -7
  12. package/.sinapse-ai/core/config/config-loader.js +1 -1
  13. package/.sinapse-ai/core/docs/session-update-pattern.md +1 -1
  14. package/.sinapse-ai/core/ids/framework-governor.js +4 -4
  15. package/.sinapse-ai/core/ids/index.js +1 -1
  16. package/.sinapse-ai/core/memory/gotchas-memory.js +1 -1
  17. package/.sinapse-ai/core/orchestration/agent-invoker.js +1 -1
  18. package/.sinapse-ai/core/orchestration/bob-surface-criteria.yaml +2 -2
  19. package/.sinapse-ai/core/orchestration/executor-assignment.js +1 -1
  20. package/.sinapse-ai/core/orchestration/executors/epic-6-executor.js +1 -1
  21. package/.sinapse-ai/core/orchestration/executors/epic-executor.js +1 -1
  22. package/.sinapse-ai/core/orchestration/greenfield-handler.js +4 -4
  23. package/.sinapse-ai/core/orchestration/master-orchestrator.js +1 -1
  24. package/.sinapse-ai/core/orchestration/skill-dispatcher.js +3 -3
  25. package/.sinapse-ai/core/orchestration/workflow-executor.js +1 -1
  26. package/.sinapse-ai/core/quality-gates/layer2-pr-automation.js +3 -3
  27. package/.sinapse-ai/core/quality-gates/layer3-human-review.js +1 -1
  28. package/.sinapse-ai/core/quality-gates/quality-gate-config.yaml +1 -1
  29. package/.sinapse-ai/core/session/context-loader.js +1 -1
  30. package/.sinapse-ai/data/agent-config-requirements.yaml +3 -3
  31. package/.sinapse-ai/data/entity-registry.yaml +2126 -2570
  32. package/.sinapse-ai/data/registry-update-log.jsonl +316 -0
  33. package/.sinapse-ai/data/sinapse-kb.md +13 -13
  34. package/.sinapse-ai/data/tech-presets/csharp.md +2 -2
  35. package/.sinapse-ai/data/tech-presets/go.md +2 -2
  36. package/.sinapse-ai/data/tech-presets/java.md +2 -2
  37. package/.sinapse-ai/data/tech-presets/nextjs-react.md +1 -1
  38. package/.sinapse-ai/data/tech-presets/php.md +2 -2
  39. package/.sinapse-ai/data/tech-presets/rust.md +2 -2
  40. package/.sinapse-ai/data/technical-preferences.md +1 -1
  41. package/.sinapse-ai/data/workflow-chains.yaml +15 -15
  42. package/.sinapse-ai/development/README.md +1 -1
  43. package/.sinapse-ai/development/agent-teams/team-qa-focused.yaml +7 -7
  44. package/.sinapse-ai/development/agents/analyst.md +6 -6
  45. package/.sinapse-ai/development/agents/architect.md +4 -4
  46. package/.sinapse-ai/development/agents/data-engineer.md +2 -2
  47. package/.sinapse-ai/development/agents/{dev.md → developer.md} +7 -7
  48. package/.sinapse-ai/development/agents/devops.md +4 -4
  49. package/.sinapse-ai/development/agents/{po → product-lead}/MEMORY.md +3 -3
  50. package/.sinapse-ai/development/agents/{po.md → product-lead.md} +25 -25
  51. package/.sinapse-ai/development/agents/{pm → project-lead}/MEMORY.md +2 -2
  52. package/.sinapse-ai/development/agents/{pm.md → project-lead.md} +15 -15
  53. package/.sinapse-ai/development/agents/{qa.md → quality-gate.md} +8 -8
  54. package/.sinapse-ai/development/agents/{sinapse-master.md → sinapse-orqx.md} +12 -12
  55. package/.sinapse-ai/development/agents/{sm.md → sprint-lead.md} +18 -18
  56. package/.sinapse-ai/development/agents/squad-creator.md +4 -4
  57. package/.sinapse-ai/development/agents/ux-design-expert.md +2 -2
  58. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +1 -1
  59. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +1 -1
  60. package/.sinapse-ai/development/scripts/agent-config-loader.js +1 -1
  61. package/.sinapse-ai/development/scripts/apply-inline-greeting-all-agents.js +1 -1
  62. package/.sinapse-ai/development/scripts/audit-agent-config.js +2 -2
  63. package/.sinapse-ai/development/scripts/batch-update-agents-session-context.js +1 -1
  64. package/.sinapse-ai/development/scripts/dev-context-loader.js +1 -1
  65. package/.sinapse-ai/development/scripts/populate-entity-registry.js +2 -2
  66. package/.sinapse-ai/development/scripts/test-greeting-system.js +4 -4
  67. package/.sinapse-ai/development/scripts/unified-activation-pipeline.js +2 -2
  68. package/.sinapse-ai/development/scripts/verify-workflow-gaps.js +9 -9
  69. package/.sinapse-ai/development/tasks/analyze-cross-artifact.md +1 -1
  70. package/.sinapse-ai/development/tasks/analyze-project-structure.md +4 -4
  71. package/.sinapse-ai/development/tasks/apply-qa-fixes.md +1 -1
  72. package/.sinapse-ai/development/tasks/architect-analyze-impact.md +1 -1
  73. package/.sinapse-ai/development/tasks/brownfield-create-epic.md +10 -10
  74. package/.sinapse-ai/development/tasks/brownfield-create-story.md +1 -1
  75. package/.sinapse-ai/development/tasks/build-autonomous.md +1 -1
  76. package/.sinapse-ai/development/tasks/cleanup-utilities.md +6 -6
  77. package/.sinapse-ai/development/tasks/create-agent.md +1 -1
  78. package/.sinapse-ai/development/tasks/create-brownfield-story.md +4 -4
  79. package/.sinapse-ai/development/tasks/create-next-story.md +12 -12
  80. package/.sinapse-ai/development/tasks/create-service.md +2 -2
  81. package/.sinapse-ai/development/tasks/create-suite.md +1 -1
  82. package/.sinapse-ai/development/tasks/dev-backlog-debt.md +3 -3
  83. package/.sinapse-ai/development/tasks/dev-develop-story.md +5 -5
  84. package/.sinapse-ai/development/tasks/environment-bootstrap.md +2 -2
  85. package/.sinapse-ai/development/tasks/execute-checklist.md +1 -1
  86. package/.sinapse-ai/development/tasks/execute-epic-plan.md +11 -11
  87. package/.sinapse-ai/development/tasks/extract-patterns.md +2 -2
  88. package/.sinapse-ai/development/tasks/facilitate-brainstorming-session.md +2 -2
  89. package/.sinapse-ai/development/tasks/github-devops-github-pr-automation.md +1 -1
  90. package/.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md +1 -1
  91. package/.sinapse-ai/development/tasks/ids-governor.md +3 -3
  92. package/.sinapse-ai/development/tasks/next.md +2 -2
  93. package/.sinapse-ai/development/tasks/orchestrate-resume.md +1 -1
  94. package/.sinapse-ai/development/tasks/orchestrate-status.md +1 -1
  95. package/.sinapse-ai/development/tasks/orchestrate-stop.md +1 -1
  96. package/.sinapse-ai/development/tasks/orchestrate.md +1 -1
  97. package/.sinapse-ai/development/tasks/patterns.md +2 -2
  98. package/.sinapse-ai/development/tasks/plan-create-context.md +2 -2
  99. package/.sinapse-ai/development/tasks/plan-execute-subtask.md +3 -3
  100. package/.sinapse-ai/development/tasks/po-close-story.md +3 -3
  101. package/.sinapse-ai/development/tasks/project-status.md +2 -2
  102. package/.sinapse-ai/development/tasks/qa-after-creation.md +2 -2
  103. package/.sinapse-ai/development/tasks/qa-backlog-add-followup.md +3 -3
  104. package/.sinapse-ai/development/tasks/qa-create-fix-request.md +8 -8
  105. package/.sinapse-ai/development/tasks/qa-evidence-requirements.md +1 -1
  106. package/.sinapse-ai/development/tasks/qa-false-positive-detection.md +1 -1
  107. package/.sinapse-ai/development/tasks/qa-fix-issues.md +10 -10
  108. package/.sinapse-ai/development/tasks/qa-gate.md +3 -3
  109. package/.sinapse-ai/development/tasks/qa-review-build.md +3 -3
  110. package/.sinapse-ai/development/tasks/qa-review-story.md +2 -2
  111. package/.sinapse-ai/development/tasks/qa-run-tests.md +1 -1
  112. package/.sinapse-ai/development/tasks/run-workflow-engine.md +1 -1
  113. package/.sinapse-ai/development/tasks/run-workflow.md +1 -1
  114. package/.sinapse-ai/development/tasks/security-scan.md +2 -2
  115. package/.sinapse-ai/development/tasks/setup-llm-routing.md +1 -1
  116. package/.sinapse-ai/development/tasks/spec-critique.md +4 -4
  117. package/.sinapse-ai/development/tasks/spec-gather-requirements.md +4 -4
  118. package/.sinapse-ai/development/tasks/spec-write-spec.md +2 -2
  119. package/.sinapse-ai/development/tasks/story-checkpoint.md +3 -3
  120. package/.sinapse-ai/development/tasks/sync-registry-intel.md +1 -1
  121. package/.sinapse-ai/development/tasks/validate-agents.md +1 -1
  122. package/.sinapse-ai/development/tasks/validate-next-story.md +10 -10
  123. package/.sinapse-ai/development/tasks/validate-workflow.md +1 -1
  124. package/.sinapse-ai/development/tasks/verify-subtask.md +2 -2
  125. package/.sinapse-ai/development/templates/code-intel-integration-pattern.md +3 -3
  126. package/.sinapse-ai/development/templates/subagent-step-prompt.md +2 -2
  127. package/.sinapse-ai/development/workflows/README.md +2 -2
  128. package/.sinapse-ai/development/workflows/auto-worktree.yaml +5 -5
  129. package/.sinapse-ai/development/workflows/brownfield-discovery.yaml +11 -11
  130. package/.sinapse-ai/development/workflows/brownfield-fullstack.yaml +6 -6
  131. package/.sinapse-ai/development/workflows/brownfield-service.yaml +5 -5
  132. package/.sinapse-ai/development/workflows/brownfield-ui.yaml +5 -5
  133. package/.sinapse-ai/development/workflows/development-cycle.yaml +10 -10
  134. package/.sinapse-ai/development/workflows/epic-orchestration.yaml +6 -6
  135. package/.sinapse-ai/development/workflows/greenfield-fullstack.yaml +7 -7
  136. package/.sinapse-ai/development/workflows/greenfield-service.yaml +5 -5
  137. package/.sinapse-ai/development/workflows/greenfield-ui.yaml +5 -5
  138. package/.sinapse-ai/development/workflows/qa-loop.yaml +1 -1
  139. package/.sinapse-ai/development/workflows/spec-pipeline.yaml +2 -2
  140. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +1 -1
  141. package/.sinapse-ai/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +2 -2
  142. package/.sinapse-ai/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +1 -1
  143. package/.sinapse-ai/docs/standards/QUALITY-GATES-SPECIFICATION.md +1 -1
  144. package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md +6 -6
  145. package/.sinapse-ai/docs/standards/STANDARDS-INDEX.md +2 -2
  146. package/.sinapse-ai/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +6 -6
  147. package/.sinapse-ai/infrastructure/scripts/config-loader.js +2 -2
  148. package/.sinapse-ai/infrastructure/scripts/gotchas-documenter.js +1 -1
  149. package/.sinapse-ai/infrastructure/scripts/ide-sync/README.md +3 -3
  150. package/.sinapse-ai/infrastructure/scripts/ide-sync/gemini-commands.js +1 -1
  151. package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +2 -2
  152. package/.sinapse-ai/infrastructure/scripts/ide-sync/redirect-generator.js +2 -2
  153. package/.sinapse-ai/infrastructure/scripts/migrate-agent.js +1 -1
  154. package/.sinapse-ai/infrastructure/scripts/performance-tracker.js +2 -2
  155. package/.sinapse-ai/infrastructure/scripts/qa-report-generator.js +1 -1
  156. package/.sinapse-ai/infrastructure/scripts/recovery-tracker.js +1 -1
  157. package/.sinapse-ai/infrastructure/scripts/rollback-manager.js +1 -1
  158. package/.sinapse-ai/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +1 -1
  159. package/.sinapse-ai/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +1 -1
  160. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +1 -1
  161. package/.sinapse-ai/install-manifest.yaml +344 -344
  162. package/.sinapse-ai/monitor/hooks/lib/enrich.py +1 -1
  163. package/.sinapse-ai/product/checklists/self-critique-checklist.md +1 -1
  164. package/.sinapse-ai/product/checklists/story-draft-checklist.md +3 -3
  165. package/.sinapse-ai/product/templates/command-rationalization-matrix.md +3 -3
  166. package/.sinapse-ai/product/templates/design-story-tmpl.yaml +4 -4
  167. package/.sinapse-ai/product/templates/ide-rules/antigravity-rules.md +1 -1
  168. package/.sinapse-ai/product/templates/ide-rules/claude-rules.md +2 -2
  169. package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +6 -6
  170. package/.sinapse-ai/product/templates/ide-rules/cursor-rules.md +1 -1
  171. package/.sinapse-ai/product/templates/personalized-agent-template.md +1 -1
  172. package/.sinapse-ai/product/templates/personalized-task-template.md +1 -1
  173. package/.sinapse-ai/product/templates/personalized-template-file.yaml +1 -1
  174. package/.sinapse-ai/product/templates/personalized-workflow-template.yaml +3 -3
  175. package/.sinapse-ai/product/templates/story-tmpl.yaml +8 -8
  176. package/.sinapse-ai/schemas/README.md +15 -15
  177. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +2 -2
  178. package/.sinapse-ai/user-guide.md +4 -4
  179. package/.sinapse-ai/working-in-the-brownfield.md +3 -3
  180. package/LICENSE +4 -4
  181. package/README.en.md +6 -6
  182. package/README.md +8 -8
  183. package/bin/cli.js +9 -9
  184. package/bin/sinapse.js +17 -0
  185. package/docs/00-shared-activation-pipeline.md +16 -16
  186. package/docs/FEATURE_PROCESS.md +1 -1
  187. package/docs/ORQX-PLAN.md +264 -0
  188. package/docs/core-architecture.md +2 -2
  189. package/docs/en/sinapse-agent-flows/README.md +2 -2
  190. package/docs/en/sinapse-agent-flows/dev-system.md +2 -2
  191. package/docs/en/sinapse-agent-flows/pm-system.md +2 -2
  192. package/docs/en/sinapse-agent-flows/qa-system.md +2 -2
  193. package/docs/en/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +5 -5
  194. package/docs/en/sinapse-agent-flows/sm-system.md +2 -2
  195. package/docs/framework/entity-layer-classification.md +2 -2
  196. package/docs/framework/source-tree.md +17 -17
  197. package/docs/getting-started.md +13 -13
  198. package/docs/guides/IDS-CONCEITOS-EXPLICADOS.md +17 -17
  199. package/docs/guides/MEMORY-INTEGRATION.md +3 -3
  200. package/docs/guides/MEMORY-INTELLIGENCE-SYSTEM.md +4 -4
  201. package/docs/guides/ade-guide.md +25 -25
  202. package/docs/guides/agent-selection-guide.md +36 -36
  203. package/docs/guides/agents/ANALYST-SYSTEM.md +5 -5
  204. package/docs/guides/agents/ARCHITECT-SYSTEM.md +9 -9
  205. package/docs/guides/agents/DATA-ENGINEER-SYSTEM.md +8 -8
  206. package/docs/guides/agents/DEV-SYSTEM.md +27 -27
  207. package/docs/guides/agents/DEVOPS-SYSTEM.md +5 -5
  208. package/docs/guides/agents/PM-SYSTEM.md +24 -24
  209. package/docs/guides/agents/QA-SYSTEM.md +24 -24
  210. package/docs/guides/agents/SINAPSE-MASTER-SYSTEM.md +26 -26
  211. package/docs/guides/agents/SM-SYSTEM.md +31 -31
  212. package/docs/guides/agents/SQUAD-CREATOR-SYSTEM.md +2 -2
  213. package/docs/guides/agents/UX-DESIGN-EXPERT-SYSTEM.md +10 -10
  214. package/docs/guides/agents/traces/00-shared-activation-pipeline.md +16 -16
  215. package/docs/guides/agents/traces/00-shared-activation-pipeline.v1-act8.md +16 -16
  216. package/docs/guides/agents/traces/README.md +20 -20
  217. package/docs/guides/agents/traces/analyst-execution-trace.md +6 -6
  218. package/docs/guides/agents/traces/architect-execution-trace.md +3 -3
  219. package/docs/guides/agents/traces/data-engineer-execution-trace.md +4 -4
  220. package/docs/guides/agents/traces/dev-execution-trace.md +12 -12
  221. package/docs/guides/agents/traces/devops-execution-trace.md +6 -6
  222. package/docs/guides/agents/traces/pm-execution-trace.md +14 -14
  223. package/docs/guides/agents/traces/po-execution-trace.md +17 -17
  224. package/docs/guides/agents/traces/qa-execution-trace.md +15 -15
  225. package/docs/guides/agents/traces/{sinapse-master-execution-trace.md → sinapse-orqx-execution-trace.md} +22 -22
  226. package/docs/guides/agents/traces/sm-execution-trace.md +15 -15
  227. package/docs/guides/agents/traces/squad-creation-execution-trace.md +9 -9
  228. package/docs/guides/agents/traces/ux-design-expert-execution-trace.md +4 -4
  229. package/docs/guides/api-reference.md +27 -27
  230. package/docs/guides/coderabbit/README.md +9 -9
  231. package/docs/guides/contextual-greeting-system-guide.md +5 -5
  232. package/docs/guides/development-setup.md +1 -1
  233. package/docs/guides/project-status-feature.md +2 -2
  234. package/docs/guides/quality-dashboard.md +2 -2
  235. package/docs/guides/quality-gates.md +6 -6
  236. package/docs/guides/template-engine-v2.md +2 -2
  237. package/docs/guides/user-guide.md +13 -13
  238. package/docs/guides/workflows/AUTO-WORKTREE-WORKFLOW.md +3 -3
  239. package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md +6 -6
  240. package/docs/guides/workflows/BROWNFIELD-FULLSTACK-WORKFLOW.md +30 -30
  241. package/docs/guides/workflows/BROWNFIELD-SERVICE-WORKFLOW.md +38 -38
  242. package/docs/guides/workflows/BROWNFIELD-UI-WORKFLOW.md +25 -25
  243. package/docs/guides/workflows/GREENFIELD-FULLSTACK-WORKFLOW.md +37 -37
  244. package/docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md +5 -5
  245. package/docs/guides/workflows/GREENFIELD-UI-WORKFLOW.md +19 -19
  246. package/docs/guides/workflows/QA-LOOP-WORKFLOW.md +13 -13
  247. package/docs/guides/workflows/SINAPSE-COMPLETE-CROSS-REFERENCE-ANALYSIS.md +19 -19
  248. package/docs/guides/workflows/SPEC-PIPELINE-WORKFLOW.md +25 -25
  249. package/docs/guides/workflows/STORY-DEVELOPMENT-CYCLE-WORKFLOW.md +28 -28
  250. package/docs/guides/workflows/WORKFLOW-TASK-AGENT-ANALYSIS.md +94 -94
  251. package/docs/guides/workflows/xref-phase2-templates.md +29 -29
  252. package/docs/guides/workflows/xref-phase3-scripts.md +33 -33
  253. package/docs/guides/workflows/xref-phase4-infra.md +2 -2
  254. package/docs/guides/workflows/xref-phase6-supporting.md +1 -1
  255. package/docs/guides/workflows-guide.md +2 -2
  256. package/docs/installation/faq.md +1 -1
  257. package/docs/installation/troubleshooting.md +2 -2
  258. package/docs/installation/v4-quick-start.md +2 -2
  259. package/docs/prd-cli-graph-dashboard.md +1 -1
  260. package/docs/pt/DOCUMENTATION-ROADMAP.md +1 -1
  261. package/docs/pt/FEATURE_PROCESS.md +1 -1
  262. package/docs/pt/README.md +2 -2
  263. package/docs/pt/agents/archetype-rationale.md +4 -4
  264. package/docs/pt/agents/persona-definitions.md +9 -9
  265. package/docs/pt/architecture/ADE-ARCHITECT-HANDOFF.md +15 -15
  266. package/docs/pt/architecture/ADE-EPIC1-HANDOFF.md +2 -2
  267. package/docs/pt/architecture/ADE-EPIC2-HANDOFF.md +2 -2
  268. package/docs/pt/architecture/ADE-EPIC3-HANDOFF.md +8 -8
  269. package/docs/pt/architecture/ade-architecture.md +4 -4
  270. package/docs/pt/architecture/adr/adr-hcs-health-check-system.md +3 -3
  271. package/docs/pt/architecture/agent-config-audit.md +4 -4
  272. package/docs/pt/architecture/agent-responsibility-matrix.md +20 -20
  273. package/docs/pt/architecture/agent-tool-integration-guide.md +8 -8
  274. package/docs/pt/architecture/contribution-workflow-research.md +1 -1
  275. package/docs/pt/architecture/dashboard-architecture.md +1 -1
  276. package/docs/pt/architecture/hcs-check-specifications.md +1 -1
  277. package/docs/pt/architecture/hcs-execution-modes.md +1 -1
  278. package/docs/pt/architecture/hcs-self-healing-spec.md +1 -1
  279. package/docs/pt/architecture/high-level-architecture.md +1 -1
  280. package/docs/pt/architecture/module-system.md +1 -1
  281. package/docs/pt/architecture/source-tree.md +1 -1
  282. package/docs/pt/architecture/squad-improvement-recommended-approach.md +2 -2
  283. package/docs/pt/architecture/utility-integration-guide.md +2 -2
  284. package/docs/pt/contributing.md +1 -1
  285. package/docs/pt/core-architecture.md +2 -2
  286. package/docs/pt/framework/source-tree.md +1 -1
  287. package/docs/pt/guides/ade-guide.md +25 -25
  288. package/docs/pt/guides/agent-selection-guide.md +36 -36
  289. package/docs/pt/guides/api-reference.md +25 -25
  290. package/docs/pt/guides/contextual-greeting-system-guide.md +5 -5
  291. package/docs/pt/guides/development-setup.md +1 -1
  292. package/docs/pt/guides/project-status-feature.md +2 -2
  293. package/docs/pt/guides/quality-dashboard.md +2 -2
  294. package/docs/pt/guides/quality-gates.md +6 -6
  295. package/docs/pt/guides/template-engine-v2.md +2 -2
  296. package/docs/pt/guides/user-guide.md +8 -8
  297. package/docs/pt/guides/workflows-guide.md +2 -2
  298. package/docs/pt/installation/faq.md +1 -1
  299. package/docs/pt/installation/troubleshooting.md +2 -2
  300. package/docs/pt/installation/v4-quick-start.md +2 -2
  301. package/docs/pt/platforms/antigravity.md +9 -9
  302. package/docs/pt/platforms/cursor.md +15 -15
  303. package/docs/pt/platforms/gemini-cli.md +3 -3
  304. package/docs/pt/roadmap.md +1 -1
  305. package/docs/pt/sinapse-nomenclature-specification.md +15 -15
  306. package/docs/pt/specifications/docs-agent-technical-specification.md +11 -11
  307. package/docs/roadmap.md +1 -1
  308. package/docs/sinapse-agent-flows/README.md +2 -2
  309. package/docs/sinapse-agent-flows/analyst-system.md +5 -5
  310. package/docs/sinapse-agent-flows/architect-system.md +9 -9
  311. package/docs/sinapse-agent-flows/data-engineer-system.md +8 -8
  312. package/docs/sinapse-agent-flows/dev-system.md +27 -27
  313. package/docs/sinapse-agent-flows/devops-system.md +5 -5
  314. package/docs/sinapse-agent-flows/pm-system.md +24 -24
  315. package/docs/sinapse-agent-flows/qa-system.md +24 -24
  316. package/docs/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +26 -26
  317. package/docs/sinapse-agent-flows/sm-system.md +31 -31
  318. package/docs/sinapse-agent-flows/squad-creator-system.md +2 -2
  319. package/docs/sinapse-agent-flows/ux-design-expert-system.md +10 -10
  320. package/docs/sinapse-workflows/auto-worktree-workflow.md +3 -3
  321. package/docs/sinapse-workflows/brownfield-discovery-workflow.md +6 -6
  322. package/docs/sinapse-workflows/brownfield-fullstack-workflow.md +30 -30
  323. package/docs/sinapse-workflows/brownfield-service-workflow.md +38 -38
  324. package/docs/sinapse-workflows/brownfield-ui-workflow.md +25 -25
  325. package/docs/sinapse-workflows/greenfield-fullstack-workflow.md +37 -37
  326. package/docs/sinapse-workflows/greenfield-service-workflow.md +5 -5
  327. package/docs/sinapse-workflows/greenfield-ui-workflow.md +19 -19
  328. package/docs/sinapse-workflows/qa-loop-workflow.md +13 -13
  329. package/docs/sinapse-workflows/spec-pipeline-workflow.md +25 -25
  330. package/docs/sinapse-workflows/story-development-cycle-workflow.md +28 -28
  331. package/package.json +1 -1
  332. package/packages/gemini-sinapse-extension/README.md +1 -1
  333. package/packages/gemini-sinapse-extension/commands/lib/agent-launcher.js +1 -1
  334. package/packages/gemini-sinapse-extension/commands/{sinapse-master.js → sinapse-orqx.js} +1 -1
  335. package/packages/gemini-sinapse-extension/extension.json +3 -3
  336. package/packages/gemini-sinapse-extension/gemini-extension.json +3 -3
  337. package/packages/installer/src/config/configure-environment.js +2 -2
  338. package/packages/installer/src/updater/index.js +105 -0
  339. package/packages/installer/src/wizard/feedback.js +38 -30
  340. package/packages/installer/src/wizard/i18n.js +25 -182
  341. package/packages/installer/src/wizard/ide-config-generator.js +1 -1
  342. package/packages/installer/src/wizard/index.js +253 -69
  343. package/packages/installer/src/wizard/questions.js +35 -7
  344. package/packages/installer/tests/unit/artifact-copy-pipeline/artifact-copy-pipeline.test.js +1 -1
  345. package/packages/sinapse-install/README.md +1 -1
  346. package/packages/sinapse-install/src/installer.js +1 -1
  347. package/scripts/package-synapse.js +1 -1
  348. package/sinapse/agents/{sinapse-master.md → sinapse-orqx.md} +16 -16
  349. package/sinapse/knowledge-base/cross-squad-patterns.md +1 -1
  350. package/sinapse/knowledge-base/routing-catalog.md +1 -1
  351. package/sinapse/squad.yaml +1 -1
  352. package/sinapse/tasks/compose-multi-squad-plan.md +2 -2
  353. package/sinapse/tasks/coordinate-cross-squad.md +2 -2
  354. package/sinapse/tasks/diagnose-and-route.md +2 -2
  355. package/sinapse/tasks/onboard-user.md +2 -2
  356. package/sinapse/tasks/resolve-conflict.md +2 -2
  357. package/sinapse/tasks/squad-status-report.md +2 -2
  358. package/sinapse/tasks/strategic-brief.md +3 -3
  359. package/squads/squad-animations/agents/animations-orqx.md +2 -2
  360. package/squads/squad-brand/agents/brand-creative-engineer.md +1 -1
  361. package/squads/squad-brand/agents/brand-motion-vfx.md +1 -1
  362. package/squads/squad-brand/agents/brand-orqx.md +2 -2
  363. package/squads/squad-brand/agents/brand-sonic-designer.md +1 -1
  364. package/squads/squad-brand/agents/brand-system-architect.md +1 -1
  365. package/squads/squad-claude/agents/claude-orqx.md +2 -2
  366. package/squads/squad-cloning/agents/cloning-orqx.md +3 -3
  367. package/squads/squad-commercial/agents/commercial-orqx.md +1 -1
  368. package/squads/squad-commercial/agents/cs-business-auditor.md +1 -1
  369. package/squads/squad-commercial/agents/cs-client-success.md +1 -1
  370. package/squads/squad-commercial/agents/cs-crm-specialist.md +1 -1
  371. package/squads/squad-commercial/agents/cs-funnel-architect.md +1 -1
  372. package/squads/squad-commercial/agents/cs-lead-generation-strategist.md +1 -1
  373. package/squads/squad-commercial/agents/cs-offer-designer.md +1 -1
  374. package/squads/squad-commercial/agents/cs-revops-analyst.md +1 -1
  375. package/squads/squad-commercial/agents/cs-sales-closer.md +1 -1
  376. package/squads/squad-commercial/agents/cs-sales-enablement.md +1 -1
  377. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +1 -1
  378. package/squads/squad-content/agents/content-orqx.md +2 -2
  379. package/squads/squad-content/knowledge-base/ai-leverage-content-framework.md +1 -1
  380. package/squads/squad-copy/agents/copy-strategist.md +3 -3
  381. package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +1 -1
  382. package/squads/squad-council/agents/council-orqx.md +1 -1
  383. package/squads/squad-courses/agents/courses-orqx.md +1 -1
  384. package/squads/squad-cybersecurity/agents/cyber-orqx.md +2 -2
  385. package/squads/squad-design/agents/design-orqx.md +2 -2
  386. package/squads/squad-finance/agents/finance-orqx.md +2 -2
  387. package/squads/squad-growth/agents/growth-orqx.md +2 -2
  388. package/squads/squad-paidmedia/agents/paidmedia-orqx.md +2 -2
  389. package/squads/squad-product/agents/product-orqx.md +2 -2
  390. package/squads/squad-research/agents/research-orqx.md +2 -2
  391. package/squads/squad-research/tasks/create-executive-briefing.md +1 -1
  392. package/squads/squad-research/tasks/create-insight-deck.md +1 -1
  393. package/squads/squad-research/tasks/forecast-industry-trends.md +1 -1
  394. package/squads/squad-research/tasks/generate-actionable-recommendations.md +2 -2
  395. package/squads/squad-research/tasks/run-scenario-planning.md +2 -2
  396. package/squads/squad-research/tasks/synthesize-research-report.md +2 -2
  397. package/squads/squad-research/tasks/track-emerging-technologies.md +1 -1
  398. package/squads/squad-storytelling/agents/storytelling-orqx.md +2 -2
  399. package/docs/es/CHANGELOG.md +0 -117
  400. package/docs/es/DOCUMENTATION-ROADMAP.md +0 -216
  401. package/docs/es/ENVIRONMENT.md +0 -140
  402. package/docs/es/FEATURE_PROCESS.md +0 -99
  403. package/docs/es/GUIDING-PRINCIPLES.md +0 -101
  404. package/docs/es/README.md +0 -134
  405. package/docs/es/agent-reference-guide.md +0 -570
  406. package/docs/es/agents/archetype-rationale.md +0 -566
  407. package/docs/es/agents/persona-definitions.md +0 -501
  408. package/docs/es/api/squads-api.md +0 -753
  409. package/docs/es/architecture/ADE-AGENT-CHANGES.md +0 -469
  410. package/docs/es/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
  411. package/docs/es/architecture/ADE-EPIC1-HANDOFF.md +0 -85
  412. package/docs/es/architecture/ADE-EPIC2-HANDOFF.md +0 -106
  413. package/docs/es/architecture/ADE-EPIC3-HANDOFF.md +0 -327
  414. package/docs/es/architecture/ARCHITECTURE-INDEX.md +0 -188
  415. package/docs/es/architecture/ade-architecture.md +0 -586
  416. package/docs/es/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
  417. package/docs/es/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
  418. package/docs/es/architecture/adr/adr-hcs-health-check-system.md +0 -489
  419. package/docs/es/architecture/adr/adr-isolated-vm-decision.md +0 -70
  420. package/docs/es/architecture/agent-config-audit.md +0 -222
  421. package/docs/es/architecture/agent-responsibility-matrix.md +0 -444
  422. package/docs/es/architecture/agent-tool-integration-guide.md +0 -334
  423. package/docs/es/architecture/ci-cd.md +0 -151
  424. package/docs/es/architecture/coding-standards.md +0 -896
  425. package/docs/es/architecture/contribution-workflow-research.md +0 -376
  426. package/docs/es/architecture/dashboard-architecture.md +0 -926
  427. package/docs/es/architecture/dashboard-realtime.md +0 -1253
  428. package/docs/es/architecture/hcs-check-specifications.md +0 -897
  429. package/docs/es/architecture/hcs-execution-modes.md +0 -519
  430. package/docs/es/architecture/hcs-self-healing-spec.md +0 -695
  431. package/docs/es/architecture/high-level-architecture.md +0 -357
  432. package/docs/es/architecture/introduction.md +0 -21
  433. package/docs/es/architecture/mcp-api-keys-management.md +0 -246
  434. package/docs/es/architecture/mcp-system-diagrams.md +0 -113
  435. package/docs/es/architecture/module-system.md +0 -382
  436. package/docs/es/architecture/multi-repo-strategy.md +0 -390
  437. package/docs/es/architecture/source-tree.md +0 -708
  438. package/docs/es/architecture/squad-improvement-analysis.md +0 -204
  439. package/docs/es/architecture/squad-improvement-recommended-approach.md +0 -390
  440. package/docs/es/architecture/tech-stack.md +0 -806
  441. package/docs/es/architecture/utility-integration-guide.md +0 -358
  442. package/docs/es/community/README-community-snippet-core.md +0 -57
  443. package/docs/es/community/README-community-snippet-mcp.md +0 -49
  444. package/docs/es/community/README-community-snippet-squads.md +0 -40
  445. package/docs/es/community.md +0 -227
  446. package/docs/es/core-architecture.md +0 -229
  447. package/docs/es/docker-mcp-setup.md +0 -426
  448. package/docs/es/framework/README.md +0 -99
  449. package/docs/es/framework/coding-standards.md +0 -892
  450. package/docs/es/framework/source-tree.md +0 -725
  451. package/docs/es/framework/tech-stack.md +0 -802
  452. package/docs/es/getting-started.md +0 -572
  453. package/docs/es/git-workflow-guide.md +0 -995
  454. package/docs/es/guides/README.md +0 -133
  455. package/docs/es/guides/ade-guide.md +0 -452
  456. package/docs/es/guides/agent-selection-guide.md +0 -295
  457. package/docs/es/guides/api-reference.md +0 -899
  458. package/docs/es/guides/build-recovery-guide.md +0 -270
  459. package/docs/es/guides/contextual-greeting-system-guide.md +0 -387
  460. package/docs/es/guides/contributing-squads.md +0 -256
  461. package/docs/es/guides/development-setup.md +0 -1111
  462. package/docs/es/guides/ide-sync-guide.md +0 -194
  463. package/docs/es/guides/installation-troubleshooting.md +0 -327
  464. package/docs/es/guides/llm-routing.md +0 -312
  465. package/docs/es/guides/mcp/desktop-commander.md +0 -368
  466. package/docs/es/guides/mcp/docker-gateway-tutorial.md +0 -336
  467. package/docs/es/guides/mcp-global-setup.md +0 -663
  468. package/docs/es/guides/permission-modes.md +0 -313
  469. package/docs/es/guides/project-status-feature.md +0 -473
  470. package/docs/es/guides/quality-dashboard.md +0 -367
  471. package/docs/es/guides/quality-gates.md +0 -614
  472. package/docs/es/guides/security-hardening.md +0 -1359
  473. package/docs/es/guides/service-discovery.md +0 -524
  474. package/docs/es/guides/squad-examples/README.md +0 -64
  475. package/docs/es/guides/squad-migration.md +0 -356
  476. package/docs/es/guides/squads-guide.md +0 -836
  477. package/docs/es/guides/squads-overview.md +0 -332
  478. package/docs/es/guides/template-engine-v2.md +0 -484
  479. package/docs/es/guides/testing-guide.md +0 -1215
  480. package/docs/es/guides/user-guide.md +0 -452
  481. package/docs/es/guides/workflows-guide.md +0 -400
  482. package/docs/es/how-to-contribute-with-pull-requests.md +0 -160
  483. package/docs/es/ide-integration.md +0 -425
  484. package/docs/es/installation/README.md +0 -108
  485. package/docs/es/installation/faq.md +0 -616
  486. package/docs/es/installation/linux.md +0 -311
  487. package/docs/es/installation/macos.md +0 -189
  488. package/docs/es/installation/troubleshooting.md +0 -735
  489. package/docs/es/installation/v4-quick-start.md +0 -269
  490. package/docs/es/installation/windows.md +0 -342
  491. package/docs/es/meta-agent-commands.md +0 -990
  492. package/docs/es/migration-guide.md +0 -310
  493. package/docs/es/npx-install.md +0 -193
  494. package/docs/es/performance-tuning-guide.md +0 -707
  495. package/docs/es/platforms/README.md +0 -283
  496. package/docs/es/platforms/antigravity.md +0 -510
  497. package/docs/es/platforms/claude-code.md +0 -650
  498. package/docs/es/platforms/cursor.md +0 -635
  499. package/docs/es/platforms/gemini-cli.md +0 -483
  500. package/docs/es/platforms/github-copilot.md +0 -480
  501. package/docs/es/roadmap.md +0 -119
  502. package/docs/es/security-best-practices.md +0 -613
  503. package/docs/es/security.md +0 -124
  504. package/docs/es/sinapse-agent-flows/README.md +0 -190
  505. package/docs/es/sinapse-agent-flows/analyst-system.md +0 -36
  506. package/docs/es/sinapse-agent-flows/architect-system.md +0 -36
  507. package/docs/es/sinapse-agent-flows/data-engineer-system.md +0 -36
  508. package/docs/es/sinapse-agent-flows/dev-system.md +0 -36
  509. package/docs/es/sinapse-agent-flows/devops-system.md +0 -36
  510. package/docs/es/sinapse-agent-flows/pm-system.md +0 -36
  511. package/docs/es/sinapse-agent-flows/qa-system.md +0 -36
  512. package/docs/es/sinapse-agent-flows/sinapse-master-system.md +0 -36
  513. package/docs/es/sinapse-agent-flows/sm-system.md +0 -36
  514. package/docs/es/sinapse-agent-flows/squad-creator-system.md +0 -36
  515. package/docs/es/sinapse-agent-flows/ux-design-expert-system.md +0 -36
  516. package/docs/es/sinapse-nomenclature-specification.md +0 -673
  517. package/docs/es/sinapse-workflows/README.md +0 -247
  518. package/docs/es/sinapse-workflows/auto-worktree-workflow.md +0 -39
  519. package/docs/es/sinapse-workflows/brownfield-discovery-workflow.md +0 -41
  520. package/docs/es/sinapse-workflows/brownfield-fullstack-workflow.md +0 -42
  521. package/docs/es/sinapse-workflows/brownfield-service-workflow.md +0 -43
  522. package/docs/es/sinapse-workflows/brownfield-ui-workflow.md +0 -42
  523. package/docs/es/sinapse-workflows/design-system-build-quality-workflow.md +0 -40
  524. package/docs/es/sinapse-workflows/greenfield-fullstack-workflow.md +0 -44
  525. package/docs/es/sinapse-workflows/greenfield-service-workflow.md +0 -43
  526. package/docs/es/sinapse-workflows/greenfield-ui-workflow.md +0 -43
  527. package/docs/es/sinapse-workflows/qa-loop-workflow.md +0 -39
  528. package/docs/es/sinapse-workflows/spec-pipeline-workflow.md +0 -40
  529. package/docs/es/sinapse-workflows/story-development-cycle-workflow.md +0 -42
  530. package/docs/es/specifications/docs-agent-technical-specification.md +0 -2161
  531. package/docs/es/troubleshooting.md +0 -887
  532. package/docs/es/uninstallation.md +0 -556
  533. package/docs/es/versioning-and-releases.md +0 -146
  534. package/docs/zh/CHANGELOG.md +0 -191
  535. package/docs/zh/ENVIRONMENT.md +0 -136
  536. package/docs/zh/FEATURE_PROCESS.md +0 -92
  537. package/docs/zh/GLOSSARY.md +0 -179
  538. package/docs/zh/GUIDING-PRINCIPLES.md +0 -97
  539. package/docs/zh/README.md +0 -133
  540. package/docs/zh/TRANSLATION-PLAN.md +0 -508
  541. package/docs/zh/agent-reference-guide.md +0 -566
  542. package/docs/zh/agents/archetype-rationale.md +0 -631
  543. package/docs/zh/agents/persona-definitions.md +0 -560
  544. package/docs/zh/api/squads-api.md +0 -753
  545. package/docs/zh/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
  546. package/docs/zh/architecture/ADE-EPIC1-HANDOFF.md +0 -85
  547. package/docs/zh/architecture/ADE-EPIC2-HANDOFF.md +0 -106
  548. package/docs/zh/architecture/ADE-EPIC3-HANDOFF.md +0 -327
  549. package/docs/zh/architecture/ARCHITECTURE-INDEX.md +0 -190
  550. package/docs/zh/architecture/SINAPSE-VISUAL-OVERVIEW.md +0 -595
  551. package/docs/zh/architecture/ade-architecture.md +0 -474
  552. package/docs/zh/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
  553. package/docs/zh/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
  554. package/docs/zh/architecture/adr/adr-hcs-health-check-system.md +0 -489
  555. package/docs/zh/architecture/adr/adr-isolated-vm-decision.md +0 -70
  556. package/docs/zh/architecture/agent-config-audit.md +0 -220
  557. package/docs/zh/architecture/agent-responsibility-matrix.md +0 -444
  558. package/docs/zh/architecture/agent-tool-integration-guide.md +0 -336
  559. package/docs/zh/architecture/ci-cd.md +0 -151
  560. package/docs/zh/architecture/coding-standards.md +0 -898
  561. package/docs/zh/architecture/command-authority-matrix.md +0 -18
  562. package/docs/zh/architecture/contribution-workflow-research.md +0 -376
  563. package/docs/zh/architecture/dashboard-architecture.md +0 -569
  564. package/docs/zh/architecture/dashboard-realtime.md +0 -415
  565. package/docs/zh/architecture/hcs-check-specifications.md +0 -102
  566. package/docs/zh/architecture/hcs-execution-modes.md +0 -114
  567. package/docs/zh/architecture/hcs-self-healing-spec.md +0 -148
  568. package/docs/zh/architecture/high-level-architecture.md +0 -355
  569. package/docs/zh/architecture/introduction.md +0 -21
  570. package/docs/zh/architecture/mcp-api-keys-management.md +0 -248
  571. package/docs/zh/architecture/mcp-system-diagrams.md +0 -113
  572. package/docs/zh/architecture/module-system.md +0 -382
  573. package/docs/zh/architecture/multi-repo-strategy.md +0 -237
  574. package/docs/zh/architecture/source-tree.md +0 -710
  575. package/docs/zh/architecture/squad-improvement-analysis.md +0 -204
  576. package/docs/zh/architecture/squad-improvement-recommended-approach.md +0 -390
  577. package/docs/zh/architecture/tech-stack.md +0 -808
  578. package/docs/zh/architecture/utility-integration-guide.md +0 -358
  579. package/docs/zh/code-of-conduct.md +0 -113
  580. package/docs/zh/community/README-community-snippet-core.md +0 -57
  581. package/docs/zh/community/README-community-snippet-mcp.md +0 -49
  582. package/docs/zh/community/README-community-snippet-squads.md +0 -40
  583. package/docs/zh/community.md +0 -227
  584. package/docs/zh/contributing.md +0 -581
  585. package/docs/zh/core-architecture.md +0 -229
  586. package/docs/zh/docker-mcp-setup.md +0 -226
  587. package/docs/zh/framework/README.md +0 -97
  588. package/docs/zh/framework/coding-standards.md +0 -886
  589. package/docs/zh/framework/source-tree.md +0 -888
  590. package/docs/zh/framework/tech-stack.md +0 -796
  591. package/docs/zh/getting-started.md +0 -317
  592. package/docs/zh/git-workflow-guide.md +0 -988
  593. package/docs/zh/guides/MEMORY-INTEGRATION.md +0 -497
  594. package/docs/zh/guides/MEMORY-INTELLIGENCE-SYSTEM.md +0 -1083
  595. package/docs/zh/guides/MEMORY-SYSTEM.md +0 -1003
  596. package/docs/zh/guides/README.md +0 -127
  597. package/docs/zh/guides/ade-guide.md +0 -446
  598. package/docs/zh/guides/agent-selection-guide.md +0 -289
  599. package/docs/zh/guides/api-reference.md +0 -427
  600. package/docs/zh/guides/build-recovery-guide.md +0 -266
  601. package/docs/zh/guides/contextual-greeting-system-guide.md +0 -381
  602. package/docs/zh/guides/contributing-squads.md +0 -250
  603. package/docs/zh/guides/development-setup.md +0 -384
  604. package/docs/zh/guides/ide-sync-guide.md +0 -193
  605. package/docs/zh/guides/installation-troubleshooting.md +0 -321
  606. package/docs/zh/guides/llm-routing.md +0 -306
  607. package/docs/zh/guides/mcp/desktop-commander.md +0 -368
  608. package/docs/zh/guides/mcp/docker-gateway-tutorial.md +0 -336
  609. package/docs/zh/guides/mcp-global-setup.md +0 -696
  610. package/docs/zh/guides/permission-modes.md +0 -307
  611. package/docs/zh/guides/project-status-feature.md +0 -467
  612. package/docs/zh/guides/quality-dashboard.md +0 -361
  613. package/docs/zh/guides/quality-gates.md +0 -462
  614. package/docs/zh/guides/security-hardening.md +0 -1055
  615. package/docs/zh/guides/service-discovery.md +0 -518
  616. package/docs/zh/guides/squad-examples/README.md +0 -63
  617. package/docs/zh/guides/squad-migration.md +0 -336
  618. package/docs/zh/guides/template-engine-v2.md +0 -478
  619. package/docs/zh/guides/workflows-guide.md +0 -408
  620. package/docs/zh/how-to-contribute-with-pull-requests.md +0 -158
  621. package/docs/zh/installation/README.md +0 -106
  622. package/docs/zh/installation/faq.md +0 -611
  623. package/docs/zh/installation/linux.md +0 -447
  624. package/docs/zh/installation/macos.md +0 -187
  625. package/docs/zh/installation/troubleshooting.md +0 -729
  626. package/docs/zh/installation/windows.md +0 -475
  627. package/docs/zh/meta-agent-commands.md +0 -990
  628. package/docs/zh/security-best-practices.md +0 -610
  629. package/docs/zh/security.md +0 -124
  630. package/docs/zh/sinapse-agent-flows/README.md +0 -196
  631. package/docs/zh/sinapse-agent-flows/analyst-system.md +0 -679
  632. package/docs/zh/sinapse-agent-flows/architect-system.md +0 -246
  633. package/docs/zh/sinapse-agent-flows/data-engineer-system.md +0 -418
  634. package/docs/zh/sinapse-agent-flows/dev-system.md +0 -209
  635. package/docs/zh/sinapse-agent-flows/devops-system.md +0 -643
  636. package/docs/zh/sinapse-agent-flows/pm-system.md +0 -733
  637. package/docs/zh/sinapse-agent-flows/qa-system.md +0 -268
  638. package/docs/zh/sinapse-agent-flows/sinapse-master-system.md +0 -81
  639. package/docs/zh/sinapse-agent-flows/sm-system.md +0 -501
  640. package/docs/zh/sinapse-agent-flows/squad-creator-system.md +0 -704
  641. package/docs/zh/sinapse-agent-flows/ux-design-expert-system.md +0 -160
  642. package/docs/zh/sinapse-workflows/README.md +0 -247
  643. package/docs/zh/sinapse-workflows/auto-worktree-workflow.md +0 -793
  644. package/docs/zh/sinapse-workflows/brownfield-discovery-workflow.md +0 -915
  645. package/docs/zh/sinapse-workflows/brownfield-fullstack-workflow.md +0 -764
  646. package/docs/zh/sinapse-workflows/brownfield-service-workflow.md +0 -812
  647. package/docs/zh/sinapse-workflows/brownfield-ui-workflow.md +0 -891
  648. package/docs/zh/sinapse-workflows/design-system-build-quality-workflow.md +0 -845
  649. package/docs/zh/sinapse-workflows/greenfield-fullstack-workflow.md +0 -796
  650. package/docs/zh/sinapse-workflows/greenfield-service-workflow.md +0 -786
  651. package/docs/zh/sinapse-workflows/greenfield-ui-workflow.md +0 -922
  652. package/docs/zh/sinapse-workflows/qa-loop-workflow.md +0 -1111
  653. package/docs/zh/sinapse-workflows/spec-pipeline-workflow.md +0 -1031
  654. package/docs/zh/sinapse-workflows/story-development-cycle-workflow.md +0 -843
  655. package/docs/zh/troubleshooting.md +0 -883
  656. package/docs/zh/uninstallation.md +0 -348
  657. package/docs/zh/versioning-and-releases.md +0 -140
  658. /package/.sinapse-ai/development/agents/{dev → developer}/MEMORY.md +0 -0
  659. /package/.sinapse-ai/development/agents/{qa → quality-gate}/MEMORY.md +0 -0
  660. /package/.sinapse-ai/development/agents/{sm → sprint-lead}/MEMORY.md +0 -0
@@ -1,710 +0,0 @@
1
- <!-- 翻译: ZH-CN | 原始: /docs/pt/architecture/source-tree.md | 同步: 2026-02-22 -->
2
-
3
- # SINAPSE 代码树结构
4
-
5
- > 🌐 [EN](../../architecture/source-tree.md) | [PT](../../pt/architecture/source-tree.md) | **ZH**
6
-
7
- ---
8
-
9
- > ⚠️ **已弃用**: 此文件仅为向后兼容性而保留。
10
- >
11
- > **官方版本**: [docs/framework/source-tree.md](../framework/source-tree.md)
12
- >
13
- > 此文件将在 Q2 2026 后在 `docs/framework/` 完全合并后被移除。
14
-
15
- ---
16
-
17
- # SINAPSE 代码树结构
18
-
19
- **版本**: 1.1
20
- **最后更新**: 2025-12-14
21
- **状态**: 已弃用 - 请查看 docs/framework/source-tree.md
22
- **迁移通知**: 此文档将在 Q2 2026 迁移到 `SinapseAI/sinapse-ai` 存储库(参见决策 005)
23
-
24
- ---
25
-
26
- ## 📋 目录
27
-
28
- - [概述](#概述)
29
- - [当前结构 (sinapse-ai Brownfield)](#当前结构-sinapse-ai-brownfield)
30
- - [框架核心 (.sinapse-ai/)](#框架核心-sinapse-ai)
31
- - [文档 (docs/)](#文档-docs)
32
- - [Squad 系统](#squad-系统)
33
- - [未来结构 (Q2 2026 迁移后)](#未来结构-q2-2026-迁移后)
34
- - [文件命名约定](#文件命名约定)
35
- - [新文件放置位置](#新文件放置位置)
36
-
37
- ---
38
-
39
- ## 概述
40
-
41
- SINAPSE 使用**双层架构**:
42
-
43
- 1. **框架核心** (`.sinapse-ai/`) - 可移植框架组件
44
- 2. **项目工作空间** (根目录) - 特定项目实现
45
-
46
- **理念**:
47
-
48
- - 框架组件是**可移植的** (在项目间移动)
49
- - 项目文件是**特定的** (brownfield 实现)
50
- - 清晰的**职责分离** (框架 vs 项目)
51
-
52
- ---
53
-
54
- ## 当前结构 (sinapse-ai Brownfield)
55
-
56
- ```
57
- sinapse-ai/ # 根目录 (brownfield 项目)
58
- ├── .sinapse-ai/ # 框架核心 (可移植)
59
- │ ├── core/ # 框架必要组件 (v4)
60
- │ │ ├── config/ # 配置系统
61
- │ │ ├── data/ # 核心知识库
62
- │ │ ├── docs/ # 核心文档
63
- │ │ ├── elicitation/ # 交互式提示引擎
64
- │ │ ├── session/ # 运行时状态管理
65
- │ │ └── utils/ # 核心工具
66
- │ ├── product/ # PM/PO 资产 (v4)
67
- │ │ ├── templates/ # 文档模板 (52+ 文件)
68
- │ │ ├── checklists/ # 验证清单 (6 文件)
69
- │ │ └── data/ # PM 特定数据 (6 文件)
70
- │ ├── agents/ # 代理定义
71
- │ ├── tasks/ # 任务工作流
72
- │ ├── workflows/ # 多步工作流
73
- │ ├── scripts/ # 实用脚本
74
- │ ├── tools/ # 工具集成
75
- │ └── core-config.yaml # 框架配置
76
-
77
- ├── docs/ # 文档
78
- │ ├── architecture/ # 架构决策 + 官方文档
79
- │ ├── framework/ # ⭐ 新: 官方框架文档
80
- │ ├── stories/ # 开发故事
81
- │ ├── epics/ # Epic 规划
82
- │ ├── decisions/ # 架构决策记录 (ADR)
83
- │ ├── guides/ # 实用指南
84
- │ ├── qa/ # QA 报告
85
- │ └── prd/ # 产品需求
86
-
87
- ├── templates/ # 项目模板
88
- │ └── squad/ # Squad 模板用于扩展 (见 docs/guides/squads-guide.md)
89
-
90
- ├── bin/ # CLI 可执行文件
91
- │ ├── @sinapse/sinapse-ai.js # 主 CLI 入口点
92
- │ └── sinapse-minimal.js # 最小 CLI
93
-
94
- ├── tools/ # 构建和实用工具
95
- │ ├── cli.js # CLI 构建器
96
- │ ├── package-builder.js # 包构建器
97
- │ └── installer/ # 安装脚本
98
-
99
- ├── tests/ # 测试套件
100
- │ ├── unit/ # 单元测试
101
- │ ├── integration/ # 集成测试
102
- │ └── e2e/ # 端到端测试
103
-
104
- ├── .claude/ # Claude Code IDE 配置
105
- │ ├── settings.json # 项目设置
106
- │ ├── CLAUDE.md # 项目说明
107
- │ └── commands/ # 斜杠命令 (代理)
108
-
109
- ├── outputs/ # 运行时输出
110
- │ ├── minds/ # MMOS 认知克隆
111
- │ └── architecture-map/ # 架构分析
112
-
113
- ├── .ai/ # ⭐ 新: AI 会话工件
114
- │ └── decision-log-{story-id}.md # yolo 模式决策日志
115
-
116
- ├── index.js # 主入口点 (CommonJS)
117
- ├── index.esm.js # ES Module 入口
118
- ├── index.d.ts # TypeScript 定义
119
- ├── package.json # 包清单
120
- ├── tsconfig.json # TypeScript 配置
121
- ├── .eslintrc.json # ESLint 配置
122
- ├── .prettierrc # Prettier 配置
123
- └── README.md # 项目 README
124
- ```
125
-
126
- ---
127
-
128
- ## 框架核心 (.sinapse-ai/)
129
-
130
- **目的**: 可在任何 SINAPSE 项目中工作的可移植框架组件。
131
-
132
- ### 目录结构
133
-
134
- ```
135
- .sinapse-ai/
136
- ├── agents/ # 145 个代理定义
137
- │ ├── sinapse-master.md # 主编排器
138
- │ ├── dev.md # 开发代理
139
- │ ├── qa.md # QA 工程师代理
140
- │ ├── architect.md # 系统架构师代理
141
- │ ├── po.md # 产品经理代理
142
- │ ├── pm.md # 项目经理代理
143
- │ ├── sm.md # Scrum 主管代理
144
- │ ├── analyst.md # 业务分析师代理
145
- │ ├── ux-expert.md # UX 设计师代理
146
- │ ├── data-engineer.md # 数据工程师代理
147
- │ ├── devops.md # DevOps 代理
148
- │ ├── db-sage.md # 数据库架构师代理
149
- │ └── .deprecated/ # 已归档代理
150
-
151
- ├── tasks/ # 60 个任务工作流
152
- │ ├── create-next-story.md # 创建故事工作流
153
- │ ├── develop-story.md # 开发故事工作流
154
- │ ├── validate-next-story.md # 验证故事工作流
155
- │ ├── review-story.md # 审查故事工作流
156
- │ ├── apply-qa-fixes.md # QA 修复工作流
157
- │ ├── execute-checklist.md # 清单执行
158
- │ ├── document-project.md # 项目文档化
159
- │ ├── create-doc.md # 文档创建
160
- │ ├── shard-doc.md # 文档分片
161
- │ └── ... # 再加 50+ 任务
162
-
163
- ├── templates/ # 20 个文档模板
164
- │ ├── story-tmpl.yaml # 故事模板 v2.0
165
- │ ├── design-story-tmpl.yaml # 设计故事模板 v1.0
166
- │ ├── prd-tmpl.yaml # 产品需求文档模板
167
- │ ├── epic-tmpl.md # Epic 模板
168
- │ ├── architecture-tmpl.yaml # 架构模板
169
- │ ├── fullstack-architecture-tmpl.yaml # 全栈架构模板
170
- │ ├── brownfield-architecture-tmpl.yaml # Brownfield 架构模板
171
- │ ├── schema-design-tmpl.yaml # 数据库 schema 模板
172
- │ └── ... # 再加 12+ 模板
173
-
174
- ├── workflows/ # 6 个多步工作流
175
- │ ├── greenfield-fullstack.yaml # 绿地全栈工作流
176
- │ ├── greenfield-service.yaml # 绿地服务工作流
177
- │ ├── greenfield-ui.yaml # 绿地 UI 工作流
178
- │ ├── brownfield-fullstack.yaml # Brownfield 全栈工作流
179
- │ ├── brownfield-service.yaml # Brownfield 服务工作流
180
- │ └── brownfield-ui.yaml # Brownfield UI 工作流
181
-
182
- ├── checklists/ # 6 个验证清单
183
- │ ├── po-master-checklist.md # PO 验证清单
184
- │ ├── story-draft-checklist.md # 故事草稿验证
185
- │ ├── architect-checklist.md # 架构审查清单
186
- │ ├── qa-checklist.md # QA 清单
187
- │ ├── pm-checklist.md # PM 清单
188
- │ └── change-checklist.md # 变更管理清单
189
-
190
- ├── data/ # 6 个知识库文件
191
- │ ├── sinapse-kb.md # SINAPSE 知识库
192
- │ ├── technical-preferences.md # 技术栈偏好
193
- │ ├── elicitation-methods.md # 启发方法
194
- │ ├── brainstorming-techniques.md # 头脑风暴方法
195
- │ ├── test-levels-framework.md # 测试级别框架
196
- │ └── test-priorities-matrix.md # 测试优先级矩阵
197
-
198
- ├── scripts/ # 54 个实用脚本
199
- │ ├── component-generator.js # 组件脚手架生成
200
- │ ├── elicitation-engine.js # 交互式启发
201
- │ ├── story-manager.js # 故事生命周期管理
202
- │ ├── yaml-validator.js # YAML 验证
203
- │ ├── usage-analytics.js # 框架使用分析
204
- │ └── ... # 再加 49+ 工具
205
-
206
- ├── tools/ # 工具集成
207
- │ ├── mcp/ # MCP 服务器配置
208
- │ │ ├── clickup-direct.yaml # ClickUp 集成
209
- │ │ ├── context7.yaml # Context7 集成
210
- │ │ └── exa-direct.yaml # Exa 搜索集成
211
- │ ├── cli/ # CLI 工具包装
212
- │ │ ├── github-cli.yaml # GitHub CLI 包装
213
- │ │ └── railway-cli.yaml # Railway CLI 包装
214
- │ └── local/ # 本地工具
215
-
216
- ├── elicitation/ # 3 个启发引擎
217
- │ ├── agent-elicitation.js # 代理创建启发
218
- │ ├── task-elicitation.js # 任务创建启发
219
- │ └── workflow-elicitation.js # 工作流创建启发
220
-
221
- ├── agent-teams/ # 代理团队配置
222
- │ └── ... # 团队定义
223
-
224
- ├── core-config.yaml # ⭐ 框架配置
225
- ├── install-manifest.yaml # 安装清单
226
- ├── user-guide.md # 用户指南
227
- └── working-in-the-brownfield.md # Brownfield 开发指南
228
- ```
229
-
230
- ### 文件模式
231
-
232
- ```yaml
233
- Agents:
234
- 位置: .sinapse-ai/agents/
235
- 格式: Markdown + YAML frontmatter
236
- 命名: {agent-name}.md (kebab-case)
237
- 示例: developer.md, qa-engineer.md
238
-
239
- Tasks:
240
- 位置: .sinapse-ai/tasks/
241
- 格式: Workflow Markdown
242
- 命名: {task-name}.md (kebab-case)
243
- 示例: create-next-story.md, develop-story.md
244
-
245
- Templates:
246
- 位置: .sinapse-ai/product/templates/
247
- 格式: YAML 或 Markdown
248
- 命名: {template-name}-tmpl.{yaml|md}
249
- 示例: story-tmpl.yaml, prd-tmpl.md
250
-
251
- Workflows:
252
- 位置: .sinapse-ai/workflows/
253
- 格式: YAML
254
- 命名: {workflow-type}-{scope}.yaml
255
- 示例: greenfield-fullstack.yaml, brownfield-service.yaml
256
-
257
- Checklists:
258
- 位置: .sinapse-ai/product/checklists/
259
- 格式: Markdown
260
- 命名: {checklist-name}-checklist.md
261
- 示例: story-draft-checklist.md, architect-checklist.md
262
-
263
- Utilities:
264
- 位置: .sinapse-ai/utils/
265
- 格式: JavaScript (CommonJS)
266
- 命名: {utility-name}.js (kebab-case)
267
- 示例: component-generator.js, story-manager.js
268
- ```
269
-
270
- ---
271
-
272
- ## 文档 (docs/)
273
-
274
- ### 当前组织
275
-
276
- ```
277
- docs/
278
- ├── architecture/ # ⚠️ 混合: 官方 + 项目特定
279
- │ ├── coding-standards.md # ✅ 官方 (迁移到 REPO 1)
280
- │ ├── tech-stack.md # ✅ 官方 (迁移到 REPO 1)
281
- │ ├── source-tree.md # ✅ 官方 (迁移到 REPO 1)
282
- │ ├── decision-analysis-*.md # 项目特定决策
283
- │ ├── architectural-review-*.md # 项目特定审查
284
- │ └── mcp-*.md # 框架文档 (迁移到 REPO 1)
285
-
286
- ├── framework/ # ⭐ 新: 官方框架文档 (Q2 2026)
287
- │ ├── coding-standards.md # 框架编码标准
288
- │ ├── tech-stack.md # 框架技术栈
289
- │ ├── source-tree.md # 框架代码树
290
- │ └── README.md # 迁移通知
291
-
292
- ├── stories/ # 开发故事
293
- │ ├── sinapse migration/ # SINAPSE 迁移故事
294
- │ │ ├── story-6.1.2.1.md
295
- │ │ ├── story-6.1.2.2.md
296
- │ │ ├── story-6.1.2.3.md
297
- │ │ ├── story-6.1.2.4.md
298
- │ │ └── story-6.1.2.5.md
299
- │ └── ... # 其他故事
300
-
301
- ├── epics/ # Epic 规划
302
- │ ├── epic-6.1-agent-identity-system.md
303
- │ └── ... # 其他 Epic
304
-
305
- ├── decisions/ # 架构决策记录
306
- │ ├── decision-005-repository-restructuring-FINAL.md
307
- │ └── ... # 其他 ADR
308
-
309
- ├── guides/ # 实用指南
310
- │ ├── git-workflow-guide.md
311
- │ ├── migration-guide.md
312
- │ └── ... # 其他指南
313
-
314
- ├── qa/ # QA 工件
315
- │ └── backlog-archive/ # 已存档 QA 项
316
-
317
- ├── prd/ # 产品需求文档
318
- │ └── ... # PRD 文件
319
-
320
- ├── planning/ # 规划文档
321
- │ └── ... # Sprint 计划、Roadmap
322
-
323
- ├── standards/ # 框架标准
324
- │ └── AGENT-PERSONALIZATION-STANDARD-V1.md
325
-
326
- └── STORY-BACKLOG.md # ⭐ 故事待办项索引
327
- ```
328
-
329
- ### 建议的重组 (Story 6.1.2.6)
330
-
331
- ```
332
- docs/
333
- ├── framework/ # ✅ 官方框架文档
334
- │ ├── coding-standards.md
335
- │ ├── tech-stack.md
336
- │ ├── source-tree.md
337
- │ ├── agent-spec.md
338
- │ ├── task-spec.md
339
- │ └── workflow-spec.md
340
-
341
- ├── architecture/ # 项目特定架构
342
- │ ├── project-decisions/ # ✅ 此项目的 ADR
343
- │ │ ├── decision-005-repository-restructuring-FINAL.md
344
- │ │ ├── architectural-review-contextual-agent-load.md
345
- │ │ └── ...
346
- │ └── diagrams/ # 架构图
347
-
348
- ├── stories/ # 开发故事
349
- │ ├── index.md # ⭐ 故事索引 (自动生成)
350
- │ ├── backlog.md # ⭐ 故事待办项 (官方)
351
- │ └── ... # 故事文件
352
-
353
- ├── epics/
354
- ├── guides/
355
- ├── qa/
356
- ├── prd/
357
- └── standards/
358
- ```
359
-
360
- ---
361
-
362
- ## Squad 系统
363
-
364
- > **注意**: Squad 替代了 OSR-8 中已弃用的 "Squad" 系统。完整文档见 [Squad 指南](../guides/squads-guide.md)。
365
-
366
- ### 概述
367
-
368
- Squad 是添加专用功能到 SINAPSE 的模块化扩展。不同于已弃用的 Squad,Squad 遵循标准化模板结构。
369
-
370
- ### Squad 模板位置
371
-
372
- ```
373
- templates/squad/ # 创建扩展的 Squad 模板
374
- ├── squad.yaml # Squad 清单模板
375
- ├── package.json # NPM 包模板
376
- ├── README.md # 文档模板
377
- ├── LICENSE # 许可证模板
378
- ├── .gitignore # Git 忽略模板
379
- ├── agents/ # Squad 特定代理
380
- │ └── example-agent.yaml
381
- ├── tasks/ # Squad 特定任务
382
- │ └── example-task.yaml
383
- ├── workflows/ # Squad 特定工作流
384
- │ └── example-workflow.yaml
385
- ├── templates/ # Squad 特定模板
386
- │ └── example-template.md
387
- └── tests/ # Squad 测试
388
- └── example-agent.test.js
389
- ```
390
-
391
- ### 创建新 Squad
392
-
393
- ```bash
394
- # 计划中的 CLI (未来):
395
- npx create-sinapse-squad my-squad-name
396
-
397
- # 当前方法:
398
- cp -r templates/squad/ squads/my-squad-name/
399
- # 然后自定义 squad.yaml 和组件
400
- ```
401
-
402
- ### Squad 清单结构
403
-
404
- ```yaml
405
- # squad.yaml
406
- name: my-custom-squad
407
- version: 1.0.0
408
- description: 此 Squad 所做功能的描述
409
- author: 你的名字
410
- license: MIT
411
-
412
- # 此 Squad 提供的组件
413
- agents:
414
- - custom-agent-1
415
- - custom-agent-2
416
-
417
- tasks:
418
- - custom-task-1
419
-
420
- workflows:
421
- - custom-workflow-1
422
-
423
- # 依赖关系
424
- dependencies:
425
- sinapse-ai: '>=2.1.0'
426
- ```
427
-
428
- ### Squad 迁移
429
-
430
- | 旧版本 (已弃用) | 当前版本 (Squad) |
431
- | ---------------------- | ------------------------------ |
432
- | 目录 `Squads/` | 模板 `templates/squad/` |
433
- | 配置 `legacyPacksLocation` | 配置 `squadsTemplateLocation` |
434
- | 清单 `pack.yaml` | 清单 `squad.yaml` |
435
- | 直接加载 | 基于模板创建 |
436
-
437
- ---
438
-
439
- ## 未来结构 (Q2 2026 迁移后)
440
-
441
- **决策 005 定义 5 个单独存储库**:
442
-
443
- ### 存储库 1: SinapseAI/sinapse-ai (MIT)
444
-
445
- ```
446
- sinapse-ai/
447
- ├── src/ # 源代码
448
- │ ├── core/ # 核心编排引擎
449
- │ │ ├── agent-executor.js
450
- │ │ ├── task-runner.js
451
- │ │ └── workflow-orchestrator.js
452
- │ ├── integrations/ # 外部集成
453
- │ │ ├── mcp/ # MCP 编排
454
- │ │ └── ide/ # IDE 集成
455
- │ └── cli/ # CLI 接口
456
-
457
- ├── .sinapse-ai/ # 框架资产 (当前结构)
458
- │ ├── agents/
459
- │ ├── tasks/
460
- │ ├── templates/
461
- │ └── ...
462
-
463
- ├── docs/ # 框架文档
464
- │ ├── getting-started/
465
- │ ├── core-concepts/
466
- │ ├── integrations/
467
- │ └── api/
468
-
469
- ├── examples/ # 示例项目
470
- │ ├── basic-agent/
471
- │ ├── vibecoder-demo/
472
- │ └── multi-agent-workflow/
473
-
474
- └── tests/ # 测试套件
475
- ├── unit/
476
- ├── integration/
477
- └── e2e/
478
- ```
479
-
480
- ### 存储库 2: SinapseAI/squads (MIT)
481
-
482
- ```
483
- squads/
484
- ├── verified/ # SINAPSE 审核的 Squad
485
- │ ├── github-devops/
486
- │ ├── db-sage/
487
- │ └── coderabbit-workflow/
488
-
489
- ├── community/ # 社区提交
490
- │ ├── marketing-agency/
491
- │ ├── sales-automation/
492
- │ └── ...
493
-
494
- ├── templates/ # Squad 模板
495
- │ ├── minimal-squad/
496
- │ └── agent-squad/
497
-
498
- └── tools/ # Squad 开发工具
499
- └── create-sinapse-squad/
500
- ```
501
-
502
- ### 存储库 3: SinapseAI/mcp-ecosystem (Apache 2.0)
503
-
504
- ```
505
- mcp-ecosystem/
506
- ├── presets/ # MCP 预设 (Docker MCP Toolkit)
507
- │ ├── sinapse-dev/
508
- │ ├── sinapse-research/
509
- │ └── sinapse-docker/
510
-
511
- ├── mcps/ # MCP 基础配置
512
- │ ├── exa/
513
- │ ├── context7/
514
- │ └── desktop-commander/
515
-
516
- └── ide-configs/ # IDE 集成
517
- ├── claude-code/
518
- ├── gemini-cli/
519
- └── cursor/
520
- ```
521
-
522
- ### 存储库 4: SinapseAI/certified-partners (私有)
523
-
524
- ```
525
- certified-partners/
526
- ├── premium-packs/ # 高级 Squad
527
- │ ├── enterprise-deployment/
528
- │ └── advanced-devops/
529
-
530
- ├── partner-portal/ # 合作伙伴成功平台
531
- │ ├── dashboard/
532
- │ └── analytics/
533
-
534
- └── marketplace/ # Marketplace 平台
535
- ├── api/
536
- └── web/
537
- ```
538
-
539
- ### 存储库 5: SinapseAI/mmos (私有 + NDA)
540
-
541
- ```
542
- mmos/
543
- ├── minds/ # 34 个认知克隆
544
- │ ├── paul-graham/
545
- │ └── ...
546
-
547
- ├── emulator/ # MMOS 仿真引擎
548
- │ ├── mirror-agent/
549
- │ └── dna-mental/
550
-
551
- └── research/ # 研究工件
552
- └── transcripts/
553
- ```
554
-
555
- ---
556
-
557
- ## 文件命名约定
558
-
559
- ### 通用规则
560
-
561
- ```yaml
562
- 目录: kebab-case (小写,用连字符分隔)
563
- ✅ .sinapse-ai/
564
- ✅ Squads/
565
- ❌ .sinapse-ai/
566
- ❌ legacy-packs/
567
-
568
- 文件 (代码): kebab-case + 扩展名
569
- ✅ agent-executor.js
570
- ✅ task-runner.js
571
- ❌ AgentExecutor.js
572
- ❌ taskRunner.js
573
-
574
- 文件 (文档): kebab-case + .md 扩展名
575
- ✅ coding-standards.md
576
- ✅ story-6.1.2.5.md
577
- ❌ CodingStandards.md
578
- ❌ Story_6_1_2_5.md
579
-
580
- 文件 (配置): 小写或 kebab-case
581
- ✅ package.json
582
- ✅ tsconfig.json
583
- ✅ core-config.yaml
584
- ❌ PackageConfig.json
585
- ```
586
-
587
- ### 特殊情况
588
-
589
- ```yaml
590
- 故事:
591
- 格式: story-{epic}.{story}.{substory}.md
592
- 示例: story-6.1.2.5.md
593
-
594
- Epic:
595
- 格式: epic-{number}-{name}.md
596
- 示例: epic-6.1-agent-identity-system.md
597
-
598
- 决策:
599
- 格式: decision-{number}-{name}.md
600
- 示例: decision-005-repository-restructuring-FINAL.md
601
-
602
- 模板:
603
- 格式: {name}-tmpl.{yaml|md}
604
- 示例: story-tmpl.yaml, prd-tmpl.md
605
-
606
- 清单:
607
- 格式: {name}-checklist.md
608
- 示例: architect-checklist.md
609
- ```
610
-
611
- ---
612
-
613
- ## 新文件放置位置
614
-
615
- ### 决策矩阵
616
-
617
- ```yaml
618
- # 我在创建新代理:
619
- 位置: .sinapse-ai/agents/{agent-name}.md
620
- 示例: .sinapse-ai/agents/security-expert.md
621
-
622
- # 我在创建新任务:
623
- 位置: .sinapse-ai/tasks/{task-name}.md
624
- 示例: .sinapse-ai/tasks/deploy-to-production.md
625
-
626
- # 我在创建新工作流:
627
- 位置: .sinapse-ai/workflows/{workflow-name}.yaml
628
- 示例: .sinapse-ai/workflows/continuous-deployment.yaml
629
-
630
- # 我在创建新模板:
631
- 位置: .sinapse-ai/product/templates/{template-name}-tmpl.{yaml|md}
632
- 示例: .sinapse-ai/product/templates/deployment-plan-tmpl.yaml
633
-
634
- # 我在编写故事:
635
- 位置: docs/stories/{epic-context}/{story-file}.md
636
- 示例: docs/stories/sinapse migration/story-6.1.2.6.md
637
-
638
- # 我在记录架构决策:
639
- 位置: docs/architecture/project-decisions/{decision-file}.md
640
- 示例: docs/architecture/project-decisions/decision-006-auth-strategy.md
641
-
642
- # 我在创建官方框架文档:
643
- 位置: docs/framework/{doc-name}.md
644
- 示例: docs/framework/agent-development-guide.md
645
-
646
- # 我在创建实用脚本:
647
- 位置: .sinapse-ai/utils/{utility-name}.js
648
- 示例: .sinapse-ai/utils/performance-monitor.js
649
-
650
- # 我在创建测试:
651
- 位置: tests/{type}/{test-name}.test.js
652
- 示例: tests/unit/agent-executor.test.js
653
-
654
- # 我在创建 Squad:
655
- 位置: 从 templates/squad/ 复制到 Squad 目录
656
- 示例: squads/devops-automation/ (从模板自定义)
657
- ```
658
-
659
- ---
660
-
661
- ## 特殊目录
662
-
663
- ### .ai/ 目录 (新 - Story 6.1.2.6)
664
-
665
- ```
666
- .ai/ # AI 会话工件
667
- ├── decision-log-6.1.2.5.md # yolo 模式决策日志
668
- ├── decision-log-6.1.2.6.md # 另一个决策日志
669
- └── session-{date}-{agent}.md # 会话抄本 (可选)
670
- ```
671
-
672
- **目的**: 追踪 AI 在开发会话中做出的决策(尤其是 yolo 模式)
673
-
674
- **自动生成**: 是 (启用 yolo 模式时)
675
-
676
- ### outputs/ 目录
677
-
678
- ```
679
- outputs/ # 运行时输出 (gitignored)
680
- ├── minds/ # MMOS 认知克隆
681
- │ ├── system-prompt.md
682
- │ ├── kb/
683
- │ └── artifacts/
684
-
685
- └── architecture-map/ # 架构分析
686
- ├── MASTER-RELATIONSHIP-MAP.json
687
- └── schemas/
688
- ```
689
-
690
- **目的**: 不提交到 git 的运行时工件
691
-
692
- ---
693
-
694
- ## 相关文档
695
-
696
- - [编码标准](./coding-standards.md)
697
- - [技术栈](./tech-stack.md)
698
-
699
- ---
700
-
701
- ## 版本历史
702
-
703
- | 版本 | 日期 | 变更 | 作者 |
704
- | ---- | ---------- | -------------------------------------------------------------- | --------------- |
705
- | 1.0 | 2025-01-15 | 代码树初始文档化 | Aria (architect)|
706
- | 1.1 | 2025-12-14 | 更新 org 为 SinapseAI,用 Squad 系统替换 Squads [Story 6.10] | Dex (dev) |
707
-
708
- ---
709
-
710
- _这是 SINAPSE 框架的官方模式。所有文件放置应遵循此结构。_