Saltar al contenido principal

Un proyecto que ya existe

Adoptar Rapid OS en un repositorio que ya se encuentra en producción o desarrollo activo es un proceso seguro y no invasivo. Rapid OS está diseñado para analizar y gobernar sin modificar tu código de negocio.

Con shortcuts​

  1. Abre tu agente en la raíz del repositorio y escribe:

    /rapid-init

    El agente lee lo que detecta en tu repositorio (lenguaje, framework, carpeta de tests) y te lo propone como punto de partida: stack, comando de tests y documentos. Tú confirmas o cambias. Si la carpeta aún no es un repositorio git, lo crea en la rama main, sin commits.

  2. Pide el trabajo:

    /rapid-bugfix el descuento del 10% devuelve un total negativo

  3. Aprueba en tu terminal cuando el agente te lo pida (te da el comando exacto, por ejemplo rapid approve gate.final-verification) y escribe /rapid-next para cerrar. Más opciones en Cuando el agente se detiene.

Rapid OS no toca tu código de negocio: escribe su configuración en .rapid-os/, los documentos en docs/ y las instrucciones de tu agente (CLAUDE.md, AGENTS.md…); si añade algo más (por ejemplo un workflow de seguridad), te lo dice al cerrar el onboarding. El primer paso de cada run es un baseline de tus tests: si tu suite ya está en rojo, el run no avanza hasta que la arregles (o abandones el run con rapid abort).

¿Aún no tienes los shortcuts? Una sola vez: rapid shortcuts install --global --harness claude (cambia claude por tu agente), o dentro del repositorio rapid init --shortcuts. Detalle en la guía de shortcuts.

Modo avanzado​

No lo necesitas para usar Rapid OS. Es la ruta con comandos v3 (rapid doctor, rapid scan…): útil para ver qué descubre Rapid OS en tu repositorio, para CI y para auditoría.

Ver los pasos con comandos v3

1. Localizar la raíz del repositorio​

El CLI de Rapid OS opera siempre sobre el directorio de trabajo actual (current working directory). Posiciónate en la raíz del repositorio (donde reside el archivo .git o los archivos principales de configuración del proyecto):

cd /ruta/a/tu-proyecto-existente

2. Diagnóstico previo con rapid doctor​

Ejecuta un chequeo inicial para comprobar el estado del entorno en ese directorio:

rapid doctor

Si el proyecto aún no tiene Rapid OS, reportará que .rapid-os/config.json no existe. Esto es esperado.

3. Escaneo en modo solo lectura (rapid scan)​

Antes de crear cualquier archivo, ejecuta el escáner del proyecto:

rapid scan

O para ver la evidencia detallada de cada hecho detectado:

rapid scan --verbose

¿Qué analiza el escáner?​

Rapid OS busca marcadores estándar del ecosistema de software:

  • Lenguajes y empaquetadores: pyproject.toml, package.json, Cargo.toml, go.mod, pom.xml, etc.
  • Frameworks: Django, FastAPI, Flask, React, Next.js, Vue, Spring, etc.
  • Testing: pytest, unittest, jest, vitest, mocha, etc.
  • Contenedores y orquestación: Dockerfile, docker-compose.yml.
  • Estructura: Detección de monorepos (pnpm-workspace.yaml, lerna.json, carpetas de apps).

¿Qué NO lee el escáner (Seguridad de secretos)?​

  • No analiza archivos de secretos: Ignora automáticamente .env, archivos con claves privadas (.pem, .key), tokens y directorios ignorados como .git, node_modules, venv, __pycache__ o .docusaurus.
  • No modifica código fuente: rapid scan es 100% de solo lectura.

4. Persistir la inteligencia del proyecto​

Una vez que revises los hechos descubiertos, persiste la instantánea de inteligencia:

rapid scan --write

Esto crea exclusivamente .rapid-os/project.json, permitiendo que las etapas posteriores reutilicen la información sin volver a recorrer el árbol de archivos.

5. Inicializar gobernanza con rapid init​

Para establecer los estándares del proyecto y los archivos de contexto para coding agents, ejecuta:

rapid init

Documentación del proyecto y reglas de negocio previas​

rapid init también pregunta por los cuatro documentos del proyecto (docs/PRODUCT_BRIEF.md, docs/BUSINESS_RULES.md, docs/DATA_MODEL.md, docs/ARCHITECTURE.md); si ya los resolviste en una ejecución anterior, los conserva. Si tu proyecto venía de una versión anterior con .rapid-os/standards/business.md, rapid setup next lo ofrece como legacy_source y rapid setup doc business --from-legacy lo importa como documento aportado por una persona, sin borrar el original. Para un proyecto que ya existe, rapid setup finish solo escribe los estándares que cambiaron: no pisa los que ya expresan tu decisión.

Protección de archivos existentes con .bak​

Si tu proyecto ya cuenta con archivos como .cursorrules, CLAUDE.md, INSTRUCTIONS.md o .rapid-os/config.json:

  • Rapid OS no los elimina sin aviso.
  • Crea automáticamente un respaldo con extensión .bak (por ejemplo, .cursorrules.bak) antes de actualizar el contenido.
  • Puedes inspeccionar la diferencia o fusionar tus reglas previas dentro de los nuevos archivos de estándares en .rapid-os/standards/.

6. Validación de integridad (rapid validate)​

Verifica que la configuración y los estándares del proyecto sean coherentes:

rapid validate

Para activar una verificación estricta donde cualquier advertencia produzca un código de salida distinto de cero:

rapid validate --strict

Cómo interpretar advertencias comunes​

  • STD001–STD004: Falta algún archivo estándar recomendado en .rapid-os/standards/ (ej. tech-stack.md o topology.md).
  • CONFIG001–CONFIG004: Inconsistencias menores en la configuración del proyecto.
  • RAPID600–RAPID604: Discrepancias en la instantánea de Project Intelligence.

Una vez que rapid validate retorne código 0, tu repositorio cuenta con una línea base de gobernanza verificada y está listo para recibir especificaciones y compilaciones de contexto.