Tutorial 1 Orientation it

Tutorial 1 · Orientamento

Obiettivo: mettere in moto il progetto, conoscere il tuo agente di IA ed eseguire la barriera dei test una volta — così tutto ciò che segue diventa automatico.

← Torna a Pagina iniziale · Avanti: Tutorial 2 Come funziona il codice

---

1. Perché un'app scherzo?

Imparare a lavorare con un agente di codice è più facile quando il codice è piccolo, reale e a basso rischio. LockedIn CLI è tutte e tre le cose:

• Piccolo: un file di core, un punto d'ingresso, una suite di test, zero dipendenze.
• Reale: si installa come il comando globale lockedin e si comporta come una vera CLI di IA.
• A basso rischio: è satira. Se il tuo agente rende gli humblebrag il 20% più umili, nessuno riceve una notifica di reperibilità.

Quella combinazione ti lascia concentrare sulla vera abilità: descrivere bene un cambiamento, lasciare che l'agente faccia il lavoro e verificare il risultato.

2. Ottieni il codice

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

Controlla la tua versione di Node (serve la 18+):

node --version

Non c'è niente da installare — nessun npm install di dipendenze, perché non ce ne sono. È voluto: meno parti in movimento, più apprendimento.

3. Eseguilo

Prova la cosa vera:

node bin/lockedin.js            # lo splash + il banner
node bin/lockedin.js post       # un post di "thought leadership" generato
node bin/lockedin.js aura       # scansiona la tua aura professionale
node bin/lockedin.js            # (senza args) ti fa entrare nella sessione di chat

Scrivi /help dentro la sessione, curiosa un po', poi /exit. Tutto ciò che vedi è generato localmente da pool di parole — nessuna rete, nessun account. Lista completa dei comandi: Riferimento dei comandi.

4. Esegui la barriera dei test

Questo è il comando più importante di tutto il tutorial:

npm test

Dovresti vedere un muro di spunte verdi che finisce con qualcosa come pass 318. Quella suite è la tua rete di sicurezza. Da qui in poi, il flusso è sempre:

cambia qualcosa → npm test → pubblica solo se è verde.

5. Conosci il tuo agente

Apri il tuo agente di codice nella cartella del progetto così che possa vedere i file. Con GitHub Copilot CLI, questo è:

copilot

Poi, per orientarti, chiedi all'agente di orientare te (senza cambiare ancora niente). Prova un prompt come:

"Dammi un tour di due paragrafi di questo repository: a cosa serve ogni file e cartella di primo livello, e come eseguo l'app e i test. Non cambiare niente."

Confronta la sua risposta con ciò che hai visto ai passi 3–4. Abituarti a chiedere all'agente di spiegare prima di modificare è un'abitudine fondamentale — ci appoggeremo molto su di essa.

---

✅ Provaci con il tuo agente

1. Chiedi all'agente: "Cosa stampa node bin/lockedin.js reflect 'il mio caffè era freddo', e quale file decide quell'output?" Conferma la sua risposta eseguendo tu stesso/a il comando.
2. Chiedigli di eseguire la suite di test e di riferire il risultato: "Esegui npm test e dimmi quante spunte passano."

Ora hai visto l'app, i test e l'agente. Poi vedremo perché questo codice è così amichevole per gli agenti — il design che ti lascia delegare i cambiamenti con fiducia.

Avanti: Tutorial 2 Come funziona il codice