Tutorial 1 Orientation eu

Tutorial 1 · Orientazioa

Helburua: proiektua martxan jarri, zure AI agentea ezagutu eta test-langa behin exekutatu — honen ondorengo guztia muskulu-memoria izan dadin.

← Itzuli Etxea · Hurrengoa: 2 Nola funtzionatzen duen kodeak

---

1. Zergatik txantxa-app bat?

Kodetze-agente batekin lan egiten ikastea errazena da kodea txikia, benetakoa eta arrisku txikikoa denean. LockedIn CLI hiruak da:

• Txikia: nukleo-fitxategi bat, sarrera-puntu bat, proba-suite bat, mendekotasunik gabe.
• Benetakoa: lockedin komando global gisa instalatzen da eta benetako AI CLI baten moduan jokatzen du.
• Arrisku txikikoa: satira da. Zure agenteak humblebrag-ak % 20 apalago egiten baditu, inori ez zaio alertarik iristen.

Konbinazio horrek benetako trebetasunean fokatzen uzten dizu: aldaketa bat ondo deskribatu, agenteari lana egiten utzi eta emaitza egiaztatu.

2. Eskuratu kodea

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

Egiaztatu zure Node bertsioa (18+ behar da):

node --version

Ez dago ezer instalatzeko — mendekotasunen npm install-ik ez, ez baitago bat ere. Nahita da: pieza mugikor gutxiago, ikasketa gehiago.

3. Exekutatu

Probatu benetakoa:

node bin/lockedin.js            # splasha + bannerra
node bin/lockedin.js post       # sortutako "thought leadership" posta bat
node bin/lockedin.js aura       # eskaneatu zure aura profesionala
node bin/lockedin.js            # (argumenturik gabe) txat-saiora eramaten zaitu

Idatzi /help saioaren barruan, ibili miatzen, eta gero /exit. Ikusten duzun guztia lokalki sortzen da hitz-pooletatik — sarerik ez, konturik ez. Komando-zerrenda osoa: Komando-erreferentzia.

4. Exekutatu test-langa

Hau da tutorial osoko komandorik garrantzitsuena:

npm test

Egiaztapen berdeen horma bat ikusi beharko zenuke, pass 318 bezalako zerbaitekin amaituz. Suite hori zure segurtasun-sarea da. Hemendik aurrera, lan-fluxua beti hau da:

aldatu zerbait → npm test → argitaratu berde badago soilik.

5. Ezagutu zure agentea

Ireki zure kodetze-agentea proiektuaren karpetan fitxategiak ikus ditzan. GitHub Copilot CLIrekin, hau da:

copilot

Ondoren, kokatzeko, eskatu agenteari zu orientatzeko (oraindik ezer aldatu gabe). Probatu honelako prompt bat:

"Emadazu biltegi honen bi paragrafoko ibilbide bat: goi-mailako fitxategi eta karpeta bakoitza zertarako den, eta nola exekutatzen ditudan app-a eta probak. Ez aldatu ezer."

Irakurri bere erantzuna 3–4 urratsetan ikusi zenuenaren aurrean. Agenteari editatu aurretik azaltzeko eskatzen erosotasuna hartzea funtsezko ohitura bat da — asko baliatuko gara horretaz.

---

✅ Probatu zure agentearekin

1. Galdetu agenteari: "Zer inprimatzen du node bin/lockedin.js reflect 'nire kafea hotza zegoen'-ek, eta zein fitxategik erabakitzen du irteera hori?" Baieztatu bere erantzuna komandoa zuk zeuk exekutatuz.
2. Eskatu proba-suitea exekutatzeko eta emaitza jakinarazteko: "Exekutatu npm test eta esan zenbat egiaztapen gainditzen diren."

Dagoeneko ikusi dituzu app-a, probak eta agentea. Hurrengoan, zergatik den kode-base hau hain agente-lagunkoia ikusiko dugu — aldaketak konfiantzaz eskuordetzen uzten dizun diseinua.

Hurrengoa: 2 Nola funtzionatzen duen kodeak