Tutorial 1 Orientation tl

Tutorial 1 · Oryentasyon

🌎 Wika: Tagalog (tl) — tingnan ang lahat ng 33 wika

Layunin: patakbuhin ang proyekto, kilalanin ang iyong AI agent, at patakbuhin ang test gate nang isang beses — upang maging nakasanayan ang lahat ng susunod.

← Bumalik sa Home · Susunod: Tutorial 2 Paano Gumagana ang Code

---

1. Bakit isang joke app?

Ang pag-aaral na magtrabaho kasama ang isang coding agent ay pinakamadali kapag ang code ay maliit, totoo, at mababa ang stakes. LockedIn CLI ay lahat ng tatlo:

• Maliit: isang core file, isang entry point, isang test suite, zero dependencies.
• Totoo: nai-install ito bilang pandaigdigang command na lockedin at kumikilos tulad ng isang tunay na AI CLI.
• Mababang panganib: satira ito. Kung gagawing 20% na mas mapagpakumbaba ng iyong ahente ang mga humblebrag, walang maaabala.

Hinahayaan ka ng kumbinasyong iyon na tumuon sa aktwal na kasanayan: ilarawan nang maayos ang pagbabago, hayaang gawin ng ahente ang trabaho, at beripikahin ang resulta.

2. Kunin ang code

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

Suriin ang iyong bersyon ng Node (kailangan 18+):

node --version

Walang mai-install — hindi npm install ng mga dependencies, dahil wala. Iyon ay sinadya: mas kaunting mga gumagalaw na bahagi, mas maraming pag-aaral.

3. Patakbuhin ito

Subukan ang tunay na bagay:

node bin/lockedin.js            # splash screen + banner
node bin/lockedin.js post       # isang nabuong "thought-leadership" post
node bin/lockedin.js aura       # i-scan ang propesyonal mong aura
node bin/lockedin.js            # (walang argument) papasok sa chat session

I-type ang /help sa loob ng session, subukan ang ilang command, pagkatapos ay /exit. Lahat ng nakikita mo ay lokal na binubuo mula sa mga word pool — walang network, walang account. Buong listahan ng command: Command Reference.

4. Patakbuhin ang test gate

Ito ang pinakamahalagang utos sa buong tutorial:

npm test

Dapat kang makakita ng maraming berdeng check na nagtatapos sa tulad ng pass 318. Ang suite na iyon ang iyong safety net. Mula rito, palaging ganito ang daloy ng trabaho:

baguhin ang isang bagay → npm test → ipadala lamang kung ito ay berde.

5. Kilalanin ang iyong ahente

Buksan ang iyong coding agent sa project folder para makita nito ang mga file. Sa GitHub Copilot CLI, iyon ay:

copilot

Pagkatapos, upang magkaroon ng malinaw na oryentasyon, hilingin sa ahente na ipaliwanag sa iyo ang repositoryo (nang hindi muna nagbabago ng anuman). Subukan ang prompt na ito:

"Bigyan mo ako ng dalawang-talatang paglilibot sa repositoryong ito: para saan ang bawat nangungunang antas ng file at folder, at kung paano ko pinapatakbo ang app at ang mga pagsubok. Huwag baguhin ang anuman."

Ihambing ang sagot nito sa nakita mo sa hakbang 3–4. Ang pagiging komportable sa paghingi sa ahente na magpaliwanag bago mag-edit ay isang mahalagang ugali — madalas natin itong gagamitin.

---

✅ Subukan ito sa iyong ahente

1. Tanungin ang ahente: "Ano ang ini-print ng node bin/lockedin.js reflect 'malamig ang kape ko', at aling file ang nagpapasya sa output na iyon?" Kumpirmahin ang sagot sa pamamagitan ng pagpapatakbo mo mismo sa command.
2. Hilingin dito na patakbuhin ang test suite at iulat ang resulta: "Patakbuhin ang npm test at sabihin sa akin kung ilang check ang pumasa."

Nakita mo na ngayon ang app, ang mga pagsubok, at ang ahente. Susunod, titingnan natin kung bakit napakahusay ng codebase na ito — ang disenyo na nagbibigay-daan sa iyong ibigay ang mga pagbabago nang may kumpiyansa.

Susunod: Tutorial 2 Paano Gumagana ang Code