Saltar al contenido principal

Tu primer proyecto

De una carpeta vacía a tu primera funcionalidad terminada y aprobada. Escribes tres cosas en tu agente y una en tu terminal.

  • Necesitas: Rapid OS instalado (rapid --version responde) y un agente de código (Claude Code, Codex, Cursor, Antigravity o VS Code).
  • Tiempo: unos 15 minutos.

Camino principal: /rapid-init​

1. Ten los shortcuts disponibles​

Si al instalar Rapid OS respondiste con tu agente a la pregunta de los shortcuts, ya están. Si no, una sola vez:

rapid shortcuts install --global --harness claude

Cambia claude por codex, cursor o antigravity. En VS Code (o si prefieres los shortcuts dentro del repositorio) usa rapid init --shortcuts en la carpeta del proyecto.

2. Crea la carpeta y describe el proyecto​

mkdir hello-rapid && cd hello-rapid

Abre tu agente en esa carpeta y escribe (en Codex, $rapid-init):

/rapid-init una API en Python para validar nombres de usuario

3. Responde a sus propuestas​

El agente te pregunta, una decisión a la vez: stack, topología, arquetipo (MVP o Corporate), comando de tests y los cuatro documentos del proyecto (brief, reglas de negocio, modelo de datos y arquitectura). Para cada decisión te recomienda una opción y una alternativa. Si el producto es un frontend sobre un backend como servicio, elige la topología fullstack-baas: el agente te propone entonces el proveedor (Supabase o Firebase) como cualquier otro stack, con una alternativa y las razones del catálogo (modelo de datos, auth, realtime, funciones en servidor, desarrollo local, salida). Si le dices que decida él, elige, te dice cuál y por qué, y setup.json registra que esa decisión la tomó el agente (decided_by: agent). Al final te muestra los comandos locales del proveedor (supabase start, o firebase emulators:start) para que los ejecutes tú. Para cada documento eliges:

  • Pegarlo si ya lo tienes.
  • Que lo redacte el agente: te muestra el borrador completo antes de guardarlo.
  • Omitirlo.

Lo que redacta el agente queda como borrador. Antes de cerrar te resume cada uno y te pregunta si lo confirmas: confirmado pasa a ser regla del proyecto; sin confirmar queda como supuesto que el agente puede cuestionar. Solo se confirma lo que tú digas explícitamente.

Qué ejecuta el agente por debajo

Los mismos comandos que puedes usar tú sin agente:

rapid setup next --json
rapid setup set stack python-fastapi
rapid setup set archetype mvp
rapid setup set test-command "python -m unittest discover"
rapid setup doc business --source drafted --file -   # el cuerpo por stdin; queda como borrador
rapid setup doc brief --skip
rapid setup review --done
rapid setup finish

Todos están en la referencia de rapid setup.

4. Pide tu primera funcionalidad​

/rapid-feature añadir una función validate_username a app.py

Sin argumentos, /rapid-feature te propone la primera historia sin marcar del brief (- [ ] H001: ...) y espera tu confirmación. El agente redacta la spec, implementa tarea por tarea y corre los tests.

5. Aprueba en tu terminal​

Cuando termina, el agente se detiene y te da el comando exacto. Ejecútalo en otra terminal, fuera del agente:

rapid approve gate.final-verification

Vuelve al agente y escribe /rapid-next: el run se cierra con su veredicto. Listo: tu primera funcionalidad quedó implementada, probada y aprobada por ti. Si quieres rechazar, ver en qué va o cancelar, mira Cuando el agente se detiene.

Sin agente: rapid init

rapid init hace el onboarding desde la terminal con preguntas interactivas. Es la alternativa si no usas un agente; lo que no resuelvas queda pendiente para /rapid-init.

Siguientes pasos​

Modo avanzado (comandos v3)​

No lo necesitas para usar Rapid OS. Si quieres ver el mismo trabajo hecho a mano con los comandos v3 (para CI o auditoría), sigue el recorrido manual (Bajo el capó) y el ciclo de gobernanza v3.