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,836 +0,0 @@
1
- <!--
2
- Traduccion: ES
3
- Original: /docs/en/guides/squads-guide.md
4
- Ultima sincronizacion: 2026-01-26
5
- -->
6
-
7
- # Guia de Desarrollo de Squads
8
-
9
- > 🌐 [EN](../../guides/squads-guide.md) | [PT](../../pt/guides/squads-guide.md) | **ES**
10
-
11
- ---
12
-
13
- Guia completa para crear, validar, publicar y gestionar Squads en SINAPSE.
14
-
15
- > **SINAPSE Squads:** Equipos de agentes de IA trabajando contigo
16
-
17
- ## Tabla de Contenidos
18
-
19
- 1. [Que es un Squad?](#que-es-un-squad)
20
- 2. [Inicio Rapido](#inicio-rapido)
21
- 3. [Arquitectura de Squad](#arquitectura-de-squad)
22
- 4. [Creando Squads](#creando-squads)
23
- 5. [Disenador de Squad](#disenador-de-squad)
24
- 6. [Analizando y Extendiendo Squads](#analizando--extendiendo-squads) _(NUEVO)_
25
- 7. [Validando Squads](#validando-squads)
26
- 8. [Publicacion y Distribucion](#publicacion--distribucion)
27
- 9. [Migracion desde Formato Legacy](#migracion-desde-formato-legacy)
28
- 10. [Cargador y Resolucion de Squad](#cargador-y-resolucion-de-squad)
29
- 11. [Solucion de Problemas](#solucion-de-problemas)
30
- 12. [Preguntas Frecuentes](#preguntas-frecuentes)
31
-
32
- ---
33
-
34
- ## Que es un Squad?
35
-
36
- Los Squads son equipos modulares de agentes de IA que extienden la funcionalidad de SINAPSE. Cada squad es un paquete autocontenido que incluye:
37
-
38
- | Componente | Proposito |
39
- | ----------------- | --------------------------------------------------------- |
40
- | **Agentes** | Personas de IA especificas del dominio |
41
- | **Tareas** | Flujos de trabajo ejecutables (TASK-FORMAT-SPEC-V1) |
42
- | **Workflows** | Orquestaciones de multiples pasos |
43
- | **Configuracion** | Estandares de codigo, stack tecnologico, arbol de fuentes |
44
- | **Plantillas** | Plantillas de generacion de documentos |
45
- | **Herramientas** | Integraciones de herramientas personalizadas |
46
-
47
- ### Niveles de Distribucion
48
-
49
- ```
50
- ┌─────────────────────────────────────────────────────────────┐
51
- │ DISTRIBUCION DE SQUAD │
52
- ├─────────────────────────────────────────────────────────────┤
53
- │ Nivel 1: LOCAL → ./squads/ (Privado) │
54
- │ Nivel 2: SINAPSE-SQUADS → github.com/SinapseAI (Publico/Gratis)│
55
- │ Nivel 3: SINAPSE API → api.sinapse.ai (Marketplace) │
56
- └─────────────────────────────────────────────────────────────┘
57
- ```
58
-
59
- ### Squads Oficiales
60
-
61
- | Squad | Version | Descripcion |
62
- | -------------------------------------------------------------------------- | ------- | ------------------------------------- |
63
- | [etl-squad](https://github.com/SinapseAI/sinapse-squads/tree/main/etl) | 2.0.0 | Recoleccion y transformacion de datos |
64
- | [creator-squad](https://github.com/SinapseAI/sinapse-squads/tree/main/creator) | 1.0.0 | Utilidades de generacion de contenido |
65
-
66
- ---
67
-
68
- ## Inicio Rapido
69
-
70
- ### Prerequisitos
71
-
72
- - Node.js 18+
73
- - Proyecto SINAPSE inicializado (`.sinapse-ai/` existe)
74
- - Git para control de versiones
75
-
76
- ### Opcion 1: Diseno Guiado (Recomendado)
77
-
78
- ```bash
79
- # Activar agente squad-creator
80
- @squad-creator
81
-
82
- # Disenar squad desde tu documentacion
83
- *design-squad --docs ./docs/prd/my-project.md
84
-
85
- # Revisar recomendaciones, luego crear
86
- *create-squad my-squad --from-design
87
-
88
- # Validar antes de usar
89
- *validate-squad my-squad
90
- ```
91
-
92
- ### Opcion 2: Creacion Directa
93
-
94
- ```bash
95
- @squad-creator
96
-
97
- # Crear con prompts interactivos
98
- *create-squad my-domain-squad
99
-
100
- # O especificar plantilla
101
- *create-squad my-squad --template etl
102
- ```
103
-
104
- ---
105
-
106
- ## Arquitectura de Squad
107
-
108
- ### Estructura de Directorios
109
-
110
- ```
111
- ./squads/my-squad/
112
- ├── squad.yaml # Manifiesto (requerido)
113
- ├── README.md # Documentacion
114
- ├── LICENSE # Archivo de licencia
115
- ├── config/
116
- │ ├── coding-standards.md # Reglas de estilo de codigo
117
- │ ├── tech-stack.md # Tecnologias utilizadas
118
- │ └── source-tree.md # Estructura de directorios
119
- ├── agents/
120
- │ └── my-agent.md # Definiciones de agentes
121
- ├── tasks/
122
- │ └── my-task.md # Definiciones de tareas (task-first!)
123
- ├── workflows/
124
- │ └── my-workflow.yaml # Workflows de multiples pasos
125
- ├── checklists/
126
- │ └── review-checklist.md # Listas de verificacion
127
- ├── templates/
128
- │ └── report-template.md # Plantillas de documentos
129
- ├── tools/
130
- │ └── custom-tool.js # Integraciones de herramientas personalizadas
131
- ├── scripts/
132
- │ └── setup.js # Scripts de utilidad
133
- └── data/
134
- └── reference-data.json # Archivos de datos estaticos
135
- ```
136
-
137
- ### Manifiesto de Squad (squad.yaml)
138
-
139
- ```yaml
140
- # Campos requeridos
141
- name: my-squad # kebab-case, identificador unico
142
- version: 1.0.0 # Versionado semantico
143
- description: Lo que hace este squad
144
-
145
- # Metadatos
146
- author: Tu Nombre <email@example.com>
147
- license: MIT
148
- slashPrefix: my # Prefijo de comando para IDE
149
-
150
- # Compatibilidad SINAPSE
151
- sinapse:
152
- minVersion: '2.1.0'
153
- type: squad
154
-
155
- # Declaracion de componentes
156
- components:
157
- agents:
158
- - my-agent.md
159
- tasks:
160
- - my-task.md
161
- workflows: []
162
- checklists: []
163
- templates: []
164
- tools: []
165
- scripts: []
166
-
167
- # Herencia de configuracion
168
- config:
169
- extends: extend # extend | override | none
170
- coding-standards: config/coding-standards.md
171
- tech-stack: config/tech-stack.md
172
- source-tree: config/source-tree.md
173
-
174
- # Dependencias
175
- dependencies:
176
- node: [] # paquetes npm
177
- python: [] # paquetes pip
178
- squads: [] # Otros squads
179
-
180
- # Etiquetas de descubrimiento
181
- tags:
182
- - domain-specific
183
- - automation
184
- ```
185
-
186
- ### Arquitectura Task-First
187
-
188
- Los Squads siguen una **arquitectura task-first** donde las tareas son el punto de entrada principal:
189
-
190
- ```
191
- Solicitud del Usuario → Tarea → Ejecucion del Agente → Salida
192
-
193
- Workflow (si es multi-paso)
194
- ```
195
-
196
- Las tareas deben seguir [TASK-FORMAT-SPECIFICATION-V1](../../../.sinapse-ai/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md).
197
-
198
- ---
199
-
200
- ## Creando Squads
201
-
202
- ### Usando el Agente @squad-creator
203
-
204
- ```bash
205
- # Activar el agente
206
- @squad-creator
207
-
208
- # Ver todos los comandos
209
- *help
210
- ```
211
-
212
- ### Comandos Disponibles
213
-
214
- | Comando | Descripcion |
215
- | ---------------------------------------- | ---------------------------------------------- |
216
- | `*create-squad {name}` | Crear nuevo squad con prompts |
217
- | `*create-squad {name} --template {type}` | Crear desde plantilla (basic, etl, agent-only) |
218
- | `*create-squad {name} --from-design` | Crear desde blueprint de diseno |
219
- | `*validate-squad {name}` | Validar estructura del squad |
220
- | `*list-squads` | Listar todos los squads locales |
221
- | `*design-squad` | Disenar squad desde documentacion |
222
-
223
- ### Plantillas
224
-
225
- | Plantilla | Caso de Uso |
226
- | ------------ | ------------------------------------------ |
227
- | `basic` | Squad simple con un agente y una tarea |
228
- | `etl` | Extraccion, transformacion, carga de datos |
229
- | `agent-only` | Squad con agentes, sin tareas |
230
-
231
- ### Modos de Herencia de Configuracion
232
-
233
- | Modo | Comportamiento |
234
- | ---------- | -------------------------------------------------- |
235
- | `extend` | Agregar reglas del squad a las reglas base de SINAPSE |
236
- | `override` | Reemplazar reglas base con reglas del squad |
237
- | `none` | Configuracion independiente |
238
-
239
- ---
240
-
241
- ## Disenador de Squad
242
-
243
- El Disenador de Squad analiza tu documentacion y recomienda agentes y tareas.
244
-
245
- ### Uso
246
-
247
- ```bash
248
- @squad-creator
249
-
250
- # Diseno interactivo
251
- *design-squad
252
-
253
- # Disenar desde archivos especificos
254
- *design-squad --docs ./docs/prd/requirements.md ./docs/specs/api.md
255
-
256
- # Especificar contexto de dominio
257
- *design-squad --domain casting --docs ./docs/
258
- ```
259
-
260
- ### Flujo de Trabajo
261
-
262
- 1. **Recopilar Documentacion** - Proporcionar PRDs, especificaciones, requisitos
263
- 2. **Analisis de Dominio** - El sistema extrae conceptos, flujos de trabajo, roles
264
- 3. **Recomendaciones de Agentes** - Revisar agentes sugeridos
265
- 4. **Recomendaciones de Tareas** - Revisar tareas sugeridas
266
- 5. **Generar Blueprint** - Guardar en `.squad-design.yaml`
267
- 6. **Crear desde Blueprint** - `*create-squad my-squad --from-design`
268
-
269
- ### Formato de Blueprint
270
-
271
- ```yaml
272
- # .squad-design.yaml
273
- metadata:
274
- domain: casting
275
- created: 2025-12-26T10:00:00Z
276
- source_docs:
277
- - ./docs/prd/casting-system.md
278
-
279
- recommended_agents:
280
- - name: casting-coordinator
281
- role: Coordina flujos de trabajo de casting
282
- confidence: 0.92
283
-
284
- recommended_tasks:
285
- - name: process-submission
286
- description: Procesar envio de actor
287
- agent: casting-coordinator
288
- confidence: 0.88
289
- ```
290
-
291
- ---
292
-
293
- ## Analizando y Extendiendo Squads
294
-
295
- Despues de crear un squad, puedes analizar su estructura y extenderlo con nuevos componentes usando los comandos `*analyze-squad` y `*extend-squad`.
296
-
297
- ### Analizando Squads
298
-
299
- ```bash
300
- @squad-creator
301
-
302
- # Analisis basico
303
- *analyze-squad my-squad
304
-
305
- # Incluir detalles de archivos
306
- *analyze-squad my-squad --verbose
307
-
308
- # Guardar a archivo markdown
309
- *analyze-squad my-squad --format markdown
310
-
311
- # Salida como JSON
312
- *analyze-squad my-squad --format json
313
- ```
314
-
315
- ### Salida del Analisis
316
-
317
- ```
318
- === Analisis del Squad: my-squad ===
319
-
320
- Resumen
321
- Nombre: my-squad
322
- Version: 1.0.0
323
- Autor: Tu Nombre
324
-
325
- Componentes
326
- agents/ (2)
327
- - lead-agent.md
328
- - helper-agent.md
329
- tasks/ (3)
330
- - lead-agent-task1.md
331
- - lead-agent-task2.md
332
- - helper-agent-task1.md
333
- workflows/ (0) <- Vacio
334
- checklists/ (0) <- Vacio
335
-
336
- Cobertura
337
- Agentes: [#####-----] 50% (1/2 con tareas)
338
- Tareas: [########--] 80% (3 tareas)
339
- Directorios: [##--------] 25% (2/8 poblados)
340
-
341
- Sugerencias
342
- 1. [!] Agregar tareas para helper-agent (actualmente tiene solo 1)
343
- 2. [*] Crear workflows para secuencias comunes
344
- 3. [-] Agregar checklists para validacion
345
-
346
- Siguiente: *extend-squad my-squad
347
- ```
348
-
349
- ### Extendiendo Squads
350
-
351
- Agregar nuevos componentes a squads existentes con actualizaciones automaticas del manifiesto:
352
-
353
- ```bash
354
- @squad-creator
355
-
356
- # Modo interactivo (guiado)
357
- *extend-squad my-squad
358
-
359
- # Modo directo - Agregar agente
360
- *extend-squad my-squad --add agent --name analytics-agent
361
-
362
- # Agregar tarea con vinculacion de agente
363
- *extend-squad my-squad --add task --name process-data --agent lead-agent
364
-
365
- # Agregar workflow con referencia a historia
366
- *extend-squad my-squad --add workflow --name daily-processing --story SQS-11
367
-
368
- # Agregar todos los tipos de componentes
369
- *extend-squad my-squad --add template --name report-template
370
- *extend-squad my-squad --add tool --name data-validator
371
- *extend-squad my-squad --add checklist --name quality-checklist
372
- *extend-squad my-squad --add script --name migration-helper
373
- *extend-squad my-squad --add data --name config-data
374
- ```
375
-
376
- ### Flujo Interactivo de Extension
377
-
378
- ```
379
- @squad-creator
380
- *extend-squad my-squad
381
-
382
- ? Que te gustaria agregar?
383
- 1. Agent - Nueva persona de agente
384
- 2. Task - Nueva tarea para un agente
385
- 3. Workflow - Workflow de multiples pasos
386
- 4. Checklist - Lista de verificacion
387
- 5. Template - Plantilla de documento
388
- 6. Tool - Herramienta personalizada (JavaScript)
389
- 7. Script - Script de automatizacion
390
- 8. Data - Archivo de datos estaticos (YAML)
391
-
392
- > 2
393
-
394
- ? Nombre de la tarea: process-data
395
- ? Que agente es dueno de esta tarea?
396
- 1. lead-agent
397
- 2. helper-agent
398
- > 1
399
- ? Descripcion de la tarea (opcional): Procesar datos entrantes y generar salida
400
- ? Vincular a historia? (dejar vacio para omitir): SQS-11
401
-
402
- Creando tarea...
403
- Creado: tasks/lead-agent-process-data.md
404
- Actualizado: squad.yaml (agregado a components.tasks)
405
- Validacion: APROBADA
406
-
407
- Siguientes pasos:
408
- 1. Editar tasks/lead-agent-process-data.md
409
- 2. Agregar entrada/salida/checklist
410
- 3. Ejecutar: *validate-squad my-squad
411
- ```
412
-
413
- ### Tipos de Componentes
414
-
415
- | Tipo | Directorio | Extension | Descripcion |
416
- | --------- | ----------- | --------- | ---------------------------------------- |
417
- | agent | agents/ | .md | Definicion de persona de agente |
418
- | task | tasks/ | .md | Flujo de trabajo de tarea ejecutable |
419
- | workflow | workflows/ | .yaml | Orquestacion de multiples pasos |
420
- | checklist | checklists/ | .md | Lista de verificacion de validacion |
421
- | template | templates/ | .md | Plantilla de generacion de documentos |
422
- | tool | tools/ | .js | Integracion de herramienta personalizada |
423
- | script | scripts/ | .js | Script de automatizacion de utilidad |
424
- | data | data/ | .yaml | Configuracion de datos estaticos |
425
-
426
- ### Flujo de Trabajo de Mejora Continua
427
-
428
- ```bash
429
- # 1. Analizar estado actual
430
- *analyze-squad my-squad
431
-
432
- # 2. Revisar sugerencias y metricas de cobertura
433
-
434
- # 3. Agregar componentes faltantes
435
- *extend-squad my-squad --add task --name new-task --agent lead-agent
436
- *extend-squad my-squad --add checklist --name quality-checklist
437
-
438
- # 4. Re-analizar para verificar mejora
439
- *analyze-squad my-squad
440
-
441
- # 5. Validar antes de usar
442
- *validate-squad my-squad
443
- ```
444
-
445
- ### Uso Programatico
446
-
447
- ```javascript
448
- const { SquadAnalyzer } = require('./.sinapse-ai/development/scripts/squad/squad-analyzer');
449
- const { SquadExtender } = require('./.sinapse-ai/development/scripts/squad/squad-extender');
450
-
451
- // Analizar squad
452
- const analyzer = new SquadAnalyzer({ squadsPath: './squads' });
453
- const analysis = await analyzer.analyze('my-squad');
454
-
455
- console.log('Cobertura:', analysis.coverage);
456
- console.log('Sugerencias:', analysis.suggestions);
457
-
458
- // Extender squad
459
- const extender = new SquadExtender({ squadsPath: './squads' });
460
- const result = await extender.addComponent('my-squad', {
461
- type: 'task',
462
- name: 'new-task',
463
- agentId: 'lead-agent',
464
- description: 'Una nueva tarea',
465
- storyId: 'SQS-11',
466
- });
467
-
468
- console.log('Creado:', result.filePath);
469
- console.log('Manifiesto actualizado:', result.manifestUpdated);
470
- ```
471
-
472
- ---
473
-
474
- ## Validando Squads
475
-
476
- ### Validacion Basica
477
-
478
- ```bash
479
- @squad-creator
480
- *validate-squad my-squad
481
- ```
482
-
483
- ### Modo Estricto (para CI/CD)
484
-
485
- ```bash
486
- *validate-squad my-squad --strict
487
- ```
488
-
489
- Trata las advertencias como errores.
490
-
491
- ### Verificaciones de Validacion
492
-
493
- | Verificacion | Descripcion |
494
- | ----------------------------- | ------------------------------------- |
495
- | **Esquema del Manifiesto** | squad.yaml contra JSON Schema |
496
- | **Estructura de Directorios** | Las carpetas requeridas existen |
497
- | **Formato de Tareas** | Las tareas siguen TASK-FORMAT-SPEC-V1 |
498
- | **Definiciones de Agentes** | Los agentes tienen campos requeridos |
499
- | **Dependencias** | Los archivos referenciados existen |
500
-
501
- ### Salida de Validacion
502
-
503
- ```
504
- Validando squad: my-squad
505
- ═══════════════════════════
506
-
507
- Manifiesto: Valido
508
- Estructura: Completa
509
- Tareas: 3/3 validas
510
- Agentes: 2/2 validos
511
- Advertencias:
512
- - README.md es minimo (considera expandirlo)
513
-
514
- Resumen: VALIDO (3 advertencias)
515
- ```
516
-
517
- ### Validacion Programatica
518
-
519
- ```javascript
520
- const { SquadValidator } = require('./.sinapse-ai/development/scripts/squad');
521
-
522
- const validator = new SquadValidator({ strict: false });
523
- const result = await validator.validate('./squads/my-squad');
524
-
525
- console.log(result);
526
- // { valid: true, errors: [], warnings: [...], suggestions: [...] }
527
- ```
528
-
529
- ---
530
-
531
- ## Publicacion y Distribucion
532
-
533
- ### Nivel 1: Local (Privado)
534
-
535
- Los Squads en `./squads/` estan automaticamente disponibles para tu proyecto.
536
-
537
- ```bash
538
- # Listar squads locales
539
- *list-squads
540
- ```
541
-
542
- ### Nivel 2: Repositorio sinapse-squads (Publico)
543
-
544
- ```bash
545
- @squad-creator
546
-
547
- # Validar primero
548
- *validate-squad my-squad --strict
549
-
550
- # Publicar en GitHub
551
- *publish-squad ./squads/my-squad
552
- ```
553
-
554
- Esto crea un PR a [SinapseAI/sinapse-squads](https://github.com/SinapseAI/sinapse-squads).
555
-
556
- ### Nivel 3: Marketplace de SINAPSE
557
-
558
- ```bash
559
- # Configurar autenticacion
560
- export SINAPSE_API_TOKEN="your-token"
561
-
562
- # Sincronizar al marketplace
563
- *sync-squad-sinapse ./squads/my-squad --public
564
- ```
565
-
566
- ### Descargando Squads
567
-
568
- ```bash
569
- @squad-creator
570
-
571
- # Listar squads disponibles
572
- *download-squad --list
573
-
574
- # Descargar squad especifico
575
- *download-squad etl-squad
576
-
577
- # Descargar version especifica
578
- *download-squad etl-squad@2.0.0
579
- ```
580
-
581
- ---
582
-
583
- ## Migracion desde Formato Legacy
584
-
585
- ### Detectando Squads Legacy
586
-
587
- Los squads legacy usan `config.yaml` en lugar de `squad.yaml` y pueden faltar:
588
-
589
- - Campo `sinapse.type`
590
- - Campo `sinapse.minVersion`
591
- - Estructura task-first
592
-
593
- ### Comando de Migracion
594
-
595
- ```bash
596
- @squad-creator
597
-
598
- # Vista previa de cambios
599
- *migrate-squad ./squads/legacy-squad --dry-run
600
-
601
- # Ejecutar migracion
602
- *migrate-squad ./squads/legacy-squad
603
-
604
- # Salida detallada
605
- *migrate-squad ./squads/legacy-squad --verbose
606
- ```
607
-
608
- ### Pasos de Migracion
609
-
610
- 1. **Respaldo** - Crea `.backup/pre-migration-{timestamp}/`
611
- 2. **Renombrar** - `config.yaml` → `squad.yaml`
612
- 3. **Agregar Campos** - `sinapse.type`, `sinapse.minVersion`
613
- 4. **Reestructurar** - Organizar en diseño task-first
614
- 5. **Validar** - Ejecutar validacion en el squad migrado
615
-
616
- ### Rollback
617
-
618
- ```bash
619
- # Restaurar desde respaldo
620
- cp -r ./squads/my-squad/.backup/pre-migration-*/. ./squads/my-squad/
621
- ```
622
-
623
- Ver [Guia de Migracion de Squad](./squad-migration.md) para escenarios detallados.
624
-
625
- ---
626
-
627
- ## Cargador y Resolucion de Squad
628
-
629
- ### Cadena de Resolucion
630
-
631
- El Cargador de Squad resuelve squads en este orden:
632
-
633
- ```
634
- 1. Local → ./squads/{name}/
635
- 2. npm → node_modules/@sinapse-squads/{name}/
636
- 3. Workspace → ../{name}/ (monorepo)
637
- 4. Registry → api.sinapse.ai/squads/{name}
638
- ```
639
-
640
- ### Uso Programatico
641
-
642
- ```javascript
643
- const { SquadLoader } = require('./.sinapse-ai/development/scripts/squad');
644
-
645
- const loader = new SquadLoader({
646
- squadsPath: './squads',
647
- verbose: false,
648
- });
649
-
650
- // Resolver ruta del squad
651
- const { path, manifestPath } = await loader.resolve('my-squad');
652
-
653
- // Cargar manifiesto
654
- const manifest = await loader.loadManifest('./squads/my-squad');
655
-
656
- // Listar todos los squads locales
657
- const squads = await loader.listLocal();
658
- // [{ name: 'my-squad', path: './squads/my-squad', manifestPath: '...' }]
659
- ```
660
-
661
- ### Manejo de Errores
662
-
663
- ```javascript
664
- const { SquadLoader, SquadLoaderError } = require('./.sinapse-ai/development/scripts/squad');
665
-
666
- try {
667
- await loader.resolve('non-existent');
668
- } catch (error) {
669
- if (error instanceof SquadLoaderError) {
670
- console.error(`[${error.code}] ${error.message}`);
671
- console.log(`Sugerencia: ${error.suggestion}`);
672
- }
673
- }
674
- ```
675
-
676
- ### Codigos de Error
677
-
678
- | Codigo | Descripcion | Solucion |
679
- | -------------------- | ---------------------------------- | ------------------------- |
680
- | `SQUAD_NOT_FOUND` | Directorio del squad no encontrado | Crear con `*create-squad` |
681
- | `MANIFEST_NOT_FOUND` | Sin archivo de manifiesto | Crear `squad.yaml` |
682
- | `YAML_PARSE_ERROR` | Sintaxis YAML invalida | Usar validador YAML |
683
- | `PERMISSION_DENIED` | Error de permisos de archivo | Verificar `chmod 644` |
684
-
685
- ---
686
-
687
- ## Solucion de Problemas
688
-
689
- ### "Squad not found"
690
-
691
- ```bash
692
- # Verificar que el directorio squads existe
693
- ls ./squads/
694
-
695
- # Verificar manifiesto
696
- cat ./squads/my-squad/squad.yaml
697
-
698
- # Verificar resolucion
699
- @squad-creator
700
- *list-squads
701
- ```
702
-
703
- ### Errores de Validacion
704
-
705
- ```bash
706
- # Obtener errores detallados
707
- *validate-squad my-squad --verbose
708
-
709
- # Correcciones comunes:
710
- # - name: debe ser kebab-case
711
- # - version: debe ser semver (x.y.z)
712
- # - sinapse.type: debe ser "squad"
713
- # - sinapse.minVersion: debe ser semver valido
714
- ```
715
-
716
- ### Errores de Parseo YAML
717
-
718
- ```bash
719
- # Validar sintaxis YAML en linea o con:
720
- npx js-yaml ./squads/my-squad/squad.yaml
721
- ```
722
-
723
- Problemas comunes:
724
-
725
- - Indentacion incorrecta (usar 2 espacios)
726
- - Comillas faltantes alrededor de caracteres especiales
727
- - Tabs en lugar de espacios
728
-
729
- ### Fallos de Migracion
730
-
731
- ```bash
732
- # Verificar que el respaldo existe
733
- ls ./squads/my-squad/.backup/
734
-
735
- # Restaurar y reintentar
736
- cp -r ./squads/my-squad/.backup/pre-migration-*/. ./squads/my-squad/
737
- *migrate-squad ./squads/my-squad --verbose
738
- ```
739
-
740
- ### Errores de Publicacion
741
-
742
- ```bash
743
- # Verificar autenticacion de GitHub
744
- gh auth status
745
-
746
- # Verificar validacion del squad
747
- *validate-squad my-squad --strict
748
-
749
- # Verificar conflictos de nombres
750
- *download-squad --list | grep my-squad
751
- ```
752
-
753
- ---
754
-
755
- ## Preguntas Frecuentes
756
-
757
- ### Cual es la diferencia entre un Squad y formatos legados de squad en SINAPSE?
758
-
759
- **Squads** son el formato estandar en SINAPSE 2.1+ con:
760
-
761
- - Arquitectura task-first
762
- - Validacion con JSON Schema
763
- - Distribucion de tres niveles
764
- - Mejores herramientas (`@squad-creator`)
765
-
766
- ### Puedo usar Squads de diferentes fuentes juntos?
767
-
768
- Si. El Cargador de Squad resuelve desde multiples fuentes. Los squads locales tienen precedencia.
769
-
770
- ### Como actualizo un Squad publicado?
771
-
772
- 1. Actualizar version en `squad.yaml` (semver)
773
- 2. Ejecutar `*validate-squad --strict`
774
- 3. Re-publicar: `*publish-squad` o `*sync-squad-sinapse`
775
-
776
- ### Pueden los Squads depender de otros Squads?
777
-
778
- Si, declarar en `dependencies.squads`:
779
-
780
- ```yaml
781
- dependencies:
782
- squads:
783
- - etl-squad@^2.0.0
784
- ```
785
-
786
- ### Como hago un Squad privado?
787
-
788
- - **Nivel 1**: Mantener en `./squads/` (sin commit) - agregar a `.gitignore`
789
- - **Nivel 3**: Sincronizar con bandera `--private`: `*sync-squad-sinapse my-squad --private`
790
-
791
- ### Cual es la version minima de SINAPSE para Squads?
792
-
793
- Los Squads requieren SINAPSE 2.1.0+. Configurar en el manifiesto:
794
-
795
- ```yaml
796
- sinapse:
797
- minVersion: '2.1.0'
798
- ```
799
-
800
- ### Como pruebo mi Squad antes de publicar?
801
-
802
- ```bash
803
- # 1. Validar estructura
804
- *validate-squad my-squad --strict
805
-
806
- # 2. Probar localmente
807
- @my-agent # Activar agente del squad
808
- *my-task # Ejecutar tarea del squad
809
-
810
- # 3. Ejecutar pruebas del squad (si estan definidas)
811
- npm test -- tests/squads/my-squad/
812
- ```
813
-
814
- ---
815
-
816
- ## Recursos Relacionados
817
-
818
- - [TASK-FORMAT-SPECIFICATION-V1](../../../.sinapse-ai/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md)
819
- - [Guia de Contribucion de Squads](./contributing-squads.md)
820
- - [Guia de Migracion de Squad](./squad-migration.md)
821
- - [Referencia de API de Squads](../api/squads-api.md)
822
- - [Agente @squad-creator](../../../.sinapse-ai/development/agents/squad-creator.md)
823
- - [Repositorio sinapse-squads](https://github.com/SinapseAI/sinapse-squads)
824
-
825
- ---
826
-
827
- ## Obteniendo Ayuda
828
-
829
- - [Discusiones de GitHub](https://github.com/SinapseAI/sinapse-ai/discussions)
830
- - [Rastreador de Issues](https://github.com/SinapseAI/sinapse-ai/issues)
831
-
832
- ---
833
-
834
- _SINAPSE Squads: Equipos de agentes de IA trabajando contigo_
835
-
836
- **Version:** 2.1.0 | **Actualizado:** 2025-12-26 | **Stories:** SQS-8, SQS-11