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.
- package/.claude/CLAUDE.md +1 -1
- package/.claude/rules/agent-authority.md +10 -10
- package/.claude/rules/agent-memory-imports.md +4 -4
- package/.claude/rules/coderabbit-integration.md +4 -4
- package/.claude/rules/ids-principles.md +5 -5
- package/.claude/rules/story-lifecycle.md +15 -15
- package/.claude/rules/workflow-execution.md +11 -11
- package/.sinapse-ai/constitution.md +3 -3
- package/.sinapse-ai/core/code-intel/helpers/dev-helper.js +1 -1
- package/.sinapse-ai/core/code-intel/helpers/qa-helper.js +1 -1
- package/.sinapse-ai/core/code-intel/helpers/story-helper.js +7 -7
- package/.sinapse-ai/core/config/config-loader.js +1 -1
- package/.sinapse-ai/core/docs/session-update-pattern.md +1 -1
- package/.sinapse-ai/core/ids/framework-governor.js +4 -4
- package/.sinapse-ai/core/ids/index.js +1 -1
- package/.sinapse-ai/core/memory/gotchas-memory.js +1 -1
- package/.sinapse-ai/core/orchestration/agent-invoker.js +1 -1
- package/.sinapse-ai/core/orchestration/bob-surface-criteria.yaml +2 -2
- package/.sinapse-ai/core/orchestration/executor-assignment.js +1 -1
- package/.sinapse-ai/core/orchestration/executors/epic-6-executor.js +1 -1
- package/.sinapse-ai/core/orchestration/executors/epic-executor.js +1 -1
- package/.sinapse-ai/core/orchestration/greenfield-handler.js +4 -4
- package/.sinapse-ai/core/orchestration/master-orchestrator.js +1 -1
- package/.sinapse-ai/core/orchestration/skill-dispatcher.js +3 -3
- package/.sinapse-ai/core/orchestration/workflow-executor.js +1 -1
- package/.sinapse-ai/core/quality-gates/layer2-pr-automation.js +3 -3
- package/.sinapse-ai/core/quality-gates/layer3-human-review.js +1 -1
- package/.sinapse-ai/core/quality-gates/quality-gate-config.yaml +1 -1
- package/.sinapse-ai/core/session/context-loader.js +1 -1
- package/.sinapse-ai/data/agent-config-requirements.yaml +3 -3
- package/.sinapse-ai/data/entity-registry.yaml +2154 -2337
- package/.sinapse-ai/data/registry-update-log.jsonl +316 -0
- package/.sinapse-ai/data/sinapse-kb.md +13 -13
- package/.sinapse-ai/data/tech-presets/csharp.md +2 -2
- package/.sinapse-ai/data/tech-presets/go.md +2 -2
- package/.sinapse-ai/data/tech-presets/java.md +2 -2
- package/.sinapse-ai/data/tech-presets/nextjs-react.md +1 -1
- package/.sinapse-ai/data/tech-presets/php.md +2 -2
- package/.sinapse-ai/data/tech-presets/rust.md +2 -2
- package/.sinapse-ai/data/technical-preferences.md +1 -1
- package/.sinapse-ai/data/workflow-chains.yaml +15 -15
- package/.sinapse-ai/development/README.md +1 -1
- package/.sinapse-ai/development/agent-teams/team-qa-focused.yaml +7 -7
- package/.sinapse-ai/development/agents/analyst.md +6 -6
- package/.sinapse-ai/development/agents/architect.md +4 -4
- package/.sinapse-ai/development/agents/data-engineer.md +2 -2
- package/.sinapse-ai/development/agents/{dev.md → developer.md} +7 -7
- package/.sinapse-ai/development/agents/devops.md +4 -4
- package/.sinapse-ai/development/agents/{po → product-lead}/MEMORY.md +3 -3
- package/.sinapse-ai/development/agents/{po.md → product-lead.md} +25 -25
- package/.sinapse-ai/development/agents/{pm → project-lead}/MEMORY.md +2 -2
- package/.sinapse-ai/development/agents/{pm.md → project-lead.md} +15 -15
- package/.sinapse-ai/development/agents/{qa.md → quality-gate.md} +8 -8
- package/.sinapse-ai/development/agents/{sinapse-master.md → sinapse-orqx.md} +12 -12
- package/.sinapse-ai/development/agents/{sm.md → sprint-lead.md} +18 -18
- package/.sinapse-ai/development/agents/squad-creator.md +4 -4
- package/.sinapse-ai/development/agents/ux-design-expert.md +2 -2
- package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +1 -1
- package/.sinapse-ai/development/checklists/memory-audit-checklist.md +1 -1
- package/.sinapse-ai/development/scripts/agent-config-loader.js +1 -1
- package/.sinapse-ai/development/scripts/apply-inline-greeting-all-agents.js +1 -1
- package/.sinapse-ai/development/scripts/audit-agent-config.js +2 -2
- package/.sinapse-ai/development/scripts/batch-update-agents-session-context.js +1 -1
- package/.sinapse-ai/development/scripts/dev-context-loader.js +1 -1
- package/.sinapse-ai/development/scripts/populate-entity-registry.js +2 -2
- package/.sinapse-ai/development/scripts/test-greeting-system.js +4 -4
- package/.sinapse-ai/development/scripts/unified-activation-pipeline.js +2 -2
- package/.sinapse-ai/development/scripts/verify-workflow-gaps.js +9 -9
- package/.sinapse-ai/development/tasks/analyze-cross-artifact.md +1 -1
- package/.sinapse-ai/development/tasks/analyze-project-structure.md +4 -4
- package/.sinapse-ai/development/tasks/apply-qa-fixes.md +1 -1
- package/.sinapse-ai/development/tasks/architect-analyze-impact.md +1 -1
- package/.sinapse-ai/development/tasks/brownfield-create-epic.md +10 -10
- package/.sinapse-ai/development/tasks/brownfield-create-story.md +1 -1
- package/.sinapse-ai/development/tasks/build-autonomous.md +1 -1
- package/.sinapse-ai/development/tasks/cleanup-utilities.md +6 -6
- package/.sinapse-ai/development/tasks/create-agent.md +1 -1
- package/.sinapse-ai/development/tasks/create-brownfield-story.md +4 -4
- package/.sinapse-ai/development/tasks/create-next-story.md +12 -12
- package/.sinapse-ai/development/tasks/create-service.md +2 -2
- package/.sinapse-ai/development/tasks/create-suite.md +1 -1
- package/.sinapse-ai/development/tasks/dev-backlog-debt.md +3 -3
- package/.sinapse-ai/development/tasks/dev-develop-story.md +5 -5
- package/.sinapse-ai/development/tasks/environment-bootstrap.md +2 -2
- package/.sinapse-ai/development/tasks/execute-checklist.md +1 -1
- package/.sinapse-ai/development/tasks/execute-epic-plan.md +11 -11
- package/.sinapse-ai/development/tasks/extract-patterns.md +2 -2
- package/.sinapse-ai/development/tasks/facilitate-brainstorming-session.md +2 -2
- package/.sinapse-ai/development/tasks/github-devops-github-pr-automation.md +1 -1
- package/.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md +1 -1
- package/.sinapse-ai/development/tasks/ids-governor.md +3 -3
- package/.sinapse-ai/development/tasks/next.md +2 -2
- package/.sinapse-ai/development/tasks/orchestrate-resume.md +1 -1
- package/.sinapse-ai/development/tasks/orchestrate-status.md +1 -1
- package/.sinapse-ai/development/tasks/orchestrate-stop.md +1 -1
- package/.sinapse-ai/development/tasks/orchestrate.md +1 -1
- package/.sinapse-ai/development/tasks/patterns.md +2 -2
- package/.sinapse-ai/development/tasks/plan-create-context.md +2 -2
- package/.sinapse-ai/development/tasks/plan-execute-subtask.md +3 -3
- package/.sinapse-ai/development/tasks/po-close-story.md +3 -3
- package/.sinapse-ai/development/tasks/project-status.md +2 -2
- package/.sinapse-ai/development/tasks/qa-after-creation.md +2 -2
- package/.sinapse-ai/development/tasks/qa-backlog-add-followup.md +3 -3
- package/.sinapse-ai/development/tasks/qa-create-fix-request.md +8 -8
- package/.sinapse-ai/development/tasks/qa-evidence-requirements.md +1 -1
- package/.sinapse-ai/development/tasks/qa-false-positive-detection.md +1 -1
- package/.sinapse-ai/development/tasks/qa-fix-issues.md +10 -10
- package/.sinapse-ai/development/tasks/qa-gate.md +3 -3
- package/.sinapse-ai/development/tasks/qa-review-build.md +3 -3
- package/.sinapse-ai/development/tasks/qa-review-story.md +2 -2
- package/.sinapse-ai/development/tasks/qa-run-tests.md +1 -1
- package/.sinapse-ai/development/tasks/run-workflow-engine.md +1 -1
- package/.sinapse-ai/development/tasks/run-workflow.md +1 -1
- package/.sinapse-ai/development/tasks/security-scan.md +2 -2
- package/.sinapse-ai/development/tasks/setup-llm-routing.md +1 -1
- package/.sinapse-ai/development/tasks/spec-critique.md +4 -4
- package/.sinapse-ai/development/tasks/spec-gather-requirements.md +4 -4
- package/.sinapse-ai/development/tasks/spec-write-spec.md +2 -2
- package/.sinapse-ai/development/tasks/story-checkpoint.md +3 -3
- package/.sinapse-ai/development/tasks/sync-registry-intel.md +1 -1
- package/.sinapse-ai/development/tasks/validate-agents.md +1 -1
- package/.sinapse-ai/development/tasks/validate-next-story.md +10 -10
- package/.sinapse-ai/development/tasks/validate-workflow.md +1 -1
- package/.sinapse-ai/development/tasks/verify-subtask.md +2 -2
- package/.sinapse-ai/development/templates/code-intel-integration-pattern.md +3 -3
- package/.sinapse-ai/development/templates/subagent-step-prompt.md +2 -2
- package/.sinapse-ai/development/workflows/README.md +2 -2
- package/.sinapse-ai/development/workflows/auto-worktree.yaml +5 -5
- package/.sinapse-ai/development/workflows/brownfield-discovery.yaml +11 -11
- package/.sinapse-ai/development/workflows/brownfield-fullstack.yaml +6 -6
- package/.sinapse-ai/development/workflows/brownfield-service.yaml +5 -5
- package/.sinapse-ai/development/workflows/brownfield-ui.yaml +5 -5
- package/.sinapse-ai/development/workflows/development-cycle.yaml +10 -10
- package/.sinapse-ai/development/workflows/epic-orchestration.yaml +6 -6
- package/.sinapse-ai/development/workflows/greenfield-fullstack.yaml +7 -7
- package/.sinapse-ai/development/workflows/greenfield-service.yaml +5 -5
- package/.sinapse-ai/development/workflows/greenfield-ui.yaml +5 -5
- package/.sinapse-ai/development/workflows/qa-loop.yaml +1 -1
- package/.sinapse-ai/development/workflows/spec-pipeline.yaml +2 -2
- package/.sinapse-ai/development/workflows/story-development-cycle.yaml +1 -1
- package/.sinapse-ai/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +2 -2
- package/.sinapse-ai/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +1 -1
- package/.sinapse-ai/docs/standards/QUALITY-GATES-SPECIFICATION.md +1 -1
- package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md +6 -6
- package/.sinapse-ai/docs/standards/STANDARDS-INDEX.md +2 -2
- package/.sinapse-ai/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +6 -6
- package/.sinapse-ai/infrastructure/scripts/config-loader.js +2 -2
- package/.sinapse-ai/infrastructure/scripts/gotchas-documenter.js +1 -1
- package/.sinapse-ai/infrastructure/scripts/ide-sync/README.md +3 -3
- package/.sinapse-ai/infrastructure/scripts/ide-sync/gemini-commands.js +1 -1
- package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +2 -2
- package/.sinapse-ai/infrastructure/scripts/ide-sync/redirect-generator.js +2 -2
- package/.sinapse-ai/infrastructure/scripts/migrate-agent.js +1 -1
- package/.sinapse-ai/infrastructure/scripts/performance-tracker.js +2 -2
- package/.sinapse-ai/infrastructure/scripts/qa-report-generator.js +1 -1
- package/.sinapse-ai/infrastructure/scripts/recovery-tracker.js +1 -1
- package/.sinapse-ai/infrastructure/scripts/rollback-manager.js +1 -1
- package/.sinapse-ai/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +1 -1
- package/.sinapse-ai/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +1 -1
- package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +1 -1
- package/.sinapse-ai/install-manifest.yaml +344 -344
- package/.sinapse-ai/monitor/hooks/lib/enrich.py +1 -1
- package/.sinapse-ai/product/checklists/self-critique-checklist.md +1 -1
- package/.sinapse-ai/product/checklists/story-draft-checklist.md +3 -3
- package/.sinapse-ai/product/templates/command-rationalization-matrix.md +3 -3
- package/.sinapse-ai/product/templates/design-story-tmpl.yaml +4 -4
- package/.sinapse-ai/product/templates/ide-rules/antigravity-rules.md +1 -1
- package/.sinapse-ai/product/templates/ide-rules/claude-rules.md +2 -2
- package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +6 -6
- package/.sinapse-ai/product/templates/ide-rules/cursor-rules.md +1 -1
- package/.sinapse-ai/product/templates/personalized-agent-template.md +1 -1
- package/.sinapse-ai/product/templates/personalized-task-template.md +1 -1
- package/.sinapse-ai/product/templates/personalized-template-file.yaml +1 -1
- package/.sinapse-ai/product/templates/personalized-workflow-template.yaml +3 -3
- package/.sinapse-ai/product/templates/story-tmpl.yaml +8 -8
- package/.sinapse-ai/schemas/README.md +15 -15
- package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +2 -2
- package/.sinapse-ai/user-guide.md +4 -4
- package/.sinapse-ai/working-in-the-brownfield.md +3 -3
- package/LICENSE +4 -4
- package/README.en.md +6 -6
- package/README.md +8 -8
- package/bin/cli.js +13 -11
- package/bin/sinapse.js +17 -0
- package/docs/00-shared-activation-pipeline.md +16 -16
- package/docs/FEATURE_PROCESS.md +1 -1
- package/docs/ORQX-PLAN.md +264 -0
- package/docs/core-architecture.md +2 -2
- package/docs/en/sinapse-agent-flows/README.md +2 -2
- package/docs/en/sinapse-agent-flows/dev-system.md +2 -2
- package/docs/en/sinapse-agent-flows/pm-system.md +2 -2
- package/docs/en/sinapse-agent-flows/qa-system.md +2 -2
- package/docs/en/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +5 -5
- package/docs/en/sinapse-agent-flows/sm-system.md +2 -2
- package/docs/framework/entity-layer-classification.md +2 -2
- package/docs/framework/source-tree.md +17 -17
- package/docs/getting-started.md +13 -13
- package/docs/guides/IDS-CONCEITOS-EXPLICADOS.md +17 -17
- package/docs/guides/MEMORY-INTEGRATION.md +3 -3
- package/docs/guides/MEMORY-INTELLIGENCE-SYSTEM.md +4 -4
- package/docs/guides/ade-guide.md +25 -25
- package/docs/guides/agent-selection-guide.md +36 -36
- package/docs/guides/agents/ANALYST-SYSTEM.md +5 -5
- package/docs/guides/agents/ARCHITECT-SYSTEM.md +9 -9
- package/docs/guides/agents/DATA-ENGINEER-SYSTEM.md +8 -8
- package/docs/guides/agents/DEV-SYSTEM.md +27 -27
- package/docs/guides/agents/DEVOPS-SYSTEM.md +5 -5
- package/docs/guides/agents/PM-SYSTEM.md +24 -24
- package/docs/guides/agents/QA-SYSTEM.md +24 -24
- package/docs/guides/agents/SINAPSE-MASTER-SYSTEM.md +26 -26
- package/docs/guides/agents/SM-SYSTEM.md +31 -31
- package/docs/guides/agents/SQUAD-CREATOR-SYSTEM.md +2 -2
- package/docs/guides/agents/UX-DESIGN-EXPERT-SYSTEM.md +10 -10
- package/docs/guides/agents/traces/00-shared-activation-pipeline.md +16 -16
- package/docs/guides/agents/traces/00-shared-activation-pipeline.v1-act8.md +16 -16
- package/docs/guides/agents/traces/README.md +20 -20
- package/docs/guides/agents/traces/analyst-execution-trace.md +6 -6
- package/docs/guides/agents/traces/architect-execution-trace.md +3 -3
- package/docs/guides/agents/traces/data-engineer-execution-trace.md +4 -4
- package/docs/guides/agents/traces/dev-execution-trace.md +12 -12
- package/docs/guides/agents/traces/devops-execution-trace.md +6 -6
- package/docs/guides/agents/traces/pm-execution-trace.md +14 -14
- package/docs/guides/agents/traces/po-execution-trace.md +17 -17
- package/docs/guides/agents/traces/qa-execution-trace.md +15 -15
- package/docs/guides/agents/traces/{sinapse-master-execution-trace.md → sinapse-orqx-execution-trace.md} +22 -22
- package/docs/guides/agents/traces/sm-execution-trace.md +15 -15
- package/docs/guides/agents/traces/squad-creation-execution-trace.md +9 -9
- package/docs/guides/agents/traces/ux-design-expert-execution-trace.md +4 -4
- package/docs/guides/api-reference.md +27 -27
- package/docs/guides/coderabbit/README.md +9 -9
- package/docs/guides/contextual-greeting-system-guide.md +5 -5
- package/docs/guides/development-setup.md +1 -1
- package/docs/guides/project-status-feature.md +2 -2
- package/docs/guides/quality-dashboard.md +2 -2
- package/docs/guides/quality-gates.md +6 -6
- package/docs/guides/template-engine-v2.md +2 -2
- package/docs/guides/user-guide.md +13 -13
- package/docs/guides/workflows/AUTO-WORKTREE-WORKFLOW.md +3 -3
- package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md +6 -6
- package/docs/guides/workflows/BROWNFIELD-FULLSTACK-WORKFLOW.md +30 -30
- package/docs/guides/workflows/BROWNFIELD-SERVICE-WORKFLOW.md +38 -38
- package/docs/guides/workflows/BROWNFIELD-UI-WORKFLOW.md +25 -25
- package/docs/guides/workflows/GREENFIELD-FULLSTACK-WORKFLOW.md +37 -37
- package/docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md +5 -5
- package/docs/guides/workflows/GREENFIELD-UI-WORKFLOW.md +19 -19
- package/docs/guides/workflows/QA-LOOP-WORKFLOW.md +13 -13
- package/docs/guides/workflows/SINAPSE-COMPLETE-CROSS-REFERENCE-ANALYSIS.md +19 -19
- package/docs/guides/workflows/SPEC-PIPELINE-WORKFLOW.md +25 -25
- package/docs/guides/workflows/STORY-DEVELOPMENT-CYCLE-WORKFLOW.md +28 -28
- package/docs/guides/workflows/WORKFLOW-TASK-AGENT-ANALYSIS.md +94 -94
- package/docs/guides/workflows/xref-phase2-templates.md +29 -29
- package/docs/guides/workflows/xref-phase3-scripts.md +33 -33
- package/docs/guides/workflows/xref-phase4-infra.md +2 -2
- package/docs/guides/workflows/xref-phase6-supporting.md +1 -1
- package/docs/guides/workflows-guide.md +2 -2
- package/docs/installation/faq.md +1 -1
- package/docs/installation/troubleshooting.md +2 -2
- package/docs/installation/v4-quick-start.md +2 -2
- package/docs/prd-cli-graph-dashboard.md +1 -1
- package/docs/pt/DOCUMENTATION-ROADMAP.md +1 -1
- package/docs/pt/FEATURE_PROCESS.md +1 -1
- package/docs/pt/README.md +2 -2
- package/docs/pt/agents/archetype-rationale.md +4 -4
- package/docs/pt/agents/persona-definitions.md +9 -9
- package/docs/pt/architecture/ADE-ARCHITECT-HANDOFF.md +15 -15
- package/docs/pt/architecture/ADE-EPIC1-HANDOFF.md +2 -2
- package/docs/pt/architecture/ADE-EPIC2-HANDOFF.md +2 -2
- package/docs/pt/architecture/ADE-EPIC3-HANDOFF.md +8 -8
- package/docs/pt/architecture/ade-architecture.md +4 -4
- package/docs/pt/architecture/adr/adr-hcs-health-check-system.md +3 -3
- package/docs/pt/architecture/agent-config-audit.md +4 -4
- package/docs/pt/architecture/agent-responsibility-matrix.md +20 -20
- package/docs/pt/architecture/agent-tool-integration-guide.md +8 -8
- package/docs/pt/architecture/contribution-workflow-research.md +1 -1
- package/docs/pt/architecture/dashboard-architecture.md +1 -1
- package/docs/pt/architecture/hcs-check-specifications.md +1 -1
- package/docs/pt/architecture/hcs-execution-modes.md +1 -1
- package/docs/pt/architecture/hcs-self-healing-spec.md +1 -1
- package/docs/pt/architecture/high-level-architecture.md +1 -1
- package/docs/pt/architecture/module-system.md +1 -1
- package/docs/pt/architecture/source-tree.md +1 -1
- package/docs/pt/architecture/squad-improvement-recommended-approach.md +2 -2
- package/docs/pt/architecture/utility-integration-guide.md +2 -2
- package/docs/pt/contributing.md +1 -1
- package/docs/pt/core-architecture.md +2 -2
- package/docs/pt/framework/source-tree.md +1 -1
- package/docs/pt/guides/ade-guide.md +25 -25
- package/docs/pt/guides/agent-selection-guide.md +36 -36
- package/docs/pt/guides/api-reference.md +25 -25
- package/docs/pt/guides/contextual-greeting-system-guide.md +5 -5
- package/docs/pt/guides/development-setup.md +1 -1
- package/docs/pt/guides/project-status-feature.md +2 -2
- package/docs/pt/guides/quality-dashboard.md +2 -2
- package/docs/pt/guides/quality-gates.md +6 -6
- package/docs/pt/guides/template-engine-v2.md +2 -2
- package/docs/pt/guides/user-guide.md +8 -8
- package/docs/pt/guides/workflows-guide.md +2 -2
- package/docs/pt/installation/faq.md +1 -1
- package/docs/pt/installation/troubleshooting.md +2 -2
- package/docs/pt/installation/v4-quick-start.md +2 -2
- package/docs/pt/platforms/antigravity.md +9 -9
- package/docs/pt/platforms/cursor.md +15 -15
- package/docs/pt/platforms/gemini-cli.md +3 -3
- package/docs/pt/roadmap.md +1 -1
- package/docs/pt/sinapse-nomenclature-specification.md +15 -15
- package/docs/pt/specifications/docs-agent-technical-specification.md +11 -11
- package/docs/roadmap.md +1 -1
- package/docs/sinapse-agent-flows/README.md +2 -2
- package/docs/sinapse-agent-flows/analyst-system.md +5 -5
- package/docs/sinapse-agent-flows/architect-system.md +9 -9
- package/docs/sinapse-agent-flows/data-engineer-system.md +8 -8
- package/docs/sinapse-agent-flows/dev-system.md +27 -27
- package/docs/sinapse-agent-flows/devops-system.md +5 -5
- package/docs/sinapse-agent-flows/pm-system.md +24 -24
- package/docs/sinapse-agent-flows/qa-system.md +24 -24
- package/docs/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +26 -26
- package/docs/sinapse-agent-flows/sm-system.md +31 -31
- package/docs/sinapse-agent-flows/squad-creator-system.md +2 -2
- package/docs/sinapse-agent-flows/ux-design-expert-system.md +10 -10
- package/docs/sinapse-workflows/auto-worktree-workflow.md +3 -3
- package/docs/sinapse-workflows/brownfield-discovery-workflow.md +6 -6
- package/docs/sinapse-workflows/brownfield-fullstack-workflow.md +30 -30
- package/docs/sinapse-workflows/brownfield-service-workflow.md +38 -38
- package/docs/sinapse-workflows/brownfield-ui-workflow.md +25 -25
- package/docs/sinapse-workflows/greenfield-fullstack-workflow.md +37 -37
- package/docs/sinapse-workflows/greenfield-service-workflow.md +5 -5
- package/docs/sinapse-workflows/greenfield-ui-workflow.md +19 -19
- package/docs/sinapse-workflows/qa-loop-workflow.md +13 -13
- package/docs/sinapse-workflows/spec-pipeline-workflow.md +25 -25
- package/docs/sinapse-workflows/story-development-cycle-workflow.md +28 -28
- package/package.json +1 -1
- package/packages/gemini-sinapse-extension/README.md +1 -1
- package/packages/gemini-sinapse-extension/commands/lib/agent-launcher.js +1 -1
- package/packages/gemini-sinapse-extension/commands/{sinapse-master.js → sinapse-orqx.js} +1 -1
- package/packages/gemini-sinapse-extension/extension.json +3 -3
- package/packages/gemini-sinapse-extension/gemini-extension.json +3 -3
- package/packages/installer/src/config/configure-environment.js +2 -2
- package/packages/installer/src/updater/index.js +105 -0
- package/packages/installer/src/wizard/feedback.js +38 -30
- package/packages/installer/src/wizard/i18n.js +25 -182
- package/packages/installer/src/wizard/ide-config-generator.js +1 -1
- package/packages/installer/src/wizard/index.js +253 -69
- package/packages/installer/src/wizard/questions.js +35 -7
- package/packages/installer/tests/unit/artifact-copy-pipeline/artifact-copy-pipeline.test.js +1 -1
- package/packages/sinapse-install/README.md +1 -1
- package/packages/sinapse-install/src/installer.js +1 -1
- package/scripts/package-synapse.js +1 -1
- package/sinapse/agents/{sinapse-master.md → sinapse-orqx.md} +18 -18
- package/sinapse/knowledge-base/cross-squad-patterns.md +1 -1
- package/sinapse/knowledge-base/routing-catalog.md +1 -1
- package/sinapse/squad.yaml +1 -1
- package/sinapse/tasks/compose-multi-squad-plan.md +2 -2
- package/sinapse/tasks/coordinate-cross-squad.md +2 -2
- package/sinapse/tasks/diagnose-and-route.md +2 -2
- package/sinapse/tasks/onboard-user.md +2 -2
- package/sinapse/tasks/resolve-conflict.md +2 -2
- package/sinapse/tasks/squad-status-report.md +2 -2
- package/sinapse/tasks/strategic-brief.md +3 -3
- package/squads/squad-animations/agents/animations-orqx.md +2 -2
- package/squads/squad-brand/agents/brand-creative-engineer.md +1 -1
- package/squads/squad-brand/agents/brand-motion-vfx.md +1 -1
- package/squads/squad-brand/agents/brand-orqx.md +2 -2
- package/squads/squad-brand/agents/brand-sonic-designer.md +1 -1
- package/squads/squad-brand/agents/brand-system-architect.md +1 -1
- package/squads/squad-claude/agents/claude-orqx.md +2 -2
- package/squads/squad-cloning/agents/cloning-orqx.md +3 -3
- package/squads/squad-commercial/agents/commercial-orqx.md +1 -1
- package/squads/squad-commercial/agents/cs-business-auditor.md +1 -1
- package/squads/squad-commercial/agents/cs-client-success.md +1 -1
- package/squads/squad-commercial/agents/cs-crm-specialist.md +1 -1
- package/squads/squad-commercial/agents/cs-funnel-architect.md +1 -1
- package/squads/squad-commercial/agents/cs-lead-generation-strategist.md +1 -1
- package/squads/squad-commercial/agents/cs-offer-designer.md +1 -1
- package/squads/squad-commercial/agents/cs-revops-analyst.md +1 -1
- package/squads/squad-commercial/agents/cs-sales-closer.md +1 -1
- package/squads/squad-commercial/agents/cs-sales-enablement.md +1 -1
- package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +1 -1
- package/squads/squad-content/agents/content-orqx.md +2 -2
- package/squads/squad-content/knowledge-base/ai-leverage-content-framework.md +1 -1
- package/squads/squad-copy/agents/copy-strategist.md +3 -3
- package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +1 -1
- package/squads/squad-council/agents/council-orqx.md +1 -1
- package/squads/squad-courses/agents/courses-orqx.md +1 -1
- package/squads/squad-cybersecurity/agents/cyber-orqx.md +2 -2
- package/squads/squad-design/agents/design-orqx.md +2 -2
- package/squads/squad-finance/agents/finance-orqx.md +2 -2
- package/squads/squad-growth/agents/growth-orqx.md +2 -2
- package/squads/squad-paidmedia/agents/paidmedia-orqx.md +2 -2
- package/squads/squad-product/agents/product-orqx.md +2 -2
- package/squads/squad-research/agents/research-orqx.md +2 -2
- package/squads/squad-research/tasks/create-executive-briefing.md +1 -1
- package/squads/squad-research/tasks/create-insight-deck.md +1 -1
- package/squads/squad-research/tasks/forecast-industry-trends.md +1 -1
- package/squads/squad-research/tasks/generate-actionable-recommendations.md +2 -2
- package/squads/squad-research/tasks/run-scenario-planning.md +2 -2
- package/squads/squad-research/tasks/synthesize-research-report.md +2 -2
- package/squads/squad-research/tasks/track-emerging-technologies.md +1 -1
- package/squads/squad-storytelling/agents/storytelling-orqx.md +2 -2
- package/docs/es/CHANGELOG.md +0 -117
- package/docs/es/DOCUMENTATION-ROADMAP.md +0 -216
- package/docs/es/ENVIRONMENT.md +0 -140
- package/docs/es/FEATURE_PROCESS.md +0 -99
- package/docs/es/GUIDING-PRINCIPLES.md +0 -101
- package/docs/es/README.md +0 -134
- package/docs/es/agent-reference-guide.md +0 -570
- package/docs/es/agents/archetype-rationale.md +0 -566
- package/docs/es/agents/persona-definitions.md +0 -501
- package/docs/es/api/squads-api.md +0 -753
- package/docs/es/architecture/ADE-AGENT-CHANGES.md +0 -469
- package/docs/es/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
- package/docs/es/architecture/ADE-EPIC1-HANDOFF.md +0 -85
- package/docs/es/architecture/ADE-EPIC2-HANDOFF.md +0 -106
- package/docs/es/architecture/ADE-EPIC3-HANDOFF.md +0 -327
- package/docs/es/architecture/ARCHITECTURE-INDEX.md +0 -188
- package/docs/es/architecture/ade-architecture.md +0 -586
- package/docs/es/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
- package/docs/es/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
- package/docs/es/architecture/adr/adr-hcs-health-check-system.md +0 -489
- package/docs/es/architecture/adr/adr-isolated-vm-decision.md +0 -70
- package/docs/es/architecture/agent-config-audit.md +0 -222
- package/docs/es/architecture/agent-responsibility-matrix.md +0 -444
- package/docs/es/architecture/agent-tool-integration-guide.md +0 -334
- package/docs/es/architecture/ci-cd.md +0 -151
- package/docs/es/architecture/coding-standards.md +0 -896
- package/docs/es/architecture/contribution-workflow-research.md +0 -376
- package/docs/es/architecture/dashboard-architecture.md +0 -926
- package/docs/es/architecture/dashboard-realtime.md +0 -1253
- package/docs/es/architecture/hcs-check-specifications.md +0 -897
- package/docs/es/architecture/hcs-execution-modes.md +0 -519
- package/docs/es/architecture/hcs-self-healing-spec.md +0 -695
- package/docs/es/architecture/high-level-architecture.md +0 -357
- package/docs/es/architecture/introduction.md +0 -21
- package/docs/es/architecture/mcp-api-keys-management.md +0 -246
- package/docs/es/architecture/mcp-system-diagrams.md +0 -113
- package/docs/es/architecture/module-system.md +0 -382
- package/docs/es/architecture/multi-repo-strategy.md +0 -390
- package/docs/es/architecture/source-tree.md +0 -708
- package/docs/es/architecture/squad-improvement-analysis.md +0 -204
- package/docs/es/architecture/squad-improvement-recommended-approach.md +0 -390
- package/docs/es/architecture/tech-stack.md +0 -806
- package/docs/es/architecture/utility-integration-guide.md +0 -358
- package/docs/es/community/README-community-snippet-core.md +0 -57
- package/docs/es/community/README-community-snippet-mcp.md +0 -49
- package/docs/es/community/README-community-snippet-squads.md +0 -40
- package/docs/es/community.md +0 -227
- package/docs/es/core-architecture.md +0 -229
- package/docs/es/docker-mcp-setup.md +0 -426
- package/docs/es/framework/README.md +0 -99
- package/docs/es/framework/coding-standards.md +0 -892
- package/docs/es/framework/source-tree.md +0 -725
- package/docs/es/framework/tech-stack.md +0 -802
- package/docs/es/getting-started.md +0 -572
- package/docs/es/git-workflow-guide.md +0 -995
- package/docs/es/guides/README.md +0 -133
- package/docs/es/guides/ade-guide.md +0 -452
- package/docs/es/guides/agent-selection-guide.md +0 -295
- package/docs/es/guides/api-reference.md +0 -899
- package/docs/es/guides/build-recovery-guide.md +0 -270
- package/docs/es/guides/contextual-greeting-system-guide.md +0 -387
- package/docs/es/guides/contributing-squads.md +0 -256
- package/docs/es/guides/development-setup.md +0 -1111
- package/docs/es/guides/ide-sync-guide.md +0 -194
- package/docs/es/guides/installation-troubleshooting.md +0 -327
- package/docs/es/guides/llm-routing.md +0 -312
- package/docs/es/guides/mcp/desktop-commander.md +0 -368
- package/docs/es/guides/mcp/docker-gateway-tutorial.md +0 -336
- package/docs/es/guides/mcp-global-setup.md +0 -663
- package/docs/es/guides/permission-modes.md +0 -313
- package/docs/es/guides/project-status-feature.md +0 -473
- package/docs/es/guides/quality-dashboard.md +0 -367
- package/docs/es/guides/quality-gates.md +0 -614
- package/docs/es/guides/security-hardening.md +0 -1359
- package/docs/es/guides/service-discovery.md +0 -524
- package/docs/es/guides/squad-examples/README.md +0 -64
- package/docs/es/guides/squad-migration.md +0 -356
- package/docs/es/guides/squads-guide.md +0 -836
- package/docs/es/guides/squads-overview.md +0 -332
- package/docs/es/guides/template-engine-v2.md +0 -484
- package/docs/es/guides/testing-guide.md +0 -1215
- package/docs/es/guides/user-guide.md +0 -452
- package/docs/es/guides/workflows-guide.md +0 -400
- package/docs/es/how-to-contribute-with-pull-requests.md +0 -160
- package/docs/es/ide-integration.md +0 -425
- package/docs/es/installation/README.md +0 -108
- package/docs/es/installation/faq.md +0 -616
- package/docs/es/installation/linux.md +0 -311
- package/docs/es/installation/macos.md +0 -189
- package/docs/es/installation/troubleshooting.md +0 -735
- package/docs/es/installation/v4-quick-start.md +0 -269
- package/docs/es/installation/windows.md +0 -342
- package/docs/es/meta-agent-commands.md +0 -990
- package/docs/es/migration-guide.md +0 -310
- package/docs/es/npx-install.md +0 -193
- package/docs/es/performance-tuning-guide.md +0 -707
- package/docs/es/platforms/README.md +0 -283
- package/docs/es/platforms/antigravity.md +0 -510
- package/docs/es/platforms/claude-code.md +0 -650
- package/docs/es/platforms/cursor.md +0 -635
- package/docs/es/platforms/gemini-cli.md +0 -483
- package/docs/es/platforms/github-copilot.md +0 -480
- package/docs/es/roadmap.md +0 -119
- package/docs/es/security-best-practices.md +0 -613
- package/docs/es/security.md +0 -124
- package/docs/es/sinapse-agent-flows/README.md +0 -190
- package/docs/es/sinapse-agent-flows/analyst-system.md +0 -36
- package/docs/es/sinapse-agent-flows/architect-system.md +0 -36
- package/docs/es/sinapse-agent-flows/data-engineer-system.md +0 -36
- package/docs/es/sinapse-agent-flows/dev-system.md +0 -36
- package/docs/es/sinapse-agent-flows/devops-system.md +0 -36
- package/docs/es/sinapse-agent-flows/pm-system.md +0 -36
- package/docs/es/sinapse-agent-flows/qa-system.md +0 -36
- package/docs/es/sinapse-agent-flows/sinapse-master-system.md +0 -36
- package/docs/es/sinapse-agent-flows/sm-system.md +0 -36
- package/docs/es/sinapse-agent-flows/squad-creator-system.md +0 -36
- package/docs/es/sinapse-agent-flows/ux-design-expert-system.md +0 -36
- package/docs/es/sinapse-nomenclature-specification.md +0 -673
- package/docs/es/sinapse-workflows/README.md +0 -247
- package/docs/es/sinapse-workflows/auto-worktree-workflow.md +0 -39
- package/docs/es/sinapse-workflows/brownfield-discovery-workflow.md +0 -41
- package/docs/es/sinapse-workflows/brownfield-fullstack-workflow.md +0 -42
- package/docs/es/sinapse-workflows/brownfield-service-workflow.md +0 -43
- package/docs/es/sinapse-workflows/brownfield-ui-workflow.md +0 -42
- package/docs/es/sinapse-workflows/design-system-build-quality-workflow.md +0 -40
- package/docs/es/sinapse-workflows/greenfield-fullstack-workflow.md +0 -44
- package/docs/es/sinapse-workflows/greenfield-service-workflow.md +0 -43
- package/docs/es/sinapse-workflows/greenfield-ui-workflow.md +0 -43
- package/docs/es/sinapse-workflows/qa-loop-workflow.md +0 -39
- package/docs/es/sinapse-workflows/spec-pipeline-workflow.md +0 -40
- package/docs/es/sinapse-workflows/story-development-cycle-workflow.md +0 -42
- package/docs/es/specifications/docs-agent-technical-specification.md +0 -2161
- package/docs/es/troubleshooting.md +0 -887
- package/docs/es/uninstallation.md +0 -556
- package/docs/es/versioning-and-releases.md +0 -146
- package/docs/zh/CHANGELOG.md +0 -191
- package/docs/zh/ENVIRONMENT.md +0 -136
- package/docs/zh/FEATURE_PROCESS.md +0 -92
- package/docs/zh/GLOSSARY.md +0 -179
- package/docs/zh/GUIDING-PRINCIPLES.md +0 -97
- package/docs/zh/README.md +0 -133
- package/docs/zh/TRANSLATION-PLAN.md +0 -508
- package/docs/zh/agent-reference-guide.md +0 -566
- package/docs/zh/agents/archetype-rationale.md +0 -631
- package/docs/zh/agents/persona-definitions.md +0 -560
- package/docs/zh/api/squads-api.md +0 -753
- package/docs/zh/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
- package/docs/zh/architecture/ADE-EPIC1-HANDOFF.md +0 -85
- package/docs/zh/architecture/ADE-EPIC2-HANDOFF.md +0 -106
- package/docs/zh/architecture/ADE-EPIC3-HANDOFF.md +0 -327
- package/docs/zh/architecture/ARCHITECTURE-INDEX.md +0 -190
- package/docs/zh/architecture/SINAPSE-VISUAL-OVERVIEW.md +0 -595
- package/docs/zh/architecture/ade-architecture.md +0 -474
- package/docs/zh/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
- package/docs/zh/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
- package/docs/zh/architecture/adr/adr-hcs-health-check-system.md +0 -489
- package/docs/zh/architecture/adr/adr-isolated-vm-decision.md +0 -70
- package/docs/zh/architecture/agent-config-audit.md +0 -220
- package/docs/zh/architecture/agent-responsibility-matrix.md +0 -444
- package/docs/zh/architecture/agent-tool-integration-guide.md +0 -336
- package/docs/zh/architecture/ci-cd.md +0 -151
- package/docs/zh/architecture/coding-standards.md +0 -898
- package/docs/zh/architecture/command-authority-matrix.md +0 -18
- package/docs/zh/architecture/contribution-workflow-research.md +0 -376
- package/docs/zh/architecture/dashboard-architecture.md +0 -569
- package/docs/zh/architecture/dashboard-realtime.md +0 -415
- package/docs/zh/architecture/hcs-check-specifications.md +0 -102
- package/docs/zh/architecture/hcs-execution-modes.md +0 -114
- package/docs/zh/architecture/hcs-self-healing-spec.md +0 -148
- package/docs/zh/architecture/high-level-architecture.md +0 -355
- package/docs/zh/architecture/introduction.md +0 -21
- package/docs/zh/architecture/mcp-api-keys-management.md +0 -248
- package/docs/zh/architecture/mcp-system-diagrams.md +0 -113
- package/docs/zh/architecture/module-system.md +0 -382
- package/docs/zh/architecture/multi-repo-strategy.md +0 -237
- package/docs/zh/architecture/source-tree.md +0 -710
- package/docs/zh/architecture/squad-improvement-analysis.md +0 -204
- package/docs/zh/architecture/squad-improvement-recommended-approach.md +0 -390
- package/docs/zh/architecture/tech-stack.md +0 -808
- package/docs/zh/architecture/utility-integration-guide.md +0 -358
- package/docs/zh/code-of-conduct.md +0 -113
- package/docs/zh/community/README-community-snippet-core.md +0 -57
- package/docs/zh/community/README-community-snippet-mcp.md +0 -49
- package/docs/zh/community/README-community-snippet-squads.md +0 -40
- package/docs/zh/community.md +0 -227
- package/docs/zh/contributing.md +0 -581
- package/docs/zh/core-architecture.md +0 -229
- package/docs/zh/docker-mcp-setup.md +0 -226
- package/docs/zh/framework/README.md +0 -97
- package/docs/zh/framework/coding-standards.md +0 -886
- package/docs/zh/framework/source-tree.md +0 -888
- package/docs/zh/framework/tech-stack.md +0 -796
- package/docs/zh/getting-started.md +0 -317
- package/docs/zh/git-workflow-guide.md +0 -988
- package/docs/zh/guides/MEMORY-INTEGRATION.md +0 -497
- package/docs/zh/guides/MEMORY-INTELLIGENCE-SYSTEM.md +0 -1083
- package/docs/zh/guides/MEMORY-SYSTEM.md +0 -1003
- package/docs/zh/guides/README.md +0 -127
- package/docs/zh/guides/ade-guide.md +0 -446
- package/docs/zh/guides/agent-selection-guide.md +0 -289
- package/docs/zh/guides/api-reference.md +0 -427
- package/docs/zh/guides/build-recovery-guide.md +0 -266
- package/docs/zh/guides/contextual-greeting-system-guide.md +0 -381
- package/docs/zh/guides/contributing-squads.md +0 -250
- package/docs/zh/guides/development-setup.md +0 -384
- package/docs/zh/guides/ide-sync-guide.md +0 -193
- package/docs/zh/guides/installation-troubleshooting.md +0 -321
- package/docs/zh/guides/llm-routing.md +0 -306
- package/docs/zh/guides/mcp/desktop-commander.md +0 -368
- package/docs/zh/guides/mcp/docker-gateway-tutorial.md +0 -336
- package/docs/zh/guides/mcp-global-setup.md +0 -696
- package/docs/zh/guides/permission-modes.md +0 -307
- package/docs/zh/guides/project-status-feature.md +0 -467
- package/docs/zh/guides/quality-dashboard.md +0 -361
- package/docs/zh/guides/quality-gates.md +0 -462
- package/docs/zh/guides/security-hardening.md +0 -1055
- package/docs/zh/guides/service-discovery.md +0 -518
- package/docs/zh/guides/squad-examples/README.md +0 -63
- package/docs/zh/guides/squad-migration.md +0 -336
- package/docs/zh/guides/template-engine-v2.md +0 -478
- package/docs/zh/guides/workflows-guide.md +0 -408
- package/docs/zh/how-to-contribute-with-pull-requests.md +0 -158
- package/docs/zh/installation/README.md +0 -106
- package/docs/zh/installation/faq.md +0 -611
- package/docs/zh/installation/linux.md +0 -447
- package/docs/zh/installation/macos.md +0 -187
- package/docs/zh/installation/troubleshooting.md +0 -729
- package/docs/zh/installation/windows.md +0 -475
- package/docs/zh/meta-agent-commands.md +0 -990
- package/docs/zh/security-best-practices.md +0 -610
- package/docs/zh/security.md +0 -124
- package/docs/zh/sinapse-agent-flows/README.md +0 -196
- package/docs/zh/sinapse-agent-flows/analyst-system.md +0 -679
- package/docs/zh/sinapse-agent-flows/architect-system.md +0 -246
- package/docs/zh/sinapse-agent-flows/data-engineer-system.md +0 -418
- package/docs/zh/sinapse-agent-flows/dev-system.md +0 -209
- package/docs/zh/sinapse-agent-flows/devops-system.md +0 -643
- package/docs/zh/sinapse-agent-flows/pm-system.md +0 -733
- package/docs/zh/sinapse-agent-flows/qa-system.md +0 -268
- package/docs/zh/sinapse-agent-flows/sinapse-master-system.md +0 -81
- package/docs/zh/sinapse-agent-flows/sm-system.md +0 -501
- package/docs/zh/sinapse-agent-flows/squad-creator-system.md +0 -704
- package/docs/zh/sinapse-agent-flows/ux-design-expert-system.md +0 -160
- package/docs/zh/sinapse-workflows/README.md +0 -247
- package/docs/zh/sinapse-workflows/auto-worktree-workflow.md +0 -793
- package/docs/zh/sinapse-workflows/brownfield-discovery-workflow.md +0 -915
- package/docs/zh/sinapse-workflows/brownfield-fullstack-workflow.md +0 -764
- package/docs/zh/sinapse-workflows/brownfield-service-workflow.md +0 -812
- package/docs/zh/sinapse-workflows/brownfield-ui-workflow.md +0 -891
- package/docs/zh/sinapse-workflows/design-system-build-quality-workflow.md +0 -845
- package/docs/zh/sinapse-workflows/greenfield-fullstack-workflow.md +0 -796
- package/docs/zh/sinapse-workflows/greenfield-service-workflow.md +0 -786
- package/docs/zh/sinapse-workflows/greenfield-ui-workflow.md +0 -922
- package/docs/zh/sinapse-workflows/qa-loop-workflow.md +0 -1111
- package/docs/zh/sinapse-workflows/spec-pipeline-workflow.md +0 -1031
- package/docs/zh/sinapse-workflows/story-development-cycle-workflow.md +0 -843
- package/docs/zh/troubleshooting.md +0 -883
- package/docs/zh/uninstallation.md +0 -348
- package/docs/zh/versioning-and-releases.md +0 -140
- /package/.sinapse-ai/development/agents/{dev → developer}/MEMORY.md +0 -0
- /package/.sinapse-ai/development/agents/{qa → quality-gate}/MEMORY.md +0 -0
- /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
|