Rapid OS
Rapid OS v3 es un Contract-Driven Engineering OS para equipos que desarrollan software con coding harnesses y asistentes de IA.
Su objetivo no es reemplazar al agente que escribe código. Su objetivo es convertir el trabajo asistido por IA en un proceso explícito, trazable, reproducible y verificable: entender el repositorio, definir qué se debe construir, compilar el contexto correcto, establecer reglas de ejecución, declarar capacidades, registrar evidencia y evaluar el resultado.
Qué problema resuelve
Los coding agents pueden trabajar rápido, pero tienden a sufrir tres problemas recurrentes:
- Pérdida de contexto: no siempre conocen las reglas de negocio, arquitectura, seguridad o decisiones previas.
- Instrucciones ambiguas: un prompt no equivale a una especificación versionada y verificable.
- Falta de evidencia: que un agente diga “terminado” no demuestra que se ejecutaron pruebas, revisiones o controles.
Rapid OS introduce contratos y registros deterministas alrededor de ese flujo.
Qué existe
rapid scan crea inteligencia del proyecto con evidencia y procedencia.
Qué se debe construir
rapid spec administra especificaciones y revisiones inmutables.
Qué necesita saber el agente
rapid context compila contexto relevante, priorizado y limitado por presupuesto.
Bajo qué reglas puede trabajar
rapid policy y rapid run fijan riesgo, workspace, gates y tareas.
Qué puede hacer el harness
rapid harness resuelve capabilities declaradas contra el contrato del run.
Qué ocurrió realmente
rapid evidence y rapid eval registran prueba verificable y producen un veredicto determinista.
Empieza en 3 pasos
No necesitas aprender comandos: trabajas con shortcuts (/rapid-…) dentro de tu agente de código, y en tu terminal solo instalas y apruebas.
1. Instala Rapid OS (Instalación). Al final, el instalador pregunta para qué agentes instalar los shortcuts: escribe el tuyo (por ejemplo claude). Si te lo saltaste, una sola vez:
rapid shortcuts install --global --harness claude
2. Describe tu proyecto en el agente. Te propone el stack, el comando de tests y los documentos; tú decides:
/rapid-init una API en Python para validar nombres de usuario
3. Pide el trabajo:
/rapid-feature añadir exportación CSV al informe mensual
Cuando termina, el agente se detiene y te da el comando para aprobar en tu terminal (por ejemplo rapid approve gate.final-verification). Después escribe /rapid-next para cerrar.
| Quieres… | Escribe en tu agente |
|---|---|
| Configurar el proyecto | /rapid-init <descripción> |
| Una funcionalidad nueva | /rapid-feature <objetivo> |
| Corregir un bug | /rapid-bugfix <qué falla> |
| Refactorizar sin romper tests | /rapid-refactor <alcance> |
| Endurecer seguridad | /rapid-hardening <área> |
| Investigar una opción | /rapid-research <pregunta> |
| Ver en qué va o seguir | /rapid-status · /rapid-next |
En Codex se escriben con $ ($rapid-init). En VS Code, y si prefieres versionar los shortcuts con el repositorio, instálalos en el proyecto con rapid init --shortcuts. Detalle por agente en la guía de shortcuts.
Modo avanzado: el ciclo de gobernanza v3
Los comandos v3 (rapid scan, rapid spec, rapid run, rapid evidence, rapid eval…) siguen disponibles para CI, depuración y auditoría. El ciclo de gobernanza v3 sigue ocho pasos:
1. scan
2. spec
3. context
4. policy / run
5. harness
6. ejecución externa + actualización del run
7. evidence
8. eval + validate
Rapid OS no ejecuta de forma autónoma un LLM, no aprueba gates humanos, solo crea un worktree con rapid start --worktree, ejecuta únicamente el test_command configurado o el argv de rapid check (el plumbing no ejecuta nada) y no usa un LLM como juez. El coding harness externo realiza el trabajo; Rapid OS gobierna y verifica los artefactos alrededor de ese trabajo.
Empieza por aquí
- Qué es Rapid OS y para quién sirve
- Por qué Rapid OS y problemas que resuelve
- Requisitos e instalación
- Shortcuts por harness (
/rapid-<modo>) - Tu primer proyecto (Quickstart)
- Un proyecto que ya existe
- Cuando el agente se detiene
- Modos de ingeniería
- Cookbooks de Gobernanza y Evidencia
- Catálogo de Diagnósticos RAPIDxxx
- Integración en CI/CD
- Ciclo de gobernanza v3
- Capabilities y permisos
- Estructura de archivos
- Referencia completa de CLI
- Arquitectura técnica v3
- Arquitectura de orquestación (porcelain sobre plumbing)