Onboarding de Equipo

Configura RaiSE para tu equipo desde cero absoluto. Esta guía empieza desde "no tengo organización" y termina con un equipo configurado donde los nuevos devs se unen con un solo skill.

El Camino¶

             Tú (ahora mismo)
                  │
    ┌─────────────┴──────────────┐
    │  Fase 0: Crear tu Org      │  ← signup en raise.sh (2 min)
    └─────────────┬──────────────┘
                  │
    ┌─────────────┴──────────────┐
    │  Fase 1: Primer Dev Setup  │  ← /rai-onboard-repo (5 min)
    └─────────────┬──────────────┘
                  │
    ┌─────────────┴──────────────┐
    │  Fase 2: El Equipo se Une  │  ← /rai-onboard-repo (2 min c/u)
    └────────────────────────────┘

Fase 0: Crear tu Organización¶

Antes de que alguien pueda conectarse, necesitas una org en el servidor RaiSE.

1. Registrarse en raise.sh¶

Ve a raise.sh/signup y crea tu organización:

Tu nombre — cómo Rai te llama
Email — recibe el link de verificación
Nombre de organización — tu equipo o empresa (ej: "Acme Engineering")

Esto crea:

Una org con plan community (gratis, 5 seats, 1 año)
Un org slug derivado del nombre (ej: acme-engineering)
Tú como admin de la org

2. Verificar tu email¶

Revisa tu bandeja de entrada por el email de bienvenida y haz click en el link de verificación. Esto activa tu org.

3. Anotar tu org slug¶

Necesitarás el slug para rai connect. Se muestra en el email de bienvenida y en el dashboard. Ejemplo: acme-engineering.

Community vs Pro: El signup crea un plan Community (gratis, 5 seats). Incluye todo lo necesario para onboarding: conexión al servidor, sync de config, patterns scoped por proyecto. Upgrade a Pro para team awareness, memoria semántica compartida, e infraestructura dedicada.

Fase 1: Setup del Primer Desarrollador¶

El team lead (o primer adopter) instala la CLI, conecta a la org, y configura el proyecto.

1. Instalar la CLI¶

cd tu-proyecto
curl -LsSf https://docs.raiseframework.ai/install.sh | bash

2. Configurar credenciales Atlassian (si usas Jira/Confluence)¶

Agrega a .bashrc / .zshrc para persistencia:

export JIRA_URL="https://tusitio.atlassian.net"
export JIRA_API_TOKEN="tu-api-token"
export JIRA_USERNAME="[email protected]"

# Opcional — Confluence
export CONFLUENCE_URL="https://tusitio.atlassian.net/wiki"
export CONFLUENCE_API_TOKEN="tu-api-token"
export CONFLUENCE_USERNAME="[email protected]"

Las credenciales nunca se almacenan en archivos de config. Los YAML contienen URLs, claves de proyecto y workflows — nunca tokens ni passwords. Cada dev usa su propio API token via variables de entorno.

3. Ejecutar el skill de onboarding¶

/rai-onboard-repo

El skill ejecuta 8 checks y muestra tu status:

--- RaiSE Setup Status ---
✗ Developer profile not created
✗ Not connected to a RaiSE server
✗ Project not initialized
✗ Adapters not configured
✗ Repository not registered
✗ Project not linked
⊘ Config not shared with team
⊘ Governance not set up

6 steps remaining + 2 optional. Continue? [Y/n]

Luego te guía por cada paso faltante:

Paso 1 — Perfil: Pregunta tu nombre (única pregunta obligatoria) y crea tu perfil en ~/.rai/developer.yaml. Opcional: idioma y estilo.

Paso 2 — Conectar: Imprime instrucciones y se detiene — ejecuta rai connect <org-slug> manualmente. Como eres el admin, tú apruebas. Después ejecuta /rai-onboard-repo de nuevo.

rai connect acme-engineering
# Se abre navegador → login → aprobar dispositivo → listo

Paso 3 — Inicializar: Detecta el nombre del proyecto y ejecuta rai init --name <detectado> --detect. Crea .raise/manifest.yaml con convenciones de tu proyecto.

Paso 4 — Auto-configurar adapters: Si env vars de Atlassian están seteadas, ejecuta rai adapter setup auto. Best-effort — salta si faltan.

Paso 5 — Registrar y linkear: Detecta tu remote, registra el repo, crea proyecto y linkea.

Paso 6 — Compartir config: Detecta que eres el primer dev y ejecuta rai project push-config automáticamente. Sube config para que los joiners la descarguen.

Paso 7 — Governance (opcional): Pregunta si quieres configurar docs de governance. Default: skip.

Paso 8 — Knowledge graph: Construye el grafo de conocimiento.

Al final:

--- RaiSE Setup Complete ---
✓ Developer: Tú (prefix: T)
✓ Connected to api.raise.sh (org: acme-engineering)
✓ Project initialized (mi-proyecto)
✓ Adapters: Jira ✓  Confluence ✓
✓ Repository registered (mi-proyecto)
✓ Linked to project mi-proyecto (primary)
✓ Config shared with team
⊘ Governance: skipped
✓ Knowledge graph: 47 nodes

