Laboratorio Los portales de Nexus
[!TIP] Descarga el ZIP del alumno o copia todo este laboratorio en una carpeta sin usar. Lee la configuración y los pasos opcionales de GitHub primero.
Antes de ejecutar nada
| Elemento | Contrato |
|---|---|
| Runtime | Node 24; las integraciones en vivo son independientes |
| Archivos a revisar | starter/portal-map.json, verify.js |
| Directorio del verificador | Raíz del kit extraído: node verify.js; desde starter/: node ../verify.js |
| Estado inicial | Se rechaza un starter sin terminar; conserva el diagnóstico |
| Evidencia final | Cada fila de tarea tiene cuatro dimensiones independientes; un pull request de GitHub no se confunde con un entorno. |
Concepto en la práctica: Un mantenedor pide una explicación y luego un cambio. Ask puede inspeccionar sin editar; una sesión Agent posterior puede usar un worktree. Registra esas decisiones por separado en vez de describir ambas como un único modo de agente.
Practica el enrutamiento del trabajo sin confundir el rol del agente, el harness, el destino de la sesión y el entorno de ejecución.
Misión
Completa starter/portal-map.json:
| Tarea | Rol | Harness | Destino | Entorno |
|---|---|---|---|---|
| Explicar un módulo desconocido | ask |
vscode-local |
local |
repository-folder |
| Diseñar una migración de API | plan |
vscode-copilot |
copilot |
repository-folder |
| Implementar y probar de forma aislada | agent |
vscode-copilot |
copilot |
worktree |
Estas son decisiones didácticas para este ejercicio controlado, no requisitos universales para todas las tareas.
Ejecuta:
node verify.js
El verificador comprueba las cuatro dimensiones de forma independiente.
Ejecución guiada
- Ejecuta el verificador sin modificar y registra el estado inicial esperado.
- Pide una explicación fundamentada en las fuentes del código y las comprobaciones relevantes.
- Planifica: asigna los tres renglones de tareas a rol, harness, destino y entorno. Justifica cada elección, identifica qué dimensiones comprueba el verificador y mantén la tarea de solo lectura hasta que el mapa sea revisado.
- Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
- En el mapa desechable, intercambia temporalmente un rol por un valor de harness. El verificador debe rechazar las dimensiones mezcladas. Restaura la fila correcta.
- Revisa el diff y registra la limitación: el verificador comprueba el mapa, no que un host o cuenta seleccionados estén disponibles.
Finalización y restablecimiento seguro
- El comportamiento requerido y su caso negativo cuentan con evidencia observada.
- El resultado distingue la verificación local del comportamiento en vivo del host/runtime.
- No se cambiaron credenciales, archivos no relacionados ni servicios.
- La evidencia está guardada antes de restablecer el starter copiado.
Usa una nueva extracción para otro intento, o restaura solo los archivos nombrados desde una línea base de Git creada en esta copia. Nunca apliques un comando de restablecimiento de la raíz del currículo desde un proyecto ajeno.
Continúa con la aventura y la rúbrica.