Saltar a contenido

Primeros Pasos

Esta guía te lleva de cero a tu primera sesión de trabajo con RaiSE. Síguelo de arriba a abajo — todo lo que necesitas está en esta página.

¿Qué es RaiSE?

RaiSE es una metodología y toolkit para ingeniería de software confiable con IA. Convierte a los asistentes de código con IA de generadores impredecibles en colaboradores disciplinados — a través de gobernanza, memoria y flujos de trabajo estructurados.

Trabajas a través de tres partes que colaboran:

  • Tú decides qué construir y por qué. Tú tienes el juicio.
  • Rai es tu partner de IA. Ejecuta con memoria acumulada y sigue tus reglas.
  • RaiSE provee la disciplina — skills, gobernanza y quality gates.

El resultado: IA que aprende de tu proyecto, sigue tus reglas y acumula conocimiento entre sesiones en vez de empezar de cero cada vez.

¿Actualizando desde una versión anterior?

  • De 2.x → 3.0: cambios incompatibles — consulta la guía de migración.
  • De venv/pip → binario: RaiSE 3.1+ se distribuye como binario standalone. Consulta Migrar de venv a binario — sin dependencia de Python ni uv.
  • De 3.0 → 3.1: reconstruir el graph (rai graph build), prefijo de env RAI_* → RAISE_*, continuidad de sesión con alcance por worktree.

Paso 1: Instalar el CLI

Un solo comando. RaiSE se distribuye como binario standalone — no necesitas Python, uv ni entorno virtual.

# Linux / macOS
curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash

# Windows (PowerShell)
irm https://github.com/humansys/raise/releases/latest/download/install.ps1 | iex

Verifica que funcionó:

rai --version

Prerrequisitos: Git (el único requisito duro) y Claude Code (asistente de IA recomendado).

¿Necesitas más opciones?

Fijar una versión específica, instalar desde source o resolver problemas de PATH — consulta la Guía de Instalación.

Paso 2: Configurar tu proyecto

Navega a la raíz de tu proyecto y ejecuta:

cd tu-proyecto
rai onboard

rai onboard detecta el estado de tu repo (proyecto nuevo o codebase existente) y te enruta al setup correcto automáticamente. Ejecuta rai init --detect --yes para proyectos brownfield y rai init --yes para greenfield.

Alternativa manual

Puedes inicializar manualmente si prefieres más control:

cd tu-proyecto
rai init --detect

El flag --detect analiza tu código existente y detecta convenciones (naming, testing, formato).

cd tu-proyecto
rai init

Esto crea el directorio .raise/ — metadata del proyecto, configuración y un espacio para que la memoria se acumule.

Paso 3: Conoce a Rai

Abre Claude Code en el directorio del proyecto. Ejecuta:

/rai-welcome

Esta es una configuración de una sola vez. Crea tu perfil de desarrollador — la única pregunta obligatoria es tu nombre. Detecta el tipo de proyecto automáticamente y te dirige al siguiente paso.

Paso 4: Configura tu proyecto

Ahora configura la gobernanza — las reglas, principios y arquitectura que Rai seguirá al trabajar en tu proyecto.

/rai-project-onboard

Esto descubre las convenciones de tu codebase, lee documentación existente (README, ARCHITECTURE, etc.) y solo pregunta lo que el código no puede decir. Ejecuta el discovery automáticamente — no necesitas correr nada más antes.

¿Quieres más control?

Puedes correr /rai-discover antes de /rai-project-onboard para revisar lo que se detectó. El skill de onboard usará esos resultados en vez de correr discovery de nuevo.

/rai-project-create

Esto te guía para definir los principios, requisitos y reglas de tu proyecto desde cero.

Ambos skills escriben documentos de gobernanza y construyen un knowledge graph. Después de este paso, Rai entiende tu proyecto.

Paso 5: Inicia tu primera sesión

De ahora en adelante, cada vez que abras Claude Code para trabajar, empieza con:

/rai-session-start

Esto carga el contexto, memoria y patrones de tu proyecto. Rai propone en qué trabajar basándose en items pendientes e historial reciente.

Las sesiones son 1:1 con tus sesiones de asistente IA — inicia una, trabaja enfocado, ciérrala:

/rai-session-close

Esto captura lo que ocurrió, persiste patrones y prepara la continuidad para la próxima vez. Cada sesión hace a la siguiente más inteligente.

Los tres ciclos de trabajo

RaiSE organiza el trabajo en tres ciclos anidados. No necesitas usar los tres desde el día uno — empieza con sesiones y stories.

Sesiones

Una sesión es un período de trabajo enfocado. Ábrela con /rai-session-start, ciérrala con /rai-session-close. Las sesiones construyen continuidad — lo que aprendes hoy se lleva al mañana a través de memoria y patrones.

Stories

Una story es la unidad de trabajo entregable — una feature, un fix, un refactor. Toda story sigue el mismo ritmo:

Paso Skill Qué ocurre
Scope /rai-story-start Crear branch, definir qué entra y qué no
Diseño /rai-story-design Leer el código, especificar el enfoque
Plan /rai-story-plan Descomponer en tareas atómicas
Construir /rai-story-implement TDD: test → código → verificar → commit por tarea
Reflexión /rai-story-review ¿Qué aprendimos? Capturar patrones
Entregar /rai-story-close Merge, limpiar, actualizar tracking

Empieza con una feature pequeña — algo que puedas terminar en una sesión. Primero domina el ritmo, luego escala.

→ Recorre tu primera story paso a paso

Épicas

Una épica es un cuerpo de trabajo que abarca 3–10 stories. Usa épicas cuando una feature es demasiado grande para una sola story:

Paso Skill Qué ocurre
Inicio /rai-epic-start Definir scope y brief
Diseño /rai-epic-design Descomponer en stories
Plan /rai-epic-plan Secuenciar y priorizar
Trabajo [ciclo de story por story] Ejecutar cada story
Cierre /rai-epic-close Retrospectiva y limpieza

No necesitas épicas para tus primeras stories. Se vuelven útiles cuando ya dominas el ciclo de stories.

Siguiente paso

Ya estás configurado. Aquí es donde seguir: