Integración con Coding Harnesses
Guías completas de integración técnica y operativa entre RAPID OS v3 y los principales entornos y asistentes de programación asistida por IA.
1. Principio Fundamental: Declaración vs Capacidad Real
En RAPID OS, un perfil de harness (HarnessProfile) modela de forma declarativa y conservadora las capacidades estándar asociadas a una herramienta.
Regla de oro de Product Truth:
Un perfil incorporado (builtin:cursor,builtin:codex, etc.) no otorga permisos mágicos a un modelo ni garantiza que el entorno local pueda realizar una operación. El coding harness solo puede realizar aquellas acciones para las que el desarrollador le haya otorgado permisos en su terminal, sandbox o configuración local.
2. Matriz Canónica de Capabilities
RAPID OS evalúa exclusivamente los 11 identificadores canónicos de capacidades:
| ID Canónico | Descripción de la Capacidad | Estado Típico Built-in |
|---|---|---|
context.consume | Capacidad del harness para leer y consumir el Context Bundle | supported |
repository.read | Lectura de archivos y directorios del repositorio | supported |
workspace.current | Operación dentro del espacio de trabajo activo | supported |
repository.write | Modificación de archivos en disco | unknown (requiere permisos locales) |
shell.execute | Ejecución de comandos en la terminal / shell | unknown (sujeto a sandbox y aprobación) |
tests.execute | Ejecución de suites de prueba automáticas | unknown (depende del test runner local) |
git.inspect | Inspección de ramas, diffs y estados de git | unknown |
git.modify | Creación de commits, ramas o modificaciones en git | unknown |
workspace.isolated | Operación en ramas aisladas o git worktrees | unknown |
mcp.invoke | Invocación de herramientas mediante el protocolo MCP | unknown |
subagents.delegate | Delegación de tareas a subagentes secundarios | unknown |
3. Flujo principal: shortcuts
El flujo principal con cualquiera de estos harnesses son los shortcuts /rapid-<modo> ($rapid-<modo> en Codex): rapid init --shortcuts o rapid shortcuts install --harness <id> los genera para tu herramienta y el agente conduce el run (rapid next → rapid start → rapid check → rapid finish) hasta que hace falta una persona. Los comandos v3 (rapid spec, rapid run, rapid evidence, rapid eval…) quedan como Modo avanzado para CI, depuración y auditoría. Consulta la guía de shortcuts para la tabla de carpetas e invocación por harness.
4. Catálogo de Guías por Harness
Cada guía abre con el flujo principal (shortcuts) y conserva el modo avanzado. Selecciona la correspondiente a tu herramienta:
- OpenAI Codex / CLI Integration: Flujos de ejecución headless y scripts gobernados.
- Anthropic Claude Code: Integración con la CLI interactiva y permisos de terminal.
- Cursor IDE: Integración mediante Composer, reglas de proyecto
.cursorrulesy context injection. - Visual Studio Code: Integración con GitHub Copilot Chat, extensiones y terminales integradas.
- Google Antigravity: Orquestación multi-agente, subagentes autónomos y sandboxing avanzado.