sinapse-ai 5.0.8 → 6.0.1

package/docs/es/ide-integration.md

@@ -1,425 +0,0 @@
-# Guía de Integración con IDEs
-
-> **ES**
-
----
-
-Guía para integrar SINAPSE con IDEs compatibles y plataformas de desarrollo con IA.
-
-**Versión:** 2.1.0
-**Última Actualización:** 2026-01-28
-
----
-
-## IDEs Compatibles
-
-SINAPSE es compatible con 6 plataformas de desarrollo potenciadas por IA. Elige la que mejor se adapte a tu flujo de trabajo.
-
-### Tabla de Comparación Rápida
-
-| Característica         | Claude Code | Codex CLI | Cursor | Copilot | AntiGravity | Gemini CLI |
-| ---------------------- | :---------: | :-------: | :----: | :-----: | :---------: | :--------: |
-| **Activación de agentes** | /command  |  /skills  | @mention | chat modes | workflow-based | prompt mention |
-| **Soporte MCP**        |   Native    |  Native   | Config | Config | Provider-specific | Native |
-| **Tareas de subagentes** |   Yes     |    Yes    |   No   |   No   |     Yes     |     No     |
-| **Auto-sync**          |     Yes     |    Yes    |  Yes   |  Yes   |     Yes     |    Yes     |
-| **Sistema de hooks**   |     Yes     |  Limited  |   No   |   No   |      No     |     Yes    |
-| **Skills/Commands**    |   Native    |  Native   |   No   |   No   |      No     |   Native   |
-| **Recomendación**      |    Best     |   Best    |  Best  |  Good  |     Good    |   Good     |
-
-### Paridad de Hooks e Impacto Funcional
-
-| IDE | Paridad de Hooks vs Claude | Qué se degrada sin hooks completos | Mitigación en SINAPSE |
-| --- | --- | --- | --- |
-| Claude Code | Completa | Ninguno (comportamiento de referencia) | Hooks nativos + pipeline completo de SINAPSE |
-| Gemini CLI | Alta | Diferencias menores en el modelo de eventos | Hooks nativos de Gemini + mapeo unificado |
-| Codex CLI | Limitada/parcial | Menor automatización del ciclo de sesión y menor enforcement pre/post-tool | `AGENTS.md` + `/skills` + MCP + scripts de sync/validación |
-| Cursor | Sin hooks de ciclo equivalentes | Sin interceptación nativa pre/post-tool y trazabilidad automática más débil | Reglas sincronizadas + MCP + disciplina de workflow |
-| GitHub Copilot | Sin hooks de ciclo equivalentes | Mismo impacto que Cursor, con mayor dependencia de flujo manual | Instrucciones de repositorio, chat modes y MCP en VS Code |
-| AntiGravity | Basado en workflow (no en hooks) | Sin paridad de ciclo de vida estilo Claude | Generación de workflows + sync de agentes |
-
-### Consecuencias Prácticas por Capacidad
-
-- Automatización `SessionStart/SessionEnd`:
-  - Fuerte en Claude/Gemini.
-  - Parcial o manual en Codex/Cursor/Copilot/AntiGravity.
-- Guardrails `BeforeTool/AfterTool`:
-  - Más robustos en Claude/Gemini.
-  - Limitados en Codex.
-  - Principalmente de proceso en Cursor/Copilot/AntiGravity.
-- Riqueza de auditoría y telemetría automáticas:
-  - Mayor donde existen hooks de ciclo de vida.
-  - Menor donde la integración depende de reglas/instrucciones.
-
----
-
-## Instrucciones de Configuración
-
-### Claude Code
-
-**Nivel de Recomendación:** Mejor integración con SINAPSE
-
-```yaml
-config_file: .claude/CLAUDE.md
-agent_folder: .claude/commands/SINAPSE/agents
-activation: /agent-name (slash commands)
-format: full-markdown-yaml
-mcp_support: native
-special_features:
-  - Task tool for subagents
-  - Native MCP integration
-  - Hooks system (pre/post)
-  - Custom skills
-  - Memory persistence
-```
-
-**Configuración:**
-
-1. SINAPSE crea automáticamente el directorio `.claude/` al inicializar
-2. Los agentes están disponibles como comandos slash: `/dev`, `/qa`, `/architect`
-3. Configura servidores MCP en `~/.claude.json`
-
-**Configuración:**
-
-```bash
-# Sincronizar todos los objetivos habilitados (incluye Claude)
-npm run sync:ide
-
-# Verificar configuración
-ls -la .claude/commands/SINAPSE/agents/
-```
-
----
-
-### Codex CLI
-
-**Nivel de recomendación:** Mejor (workflow terminal-first)
-
-```yaml
-config_file: AGENTS.md
-agent_folder: .codex/agents
-activation: /skills + atajos AGENTS.md
-skills_folder: .codex/skills (local), ~/.codex/skills (global)
-format: markdown
-mcp_support: nativo vía Codex
-special_features:
-  - AGENTS.md como contrato operativo
-  - Skills locales versionadas en el proyecto
-  - Pipeline de greeting compartido con Claude
-  - Comando notify y hooks de herramienta emergentes en releases recientes de Codex
-```
-
-**Configuración:**
-
-1. Mantén `AGENTS.md` en la raíz del repositorio
-2. Ejecuta `npm run sync:ide:codex`
-3. Ejecuta `npm run sync:skills:codex`
-4. Usa `/skills` y selecciona `sinapse-<agent-id>`
-5. Usa `sync:skills:codex:global` solo cuando quieras instalación global
-
-```bash
-npm run sync:ide:codex
-npm run sync:skills:codex
-ls -la AGENTS.md .codex/agents/ .codex/skills/
-```
-
----
-
-### Cursor
-
-**Nivel de Recomendación:** Mejor (IDE IA popular)
-
-```yaml
-config_file: .cursor/rules.md
-agent_folder: .cursor/rules
-activation: @agent-name
-format: condensed-rules
-mcp_support: via configuration
-special_features:
-  - Composer integration
-  - Chat modes
-  - @codebase context
-  - Multi-file editing
-  - Soporte de subagents y handoff a cloud agents
-  - Flujos de agente de larga duracion (preview)
-```
-
-**Configuración:**
-
-1. SINAPSE crea el directorio `.cursor/` al inicializar
-2. Los agentes se activan con @mention: `@dev`, `@qa`
-3. Las reglas se sincronizan a `.cursor/rules/`
-
-**Configuración:**
-
-```bash
-# Sincronizar Cursor
-npm run sync:ide:cursor
-
-# Verificar configuración
-ls -la .cursor/rules/
-```
-
-**Configuración MCP (`.cursor/mcp.json`):**
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "url": "https://mcp.context7.com/sse"
-    }
-  }
-}
-```
-
----
-
-### GitHub Copilot
-
-**Nivel de Recomendación:** Bueno (integración con GitHub)
-
-```yaml
-config_file: .github/copilot-instructions.md
-agent_folder: .github/agents
-activation: chat modes
-format: text
-mcp_support: via VS Code MCP config
-special_features:
-  - GitHub integration
-  - PR assistance
-  - Code review
-  - Integracion con instrucciones de repositorio y MCP en VS Code
-```
-
-**Configuración:**
-
-1. Habilita GitHub Copilot en tu repositorio
-2. SINAPSE crea `.github/copilot-instructions.md`
-3. Las instrucciones del agente se sincronizan
-
-**Configuración:**
-
-```bash
-# Sincronizar todos los objetivos habilitados
-npm run sync:ide
-
-# Verificar configuración
-cat .github/copilot-instructions.md
-```
-
----
-
-### AntiGravity
-
-**Nivel de Recomendación:** Bueno (integración con Google)
-
-```yaml
-config_file: .antigravity/rules.md
-config_json: .antigravity/antigravity.json
-agent_folder: .agent/workflows
-activation: workflow-based
-format: cursor-style
-mcp_support: native (Google)
-special_features:
-  - Google Cloud integration
-  - Workflow system
-  - Native Firebase tools
-```
-
-**Configuración:**
-
-1. SINAPSE crea el directorio `.antigravity/`
-2. Configura las credenciales de Google Cloud
-3. Los agentes se sincronizan como workflows
-
----
-
-### Gemini CLI
-
-**Nivel de Recomendación:** Bueno
-
-```yaml
-config_file: .gemini/rules.md
-agent_folder: .gemini/rules/SINAPSE/agents
-activation: prompt mention
-format: text
-mcp_support: native
-special_features:
-  - Google AI models
-  - CLI-based workflow
-  - Multimodal support
-  - Eventos de hooks nativos y comandos de hooks
-  - Soporte nativo para servidores MCP
-  - UX de comandos/herramientas en evolucion rapida
-```
-
----
-
-## Sistema de Sincronización
-
-### Cómo Funciona la Sincronización
-
-SINAPSE mantiene una única fuente de verdad para las definiciones de agentes y las sincroniza con todos los IDEs configurados:
-
-```
-┌─────────────────────────────────────────────────────┐
-│                    SINAPSE Core                         │
-│  .sinapse-ai/development/agents/  (Fuente de Verdad) │
-│                        │                             │
-│            ┌───────────┼───────────┐                │
-│            ▼           ▼           ▼                │
-│  .claude/     .codex/      .cursor/                  │
-│  .antigravity/ .gemini/                              │
-└─────────────────────────────────────────────────────┘
-```
-
-### Comandos de Sincronización
-
-```bash
-# Sincronizar todos los objetivos habilitados
-npm run sync:ide
-
-# Sincronizar objetivos específicos
-npm run sync:ide:cursor
-npm run sync:ide:codex
-npm run sync:ide:gemini
-npm run sync:ide:github-copilot
-npm run sync:ide:antigravity
-
-# Ejecución en seco (previsualizar cambios)
-npm run sync:ide -- --dry-run
-
-# Sincronización estándar
-npm run sync:ide
-```
-
-### Sincronización Automática
-
-SINAPSE puede configurarse para sincronizar automáticamente cuando hay cambios en los agentes:
-
-```yaml
-# .sinapse-ai/core/config/sync.yaml
-auto_sync:
-  enabled: true
-  watch_paths:
-    - .sinapse-ai/development/agents/
-  platforms:
-    - claude
-    - codex
-    - cursor
-    - gemini
-```
-
----
-
-## Solución de Problemas
-
-### El Agente No Aparece en el IDE
-
-```bash
-# Verificar que el agente existe en la fuente
-ls .sinapse-ai/development/agents/
-
-# Sincronizar y validar
-npm run sync:ide
-npm run sync:ide:check
-
-# Revisar directorio específico de la plataforma
-ls .cursor/rules/  # Para Cursor
-ls .claude/commands/SINAPSE/agents/  # Para Claude Code
-```
-
-### Conflictos de Sincronización
-
-```bash
-# Previsualizar qué cambiaría
-npm run sync:ide -- --dry-run
-
-# Hacer respaldo antes de sincronización
-cp -r .cursor/rules/ .cursor/rules.backup/
-npm run sync:ide
-```
-
-### MCP No Funciona
-
-```bash
-# Revisar estado de MCP
-sinapse mcp status
-
-# Verificar configuración de MCP para el IDE
-cat ~/.claude.json  # Para Claude Code
-cat .cursor/mcp.json  # Para Cursor
-```
-
-### Problemas Específicos del IDE
-
-**Claude Code:**
-
-- Asegúrate de que `.claude/` esté en la raíz del proyecto
-- Revisa permisos de hooks: `chmod +x .claude/hooks/*.py`
-
-**Cursor:**
-
-- Reinicia Cursor después de la sincronización
-- Revisa permisos de `.cursor/rules/`
-
-## Guía de Decisión de Plataforma
-
-Usa esta guía para elegir la plataforma correcta:
-
-```
-¿Usas la API de Claude/Anthropic?
-├── Sí --> Claude Code (Mejor integración con SINAPSE)
-└── No
-    └── ¿Prefieres VS Code?
-        ├── Sí --> ¿Quieres una extensión?
-        │   ├── Sí --> GitHub Copilot (Funciones nativas de GitHub)
-        │   └── No --> GitHub Copilot (Características nativas de GitHub)
-        └── No --> ¿Quieres un IDE IA dedicado?
-            ├── Sí --> ¿Qué modelo prefieres?
-            │   ├── Claude/GPT --> Cursor (IDE IA más popular)
-            └── No --> ¿Usas Google Cloud?
-                ├── Sí --> AntiGravity (integración con Google)
-                └── No --> Gemini CLI (Especializados)
-```
-
----
-
-## Migración Entre IDEs
-
-### De Cursor a Claude Code
-
-```bash
-# Exportar reglas actuales
-cp -r .cursor/rules/ ./rules-backup/
-
-# Inicializar Claude Code
-npm run sync:ide
-
-# Verificar migración
-diff -r ./rules-backup/ .claude/commands/SINAPSE/agents/
-```
-
-### De Claude Code a Cursor
-
-```bash
-# Sincronizar a Cursor
-npm run sync:ide:cursor
-
-# Configurar MCP (si es necesario)
-# Copiar configuración de MCP a .cursor/mcp.json
-```
-
----
-
-## Documentación Relacionada
-
-- [Guías de Plataformas](./platforms/README.md)
-- [Guía de Claude Code](./platforms/claude-code.md)
-- [Guía de Cursor](./platforms/cursor.md)
-- [Guía de Referencia de Agentes](./agent-reference-guide.md)
-- [Configuración Global de MCP](./guides/mcp-global-setup.md)
-
----
-
-_Guía de Integración con IDEs de SINAPSE v4.0_

package/docs/es/installation/README.md

@@ -1,108 +0,0 @@
-<!--
-  Traducción: ES
-  Original: /docs/installation/README.md
-  Última sincronización: 2026-02-01
--->
-
-# Documentación de Instalación de SINAPSE
-
-> 🌐 [EN](../../installation/README.md) | [PT](../../pt/installation/README.md) | **ES**
-
----
-
-**Versión:** 2.1.1
-**Última Actualización:** 2026-02-01
-
----
-
-## Descripción General
-
-Este directorio contiene documentación completa de instalación y configuración para SINAPSE.
-
----
-
-## Índice de Documentación
-
-### Guías por Plataforma
-
-| Plataforma     | Guía                                        | Estado      |
-| -------------- | ------------------------------------------- | ----------- |
-| 🍎 **macOS**   | [Guía de Instalación macOS](./macos.md)     | ✅ Completa |
-| 🐧 **Linux**   | [Guía de Instalación Linux](./linux.md)     | ✅ Completa |
-| 🪟 **Windows** | [Guía de Instalación Windows](./windows.md) | ✅ Completa |
-
-### Documentación General
-
-| Documento                                     | Descripción                               | Audiencia          |
-| --------------------------------------------- | ----------------------------------------- | ------------------ |
-| [Quick Start (v4)](./v4-quick-start.md)   | Configuración rápida para nuevos usuarios | Principiantes      |
-| [Solución de Problemas](./troubleshooting.md) | Problemas comunes y soluciones            | Todos los usuarios |
-| [Preguntas Frecuentes](./faq.md)              | Preguntas frecuentes                      | Todos los usuarios |
-
----
-
-## Enlaces Rápidos
-
-### Nueva Instalación
-
-```bash
-npx sinapse-ai install
-```
-
-### Actualización
-
-```bash
-npx sinapse-ai install --force-upgrade
-```
-
-### ¿Tiene Problemas?
-
-1. Consulte la [Guía de Solución de Problemas](./troubleshooting.md)
-2. Busque en las [Preguntas Frecuentes](./faq.md)
-3. Abra un [Issue en GitHub](https://github.com/SinapseAI/sinapse-ai/issues)
-
----
-
-## Requisitos Previos
-
-- Node.js 18.0.0+
-- npm 9.0.0+
-- Git 2.30+
-
----
-
-## Plataformas Soportadas
-
-| Plataforma    | Estado           |
-| ------------- | ---------------- |
-| Windows 10/11 | Soporte Completo |
-| macOS 12+     | Soporte Completo |
-| Ubuntu 20.04+ | Soporte Completo |
-| Debian 11+    | Soporte Completo |
-
----
-
-## IDEs Soportados
-
-| IDE            | Activación de Agentes |
-| -------------- | --------------------- |
-| Claude Code    | `/dev`, `/qa`, etc.   |
-| Cursor         | `@dev`, `@qa`, etc.   |
-| Gemini CLI     | Mención en el prompt  |
-| GitHub Copilot | Modos de chat         |
-
----
-
-## Documentación Relacionada
-
-- [Estándares de Código](../framework/coding-standards.md)
-- [Stack Tecnológico](../framework/tech-stack.md)
-- [Arquitectura](../architecture/)
-- [Registro de Cambios](../CHANGELOG.md)
-
----
-
-## Soporte
-
-- **Issues de GitHub**: [sinapse-ai/issues](https://github.com/SinapseAI/sinapse-ai/issues)
-- **Documentación**: [docs/](../)