Skill: wakeup

Guía de bienvenida para nuevos adoptantes de Neb. Objetivo: que el usuario entienda qué tiene en sus manos y deje montada la configuración mínima (overlay + primer profile) para trabajar. Los pasos canónicos viven en docs/user-guide.md; este skill los ejecuta de forma interactiva — no los repite.

Flujo del recorrido

1. Presentar (empezar directo, sin preguntar permiso)

Abrir con 2-3 oraciones:

• Neb es un sistema de trabajo con Claude Code que formaliza fases (clarificación → propuesta → implementación → validación) y genera artefactos trazables — no un generador de código autónomo.
• Garantiza comportamiento explícito (el agente no se salta fases), customizable (adaptar los valores por defecto vía personal/<usuario>.md sin forkear el núcleo) y expandible (agregar profiles y skills propios sin tocar el núcleo). Ver methodology/promises.md para las promesas de Neb.

2. Detectar el estado (vía script, no a mano)

Resuelve el script (el clon de NEB_HOME si lo hay; si no, la raíz del plugin, que Claude Code sustituye al cargar este skill) y corre la simulación:

NEB_SRC="${NEB_HOME:-}"
case "$NEB_SRC" in ""|*/plugins/cache/*|*\\plugins\\cache\\*) NEB_SRC="${CLAUDE_PLUGIN_ROOT}" ;; esac
[ -f "$NEB_SRC/VERSION" ] || echo "Neb: no hay VERSION en '$NEB_SRC'. Si la ruta es la de NEB_HOME, corrígela; si quedó vacía, actualiza Claude Code (sustitución de CLAUDE_PLUGIN_ROOT en skills)" >&2
bash "$NEB_SRC/bootstrap/setup-workspace.sh" --dry-run

El script aplica la cascada de detección y reporta sin escribir nada. Consume su salida — no re-detectes la estructura por tu cuenta (el script es la fuente de verdad):

• Ya conectado (NEB_WORKSPACE configurado y válido): confírmalo en una línea y pasa a las opciones restantes (no re-configures).
• "Workspace existente detectado en <dir>" (caso típico: el usuario clonó el repositorio del espacio de trabajo de su equipo y corre /wakeup desde el clon): ofrece "Conectar este espacio de trabajo" como opción primera — corre --existing "<dir>": establece NEB_WORKSPACE y crea su personal/<usuario>.md si falta, sin tocar la estructura existente.
• "Workspace(s) existente(s) encontrado(s) bajo $HOME" (el cwd no era espacio de trabajo; el script barrió $HOME con el mismo marcador): con 1 resultado, ofrece conectarlo; con varios, menú de selección para que el usuario elija — nadie teclea paths a mano.
• Sin espacio de trabajo (ni en cwd ni en el barrido): pregunta si tiene uno en otra ruta (--existing <ruta>) o crea uno nuevo (opción 1 de abajo).

3. Ofrecer las opciones (ejecutar, no describir)

Presentar las acciones de adopción como menú de selección (formato de communication.md § "Elecciones: menú de selección"). Cada opción ejecuta los pasos de user-guide.md de forma interactiva, sin repetirlos en la conversación:

1. Conectar / montar el entorno — si el paso 2 detectó un espacio de trabajo existente, la acción es conectarlo (--existing "<dir>"). Si no, pregunta dónde crear el espacio de trabajo: (por defecto) neb_workspace/ en el dir actual; --base <dir> para otra ubicación. Corre bash "$NEB_SRC/bootstrap/setup-workspace.sh" [--base <dir> | --existing <dir>] [--overlay <nombre>] (sin --dry-run): crea/conecta el scaffolding (overlay + overlay/startup.md + personal/ + changes/), personal/<username>.md (username del SO) y establece NEB_WORKSPACE en ~/.claude/settings.json automáticamente (merge no-destructivo, vía set-neb-env.py; NEB_HOME solo se persiste cuando no resuelve al cache del plugin). Bajo plugin el SessionStart ya viene registrado; el paso mínimo no requiere tocar settings.json a mano (los hooks opcionales también los registra el plugin y se activan con NEB_HOOKS: ver user-guide § Retomar y relevar trabajo). Es el paso mínimo (ver user-guide § Montar tu overlay).
2. Definir el primer profile — preguntar el dominio ("¿Python/ML, PHP/backend, React, iOS…?"), proponer nombre en kebab-case, cambiar a profile profile-authoring y guiar init-profile-subproject.sh en el overlay. Puede incluir skill de apoyo (skill-authoring) y agentes revisores.
3. Versionar la configuración personal — seguir user-guide § Versionar tu configuración personal.

4. Cierre

Confirmar lo que quedó montado/conectado (espacio de trabajo, overlay, primer profile), recordar abrir una sesión nueva para que el hook tome el espacio de trabajo, y señalar 2 referencias sin abrumar:

• general/index.md — mapa de Neb.
• methodology/promises.md — qué garantiza.

Restricciones

• No leer ni mostrar archivos extensos durante el recorrido — solo nombrar paths y seguir user-guide.
• No duplicar los pasos de user-guide.md en la conversación — ejecutarlos refiriendo a la guía (la guía es la fuente única).
• Delega en setup-workspace.sh para detectar y configurar el entorno: corre el script y lee su salida; no re-implementes su lógica de detección en la conversación.
• Mantener el recorrido conversacional — usar el formato de menú de selección de communication.md.
• No generar plan estructurado (tabla de archivos, SemVer, change MD) salvo que el usuario pida crear un profile/skill — ahí sí, seguir el flujo de profile-authoring o skill-authoring.
• Si el usuario quiere saltarse el recorrido e ir directo al trabajo, dejarlo — el recorrido es opcional.