sinapse-ai 5.0.8 → 6.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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 +2154 -2337
  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 +13 -11
  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} +18 -18
  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,222 +0,0 @@
1
- <!-- Traducción: ES | Original: /docs/en/architecture/agent-config-audit.md | Sincronización: 2026-01-26 -->
2
-
3
- # Auditoría de Uso de Configuración de Agentes
4
-
5
- > 🌐 [EN](../../architecture/agent-config-audit.md) | [PT](../../pt/architecture/agent-config-audit.md) | **ES**
6
-
7
- ---
8
-
9
- **Generado:** 2025-11-16T13:49:03.668Z
10
- **Total de Agentes:** 8
11
-
12
- ---
13
-
14
- ## Resumen Ejecutivo
15
-
16
- **Impacto de Carga Diferida:**
17
- - Ahorro promedio por agente: **122.0 KB** (84.2% de reducción)
18
- - Agentes beneficiándose de carga diferida: **8/8**
19
- - Total de configuración ahorrada en todos los agentes: **976.4 KB**
20
-
21
- ---
22
-
23
- ## Análisis de Agentes
24
-
25
- ### Morgan (@pm)
26
-
27
- **Título:** Product Manager
28
-
29
- **Necesidades de Configuración:**
30
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
31
-
32
- **Ahorros:**
33
- - Sin carga diferida: 145.0 KB
34
- - Con carga diferida: 1.7 KB
35
- - **Ahorro: 143.3 KB (98.8% de reducción)**
36
-
37
- **Dependencias:**
38
- - tasks: 7 elementos
39
- - templates: 2 elementos
40
- - checklists: 2 elementos
41
- - data: 1 elemento
42
-
43
- ---
44
-
45
- ### Aria (@architect)
46
-
47
- **Título:** Arquitecto
48
-
49
- **Necesidades de Configuración:**
50
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
51
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
52
-
53
- **Ahorros:**
54
- - Sin carga diferida: 145.0 KB
55
- - Con carga diferida: 11.7 KB
56
- - **Ahorro: 133.3 KB (91.9% de reducción)**
57
-
58
- **Dependencias:**
59
- - tasks: 6 elementos
60
- - templates: 4 elementos
61
- - checklists: 1 elemento
62
- - data: 1 elemento
63
- - tools: 6 elementos
64
-
65
- ---
66
-
67
- ### Pax (@po)
68
-
69
- **Título:** Product Owner
70
-
71
- **Necesidades de Configuración:**
72
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
73
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
74
-
75
- **Ahorros:**
76
- - Sin carga diferida: 145.0 KB
77
- - Con carga diferida: 11.7 KB
78
- - **Ahorro: 133.3 KB (91.9% de reducción)**
79
-
80
- **Dependencias:**
81
- - tasks: 10 elementos
82
- - templates: 1 elemento
83
- - checklists: 2 elementos
84
- - tools: 2 elementos
85
-
86
- ---
87
-
88
- ### River (@sm)
89
-
90
- **Título:** Scrum Master
91
-
92
- **Necesidades de Configuración:**
93
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
94
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
95
-
96
- **Ahorros:**
97
- - Sin carga diferida: 145.0 KB
98
- - Con carga diferida: 11.7 KB
99
- - **Ahorro: 133.3 KB (91.9% de reducción)**
100
-
101
- **Dependencias:**
102
- - tasks: 3 elementos
103
- - templates: 1 elemento
104
- - checklists: 1 elemento
105
- - tools: 3 elementos
106
-
107
- ---
108
-
109
- ### Atlas (@analyst)
110
-
111
- **Título:** Analista de Negocios
112
-
113
- **Necesidades de Configuración:**
114
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
115
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
116
-
117
- **Ahorros:**
118
- - Sin carga diferida: 145.0 KB
119
- - Con carga diferida: 11.7 KB
120
- - **Ahorro: 133.3 KB (91.9% de reducción)**
121
-
122
- **Dependencias:**
123
- - tasks: 5 elementos
124
- - templates: 4 elementos
125
- - data: 2 elementos
126
- - tools: 3 elementos
127
-
128
- ---
129
-
130
- ### Dara (@data-engineer)
131
-
132
- **Título:** Arquitecto de Base de Datos e Ingeniero de Operaciones
133
-
134
- **Necesidades de Configuración:**
135
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
136
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
137
-
138
- **Ahorros:**
139
- - Sin carga diferida: 145.0 KB
140
- - Con carga diferida: 11.7 KB
141
- - **Ahorro: 133.3 KB (91.9% de reducción)**
142
-
143
- **Dependencias:**
144
- - tasks: 20 elementos
145
- - templates: 12 elementos
146
- - checklists: 3 elementos
147
- - data: 5 elementos
148
- - tools: 5 elementos
149
-
150
- ---
151
-
152
- ### Gage (@devops)
153
-
154
- **Título:** Gestor de Repositorio GitHub y Especialista DevOps
155
-
156
- **Necesidades de Configuración:**
157
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
158
- - **Carga Diferida:** 1 sección (`toolConfigurations`)
159
-
160
- **Ahorros:**
161
- - Sin carga diferida: 145.0 KB
162
- - Con carga diferida: 11.7 KB
163
- - **Ahorro: 133.3 KB (91.9% de reducción)**
164
-
165
- **Dependencias:**
166
- - tasks: 6 elementos
167
- - templates: 4 elementos
168
- - checklists: 2 elementos
169
- - utils: 5 elementos
170
- - tools: 3 elementos
171
-
172
- ---
173
-
174
- ### Dex (@dev)
175
-
176
- **Título:** Desarrollador Full Stack
177
-
178
- **Necesidades de Configuración:**
179
- - **Siempre Cargado:** 4 secciones (`frameworkDocsLocation`, `projectDocsLocation`, `devLoadAlwaysFiles`, `lazyLoading`)
180
- - **Carga Diferida:** 3 secciones (`pvMindContext`, `hybridOpsConfig`, `toolConfigurations`)
181
-
182
- **Ahorros:**
183
- - Sin carga diferida: 145.0 KB
184
- - Con carga diferida: 111.7 KB
185
- - **Ahorro: 33.3 KB (23.0% de reducción)**
186
-
187
- **Dependencias:**
188
- - checklists: 1 elemento
189
- - tasks: 9 elementos
190
- - tools: 7 elementos
191
-
192
- ---
193
-
194
- ## Recomendaciones
195
-
196
- ### Alta Prioridad (Agentes con >50KB de ahorro)
197
- - **@pm**: 143.3 KB de ahorro
198
- - **@architect**: 133.3 KB de ahorro
199
- - **@po**: 133.3 KB de ahorro
200
- - **@sm**: 133.3 KB de ahorro
201
- - **@analyst**: 133.3 KB de ahorro
202
- - **@data-engineer**: 133.3 KB de ahorro
203
- - **@devops**: 133.3 KB de ahorro
204
-
205
- ### Prioridad Media (Agentes con 20-50KB de ahorro)
206
- - **@dev**: 33.3 KB de ahorro
207
-
208
- ### Baja Prioridad (Agentes con <20KB de ahorro)
209
-
210
- ---
211
-
212
- ## Lista de Verificación de Implementación
213
-
214
- - [ ] Crear agent-config-requirements.yaml con mapeo de necesidades
215
- - [ ] Implementar carga diferida en el cargador de configuración
216
- - [ ] Actualizar la activación de cada agente para usar cargador diferido
217
- - [ ] Agregar seguimiento de rendimiento para tiempos de carga
218
- - [ ] Verificar que se logre el objetivo de mejora del 18%
219
-
220
- ---
221
-
222
- *Auto-generado por Auditoría de Configuración de Agentes SINAPSE (Historia 6.1.2.6)*
@@ -1,444 +0,0 @@
1
- <!-- Traducción: ES | Original: /docs/en/architecture/agent-responsibility-matrix.md | Sincronización: 2026-01-26 -->
2
-
3
- # Matriz de Responsabilidad de Agentes - Mejoras Estratégicas Épica 3
4
-
5
- > 🌐 [EN](../../architecture/agent-responsibility-matrix.md) | [PT](../../pt/architecture/agent-responsibility-matrix.md) | **ES**
6
-
7
- ---
8
-
9
- **Versión del Documento**: 1.0
10
- **Última Actualización**: 2025-10-25
11
- **Autor**: Winston (@architect) + Sarah (@po)
12
- **Contexto**: Épica 3 Fase 2 - Mejoras Estratégicas (Historias 3.13-3.19)
13
-
14
- ---
15
-
16
- ## Resumen Ejecutivo
17
-
18
- Este documento define límites claros de responsabilidad para todos los agentes SINAPSE, con enfoque particular en:
19
- 1. **Centralización de GitHub DevOps** - Solo @github-devops puede hacer push al repositorio remoto
20
- 2. **Especialización de Arquitectura de Datos** - @data-architect maneja base de datos/ciencia de datos
21
- 3. **División de Gestión de Ramas** - @sm (local) vs @github-devops (remoto)
22
- 4. **Restricciones de Operaciones Git** - Qué agentes pueden hacer qué con git/GitHub
23
-
24
- **Regla Crítica**: SOLO el agente @github-devops puede ejecutar `git push` al repositorio remoto.
25
-
26
- ---
27
-
28
- ## Matriz de Operaciones Git/GitHub
29
-
30
- ### Autoridad Completa de Operaciones
31
-
32
- | Operación | @github-devops | @dev | @sm | @qa | @architect | @po |
33
- |-----------|:--------------:|:----:|:---:|:---:|:----------:|:---:|
34
- | **git push** | ✅ SOLO | ❌ | ❌ | ❌ | ❌ | ❌ |
35
- | **git push --force** | ✅ SOLO | ❌ | ❌ | ❌ | ❌ | ❌ |
36
- | **gh pr create** | ✅ SOLO | ❌ | ❌ | ❌ | ❌ | ❌ |
37
- | **gh pr merge** | ✅ SOLO | ❌ | ❌ | ❌ | ❌ | ❌ |
38
- | **gh release create** | ✅ SOLO | ❌ | ❌ | ❌ | ❌ | ❌ |
39
- | **git commit** | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
40
- | **git add** | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
41
- | **git checkout -b** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
42
- | **git merge** (local) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
43
- | **git status** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
44
- | **git log** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
45
- | **git diff** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
46
-
47
- ### Mecanismo de Aplicación
48
-
49
- **Defensa en Profundidad Multi-Capa**:
50
-
51
- 1. **Hook Git Pre-Push** (Aplicación Primaria)
52
- - Ubicación: `.git/hooks/pre-push`
53
- - Verifica: Variable de entorno `$SINAPSE_ACTIVE_AGENT`
54
- - Acción: Bloquea push si agente != "github-devops"
55
-
56
- 2. **Variables de Entorno** (Detección en Tiempo de Ejecución)
57
- ```bash
58
- export SINAPSE_ACTIVE_AGENT="github-devops"
59
- export SINAPSE_GIT_PUSH_ALLOWED="true"
60
- ```
61
-
62
- 3. **Definiciones de Agentes** (Documentación + Restricciones)
63
- - Todos los agentes tienen sección `git_restrictions`
64
- - Listas claras de `allowed_operations` y `blocked_operations`
65
- - Mensajes de redirección apuntan a @github-devops
66
-
67
- 4. **Configuración de IDE** (Capa UX)
68
- ```json
69
- {
70
- "agents": {
71
- "dev": { "blockedOperations": ["push"] },
72
- "github-devops": { "allowedOperations": ["*"] }
73
- }
74
- }
75
- ```
76
-
77
- ---
78
-
79
- ## Límites de Responsabilidad de Agentes
80
-
81
- ### @architect (Winston) 🏗️
82
- **Rol**: Arquitecto de Sistemas Holístico y Líder Técnico Full-Stack
83
-
84
- **Alcance Principal**:
85
- - Arquitectura de sistemas (microservicios, monolito, serverless, híbrido)
86
- - Selección de stack tecnológico (frameworks, lenguajes, plataformas)
87
- - Planificación de infraestructura (despliegue, escalado, monitoreo, CDN)
88
- - Diseño de APIs (REST, GraphQL, tRPC, WebSocket)
89
- - Arquitectura de seguridad (autenticación, autorización, encriptación)
90
- - Arquitectura frontend (gestión de estado, enrutamiento, rendimiento)
91
- - Arquitectura backend (límites de servicios, flujos de eventos, caché)
92
- - Preocupaciones transversales (logging, monitoreo, manejo de errores)
93
-
94
- **Operaciones Git**: Solo lectura (status, log, diff) - SIN PUSH
95
-
96
- **Delegar A**:
97
- - **@data-architect**: Diseño de esquemas de base de datos, optimización de consultas, pipelines ETL
98
- - **@github-devops**: Git push, creación de PR, configuración CI/CD
99
-
100
- **Retener**:
101
- - Selección de tecnología de base de datos desde perspectiva de sistema
102
- - Integración de capa de datos con arquitectura de aplicación
103
- - Diseño de flujo de trabajo git (estrategia de ramas)
104
-
105
- ---
106
-
107
- ### @data-architect (DataArch) 🗄️
108
- **Rol**: Arquitecto de Base de Datos y Especialista en Flujos de Trabajo de Ciencia de Datos
109
-
110
- **Alcance Principal**:
111
- - Diseño de esquemas de base de datos (tablas, relaciones, índices, restricciones)
112
- - Modelado de datos (estrategias de normalización, desnormalización)
113
- - Optimización de consultas y ajuste de rendimiento
114
- - Diseño e implementación de pipelines ETL
115
- - Arquitectura de flujos de trabajo de ciencia de datos
116
- - Optimización específica de Supabase (políticas RLS, realtime, edge functions)
117
- - Gobernanza de datos (seguridad, privacidad, cumplimiento)
118
-
119
- **Operaciones Git**: Commits locales (add, commit) - SIN PUSH
120
-
121
- **Colaborar Con**:
122
- - **@architect**: Selección de tecnología de base de datos, integración de capa de datos
123
- - **@github-devops**: Push de archivos de migración después de commit local
124
-
125
- **Especialización**: Experto en Supabase (Row-Level Security, realtime, edge functions, storage)
126
-
127
- ---
128
-
129
- ### @dev (James) 💻
130
- **Rol**: Ingeniero de Software Senior Experto y Especialista en Implementación
131
-
132
- **Alcance Principal**:
133
- - Implementación de código desde historias
134
- - Depuración y refactorización
135
- - Pruebas unitarias/de integración
136
- - Operaciones git locales (add, commit, checkout, merge)
137
- - Ejecución de tareas de historias
138
-
139
- **Operaciones Git**:
140
- - ✅ Permitidas: add, commit, status, diff, log, branch, checkout, merge (local)
141
- - ❌ Bloqueadas: push, gh pr create
142
-
143
- **Flujo de Trabajo Después de Historia Completada**:
144
- 1. Marcar estado de historia: "Listo para Revisión"
145
- 2. Notificar al usuario: "Historia completada. Activa @github-devops para hacer push de los cambios"
146
- 3. NO intentar git push
147
-
148
- ---
149
-
150
- ### @sm (Bob) 🏃
151
- **Rol**: Scrum Master Técnico - Especialista en Preparación de Historias
152
-
153
- **Alcance Principal**:
154
- - Creación y refinamiento de historias
155
- - Gestión de épicas y desglose
156
- - Asistencia en planificación de sprints
157
- - Gestión de ramas locales durante desarrollo
158
- - Guía de resolución de conflictos (merges locales)
159
-
160
- **Operaciones Git**:
161
- - ✅ Permitidas: checkout -b (crear ramas de características), branch (listar), merge (local)
162
- - ❌ Bloqueadas: push, gh pr create, eliminación de ramas remotas
163
-
164
- **Flujo de Trabajo de Gestión de Ramas**:
165
- 1. Historia inicia → Crear rama de características local: `git checkout -b feature/X.Y-nombre-historia`
166
- 2. Desarrollador hace commits localmente
167
- 3. Historia completada → Notificar a @github-devops para hacer push y crear PR
168
-
169
- **Nota**: @sm gestiona ramas LOCALES durante desarrollo, @github-devops gestiona operaciones REMOTAS
170
-
171
- ---
172
-
173
- ### @github-devops (DevOps) 🚀
174
- **Rol**: Gestor de Repositorio GitHub y Especialista DevOps
175
-
176
- **AUTORIDAD PRINCIPAL**: ÚNICO agente autorizado para hacer push al repositorio remoto
177
-
178
- **Operaciones Exclusivas**:
179
- - ✅ git push (TODAS las variantes)
180
- - ✅ gh pr create, gh pr merge
181
- - ✅ gh release create
182
- - ✅ Eliminación de ramas remotas
183
-
184
- **Alcance Principal**:
185
- - Integridad y gobernanza del repositorio
186
- - Ejecución de puertas de calidad pre-push (lint, test, typecheck, build)
187
- - Versionado semántico y gestión de releases
188
- - Creación y gestión de pull requests
189
- - Configuración de pipeline CI/CD (GitHub Actions)
190
- - Limpieza de repositorio (ramas obsoletas, archivos temporales)
191
- - Generación de changelog
192
-
193
- **Puertas de Calidad (Obligatorias Antes de Push)**:
194
- - npm run lint → PASA
195
- - npm test → PASA
196
- - npm run typecheck → PASA
197
- - npm run build → PASA
198
- - Estado de historia = "Hecho" o "Listo para Revisión"
199
- - Sin cambios sin commit
200
- - Sin conflictos de merge
201
- - **Confirmación del usuario requerida**
202
-
203
- **Lógica de Versionado Semántico**:
204
- - MAJOR (v4 → v5): Cambios incompatibles, rediseño de API
205
- - MINOR (v4.31 → v4.32): Nuevas características, compatible hacia atrás
206
- - PATCH (v4.31.0 → v4.31.1): Solo corrección de errores
207
-
208
- ---
209
-
210
- ### @qa (Quinn) 🧪
211
- **Rol**: Arquitecto de Pruebas y Asesor de Calidad
212
-
213
- **Alcance Principal**:
214
- - Revisión integral de arquitectura de pruebas
215
- - Decisiones de puertas de calidad (PASA/PREOCUPACIONES/FALLA/EXENTO)
216
- - Evaluación de riesgos y estrategia de pruebas
217
- - Trazabilidad de requisitos
218
- - Asesoría (no bloquea, proporciona recomendaciones)
219
-
220
- **Operaciones Git**: Solo lectura (status, log, diff para revisión) - SIN COMMIT, SIN PUSH
221
-
222
- **Nota**: QA revisa código pero no hace commits. @dev hace commits, @github-devops hace push.
223
-
224
- ---
225
-
226
- ### @po (Sarah) 📝
227
- **Rol**: Product Owner Técnico y Custodio de Procesos
228
-
229
- **Alcance Principal**:
230
- - Gestión de backlog y refinamiento de historias
231
- - Validación de criterios de aceptación
232
- - Planificación de sprints y priorización
233
- - Adherencia a procesos y aseguramiento de calidad
234
- - Integridad del ecosistema de documentación
235
-
236
- **Operaciones Git**: Ninguna (el rol de PO es no técnico respecto a git)
237
-
238
- **Nota**: @po valida requisitos y prioriza trabajo, no interactúa con git.
239
-
240
- ---
241
-
242
- ## Ejemplos de Flujo de Trabajo
243
-
244
- ### Escenario 1: Desarrollo de Historia Estándar
245
-
246
- ```
247
- 1. Usuario: "Iniciar Historia 3.14: Agente GitHub DevOps"
248
-
249
- 2. @sm se activa:
250
- - Crea rama de características: `git checkout -b feature/3.14-github-devops-agent`
251
- - Transfiere a @dev
252
-
253
- 3. @dev se activa:
254
- - Implementa tareas de la historia
255
- - Hace commit local: `git add . && git commit -m "feat: implement pre-push quality gate"`
256
- - Marca historia: "Listo para Revisión"
257
- - Notifica al usuario: "Historia completada. Activa @github-devops para hacer push"
258
-
259
- 4. @github-devops se activa:
260
- - Ejecuta *pre-push (puertas de calidad)
261
- - TODO PASA → Presenta resumen
262
- - Usuario confirma
263
- - Hace push: `git push -u origin feature/3.14-github-devops-agent`
264
- - Crea PR: `gh pr create --title "Story 3.14: GitHub DevOps Agent" --body "..."`
265
- - Reporta: "✅ Push exitoso. PR #123 creado: https://github.com/..."
266
- ```
267
-
268
- ### Escenario 2: Diseño de Esquema de Base de Datos
269
-
270
- ```
271
- 1. Usuario: "Diseñar esquema de base de datos para autenticación de usuarios"
272
-
273
- 2. @architect se activa:
274
- - Analiza requisitos del sistema
275
- - Decide: "Usar Supabase para persistencia"
276
- - Delega: "Activando @data-architect para diseño de esquema"
277
-
278
- 3. @data-architect se activa:
279
- - Ejecuta *design-schema
280
- - Crea tablas: users, sessions, auth_providers
281
- - Diseña políticas RLS para seguridad a nivel de fila
282
- - Genera migración: `20251025_create_auth_schema.sql`
283
- - Hace commit local: `git add migrations/ && git commit -m "feat: add auth schema"`
284
- - Notifica: "Esquema diseñado. Activa @github-devops para hacer push de migración"
285
-
286
- 4. @github-devops se activa:
287
- - Ejecuta *pre-push (puertas de calidad)
288
- - Hace push de migración al repositorio
289
- ```
290
-
291
- ### Escenario 3: Creación de Release
292
-
293
- ```
294
- 1. Usuario: "Crear release v4.32.0"
295
-
296
- 2. @github-devops se activa:
297
- - Ejecuta *version-check
298
- - Analiza commits desde v4.31.0
299
- - Recomienda: "Incremento de versión MINOR (nuevas características, compatible hacia atrás)"
300
- - Usuario confirma: v4.32.0
301
- - Ejecuta *pre-push (puertas de calidad)
302
- - Genera changelog desde commits
303
- - Crea tag: `git tag v4.32.0`
304
- - Hace push: `git push && git push --tags`
305
- - Crea GitHub release: `gh release create v4.32.0 --title "Release v4.32.0" --notes "..."`
306
- - Reporta: "✅ Release v4.32.0 creado: https://github.com/.../releases/v4.32.0"
307
- ```
308
-
309
- ---
310
-
311
- ## Arquitectura de Datos vs Arquitectura de Sistema
312
-
313
- ### Matriz de Comparación
314
-
315
- | Responsabilidad | @architect | @data-architect |
316
- |-----------------|:----------:|:---------------:|
317
- | **Selección de tecnología de BD (vista de sistema)** | ✅ | 🤝 Colaborar |
318
- | **Diseño de esquema de base de datos** | ❌ Delegar | ✅ Principal |
319
- | **Optimización de consultas** | ❌ Delegar | ✅ Principal |
320
- | **Diseño de pipeline ETL** | ❌ Delegar | ✅ Principal |
321
- | **Diseño de API para acceso a datos** | ✅ Principal | 🤝 Colaborar |
322
- | **Caché a nivel de aplicación** | ✅ Principal | 🤝 Consultar |
323
- | **Optimizaciones específicas de BD (RLS, triggers)** | ❌ Delegar | ✅ Principal |
324
- | **Flujos de trabajo de ciencia de datos** | ❌ Delegar | ✅ Principal |
325
- | **Infraestructura para BD (escalado, replicación)** | ✅ Principal | 🤝 Consultar |
326
-
327
- ### Patrón de Colaboración
328
-
329
- **Pregunta**: "¿Qué base de datos deberíamos usar?"
330
- - **@architect responde**: Perspectiva de sistema (costo, despliegue, habilidades del equipo, infraestructura)
331
- - **@data-architect responde**: Perspectiva de datos (patrones de consulta, escalabilidad, ajuste del modelo de datos)
332
- - **Resultado**: Recomendación combinada
333
-
334
- **Pregunta**: "Diseñar esquema de base de datos"
335
- - **@architect**: Delega a @data-architect
336
- - **@data-architect**: Diseña esquema, crea migraciones
337
- - **@architect**: Integra esquema en sistema (API, ORM, caché)
338
-
339
- ---
340
-
341
- ## Responsabilidades de Gestión de Ramas
342
-
343
- ### Ramas Locales (@sm durante desarrollo)
344
-
345
- **Responsabilidades**:
346
- - Crear ramas de características cuando inicia historia
347
- - Gestionar ramas de trabajo del desarrollador
348
- - Limpieza de ramas locales (eliminar ramas locales mergeadas)
349
-
350
- **Comandos**:
351
- ```bash
352
- # @sm puede ejecutar:
353
- git checkout -b feature/3.14-github-devops
354
- git branch -d feature/old-branch
355
- git merge feature/branch-to-integrate
356
- ```
357
-
358
- ### Ramas Remotas (@github-devops para repositorio)
359
-
360
- **Responsabilidades**:
361
- - Hacer push de ramas a remoto
362
- - Eliminar ramas remotas (limpieza)
363
- - Gestionar ramas de release
364
- - Proteger rama main/master
365
-
366
- **Comandos**:
367
- ```bash
368
- # SOLO @github-devops puede ejecutar:
369
- git push -u origin feature/3.14-github-devops
370
- git push origin --delete feature/old-branch
371
- gh pr create
372
- gh pr merge
373
- ```
374
-
375
- ---
376
-
377
- ## Lista de Verificación de Implementación para Historia 3.14
378
-
379
- - [ ] **Crear Hook Git Pre-Push**
380
- - Ubicación: `.git/hooks/pre-push`
381
- - Contenido: Verificar `$SINAPSE_ACTIVE_AGENT`, bloquear si != "github-devops"
382
- - Hacer ejecutable: `chmod +x .git/hooks/pre-push`
383
-
384
- - [ ] **Actualizar Todas las Definiciones de Agentes** (HECHO ✅)
385
- - [x] @architect - Agregado `git_restrictions` y límites de colaboración
386
- - [x] @dev - Removido git push, agregado redirección de flujo de trabajo
387
- - [x] @sm - Clarificada gestión de ramas solo local
388
- - [x] @qa - Operaciones git de solo lectura
389
- - [x] @github-devops - Creado con autoridad exclusiva de push
390
- - [x] @data-architect - Creado con especialización en datos
391
-
392
- - [ ] **Actualizar Scripts de Activación de Agentes**
393
- - Agregar configuración de variable de entorno: `SINAPSE_ACTIVE_AGENT={agent_id}`
394
- - Configurar `SINAPSE_GIT_PUSH_ALLOWED` apropiadamente
395
-
396
- - [ ] **Configuración de IDE** (.claude/settings.json)
397
- - Agregar `agents.{id}.blockedOperations` para cada agente
398
- - Documentar en guía de configuración de IDE
399
-
400
- - [ ] **Actualizaciones de Documentación**
401
- - [x] Matriz de responsabilidad de agentes (este documento)
402
- - [ ] Actualizar git-workflow-guide.md
403
- - [ ] Actualizar documentación de onboarding de desarrolladores
404
-
405
- - [ ] **Pruebas**
406
- - Probar @dev intentando git push (debería bloquearse)
407
- - Probar @github-devops git push (debería tener éxito)
408
- - Probar puertas de calidad antes de push
409
- - Probar flujo de trabajo de creación de PR
410
-
411
- ---
412
-
413
- ## Consideraciones Futuras
414
-
415
- ### Historia 3.19: Capa de Memoria (Condicional)
416
- Si se aprueba después de auditoría de utilidades (Historia 3.17):
417
- - Capa de memoria no necesita restricciones git (utilidad, no agente)
418
- - Integración con agentes no cambia límites de responsabilidad
419
-
420
- ### Squads
421
- Si se agregan nuevos agentes vía Squads:
422
- - **Por defecto**: SIN capacidad de git push
423
- - **Proceso de Excepción**: Debe ser explícitamente aprobado por PO y justificado
424
- - **Aplicación**: Hook pre-push bloquea automáticamente a menos que ID de agente esté en lista blanca
425
-
426
- ---
427
-
428
- ## Resumen
429
-
430
- **Puntos Clave**:
431
- 1. ✅ Solo @github-devops puede hacer push al repositorio remoto (aplicado vía hooks git)
432
- 2. ✅ @architect maneja arquitectura de sistema, @data-architect maneja capa de datos
433
- 3. ✅ @sm gestiona ramas locales, @github-devops gestiona operaciones remotas
434
- 4. ✅ Puertas de calidad son obligatorias antes de cualquier push
435
- 5. ✅ Todos los agentes tienen límites claros y documentados
436
-
437
- **Aplicación**: Multi-capa (hooks + variables de entorno + definiciones de agentes + configuración de IDE)
438
-
439
- **Estado**: ✅ Listo para implementación en Historia 3.14
440
-
441
- ---
442
-
443
- *Documento mantenido por @architect (Winston) y @po (Sarah)*
444
- *Última revisión: 2025-10-25*