Next: /rai-session-start

4. Commitear a git¶

git add .raise/
git commit -m "chore: initialize RaiSE project"

5. Comenzar a trabajar¶

rai session start

Fase 2: Nuevo Desarrollador Uniéndose¶

Un nuevo dev se une al equipo. Necesita la CLI, sus propias credenciales, y el org slug. Un skill maneja todo lo demás.

1. Instalar y configurar¶

cd el-proyecto
curl -LsSf https://docs.raiseframework.ai/install.sh | bash

Setear sus propias credenciales Atlassian (mismas env vars que Fase 1, con su token personal).

2. Ejecutar el mismo skill¶

/rai-onboard-repo

La experiencia es idéntica — el skill ejecuta los mismos 8 checks. Las diferencias ocurren automáticamente:

Perfil: Crea su propio ~/.rai/developer.yaml
Conectar: rai connect acme-engineering — el admin aprueba el dispositivo
Inicializar: Detecta que el servidor ya tiene config y ejecuta rai init --server — descarga manifest + adapters en un shot. Sin prompts, sin copiar archivos.
Adapters: Skip o rai adapter setup auto --force con credenciales personales
Compartir config: Skip — config vino del servidor
Governance: Skip — ya existe en el repo

3. Comenzar a trabajar¶

rai session start

Durante el inicio de sesión, RaiSE automáticamente sincroniza patterns del servidor — solo de este proyecto (no de toda la org). Listo para trabajar.

Qué se sincroniza¶

Qué	Dirección	Alcance	Cuándo
Config de adapters (Jira/Confluence)	Lead → Servidor → Joiner	Proyecto	`push-config` / `init --server`
Patterns (buenas prácticas)	Bidireccional	Scoped por proyecto	Cada `session start` y `pattern sync`
Credenciales (API tokens)	Nunca	Solo personal	Env vars en cada máquina
Estado de sesión	Nunca	Solo local	`.raise/rai/personal/`

Aprobar nuevos dispositivos¶

Cuando un miembro del equipo ejecuta rai connect, el admin recibe una solicitud de aprobación. En el plan Community, aprueba via el dashboard en raise.sh. En Pro, las aprobaciones se pueden automatizar via SSO.

Comparación de tiers¶

Feature	Community (gratis)	Pro
Seats	5	Ilimitados
Servidor	`api.raise.sh` (compartido)	Instancia dedicada
`/rai-onboard-repo`	Sí	Sí
Sync de config	Sí	Sí
Sync de patterns (por proyecto)	Sí	Sí
Team awareness	—	Sí
Memoria compartida (semántica)	—	Sí
Gobernanza organizacional	—	Enterprise
SSO / auto-aprobación	—	Sí

Ambos tiers usan la misma CLI y skills. La diferencia está en capacidad y features avanzados.

Resolución de problemas¶

"Organization 'xyz' not found"¶

El org slug no existe. Revisa el slug en tu email de bienvenida o en raise.sh. Los slugs son minúsculas con guiones (ej: acme-engineering, no Acme Engineering).

"Not connected to a RaiSE server"¶

Ejecuta rai connect <org-slug> manualmente. El device flow requiere un navegador y aprobación del admin.

"No adapter config on server"¶

El team lead aún no ha subido la config. Pídele que ejecute rai project push-config.

"already exists. Use --force to overwrite"¶

Los archivos de config existen de un setup previo. Para regenerar:

rai adapter setup auto --force

"Skipping adapter auto-setup — no env vars"¶

Setea JIRA_URL, JIRA_API_TOKEN, y JIRA_USERNAME en tu entorno. El skill verifica las tres antes de intentar auto-config.

Bajo el capó¶

El skill ejecuta estos comandos por ti. Referencia para debugging:

Paso del skill	Equivalente CLI	Qué hace
Verificar conexión	`cat ~/.rai/server.json`	Lee server URL y org del archivo local
Conectar	`rai connect <org-slug>`	Auth por device flow (manual)
Inicializar	`rai init --name <nombre> --detect`	Crea `.raise/manifest.yaml`
Inicializar (joiner)	`rai init --server`	Lo mismo + descarga config del servidor
Auto-configurar	`rai adapter setup auto`	Descubre Jira/Confluence, escribe YAML
Registrar repo	`rai repo register <nombre> --url <remote>`	Registra repo en servidor
Linkear proyecto	`rai project create` + `rai project link-repo`	Linkea repo a proyecto
Subir config	`rai project push-config --project <nombre>`	Sube config (sin credenciales)

Siguientes pasos¶

Tu Primera Story — Recorre el ciclo de vida completo de una story
Configurando Integraciones — Detalles de setup de Jira/Confluence
Pipeline Quickstart — Ejecuta tu primer pipeline automatizado