Tutorial 1 Orientation es

Tutorial 1 · Orientación

Meta: poner el proyecto en marcha, conocer a tu agente de IA y correr la barrera de pruebas una vez — para que todo lo que sigue sea automático.

← Volver a Inicio · Siguiente: Tutorial 2 Cómo funciona el código

---

1. ¿Por qué una app de chiste?

Aprender a trabajar con un agente de código es más fácil cuando el código es pequeño, real y de bajo riesgo. LockedIn CLI es las tres cosas:

• Pequeño: un archivo de núcleo, un punto de entrada, una suite de pruebas, cero dependencias.
• Real: se instala como el comando global lockedin y se comporta como una CLI de IA genuina.
• Bajo riesgo: es sátira. Si tu agente hace los humildealardes un 20% más humildes, nadie recibe una alerta a las 3am.

Esa combinación te deja enfocarte en la verdadera habilidad: describir bien un cambio, dejar que el agente lo haga y verificar el resultado.

2. Consigue el código

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

Revisa tu versión de Node (necesitas 18+):

node --version

No hay nada que instalar — sin npm install de dependencias, porque no las hay. Es deliberado: menos piezas móviles, más aprendizaje.

3. Ejecútalo

Prueba lo real:

node bin/lockedin.js            # el splash + banner
node bin/lockedin.js post       # una publicación de “liderazgo de pensamiento”
node bin/lockedin.js aura       # escanea tu aura profesional
node bin/lockedin.js            # (sin args) te deja en la sesión de chat

Escribe /help dentro de la sesión, explora un poco y luego /exit. Todo lo que ves se genera localmente a partir de pools de palabras — sin red, sin cuentas. Lista completa de comandos: Referencia de comandos.

4. Corre la barrera de pruebas

Este es el comando más importante de todo el tutorial:

npm test

Deberías ver un muro de checks verdes que termina en algo como pass 318. Esa suite es tu red de seguridad. De aquí en adelante, el flujo es siempre:

cambia algo → npm test → publica solo si está en verde.

5. Conoce a tu agente

Abre tu agente de código en la carpeta del proyecto para que vea los archivos. Con GitHub Copilot CLI, eso es:

copilot

Luego, para ubicarte, pídele al agente que te oriente a ti (sin cambiar nada todavía). Prueba un prompt como:

“Dame un recorrido de dos párrafos por este repositorio: para qué sirve cada archivo y carpeta de nivel superior, y cómo ejecuto la app y las pruebas. No cambies nada.”

Compara su respuesta con lo que viste en los pasos 3–4. Acostumbrarte a pedirle al agente que explique antes de editar es un hábito clave — lo usaremos mucho.

---

✅ Pruébalo con tu agente

1. Pregúntale al agente: “¿Qué imprime node bin/lockedin.js reflect 'mi café estaba frío' y qué archivo decide esa salida?” Confirma su respuesta ejecutando el comando tú mismo/a.
2. Pídele que corra la suite de pruebas y reporte el resultado: “Ejecuta npm test y dime cuántos checks pasan.”

Ya viste la app, las pruebas y el agente. Ahora veremos por qué este código es tan amigable para los agentes — el diseño que te deja delegar cambios con confianza.

Siguiente: Tutorial 2 Cómo funciona el código