Tutorial 1 Orientation uk

Урок 1 · Орієнтація

Мета: запустити проєкт, познайомитися зі своїм ШІ-агентом і один раз пройти тестовий бар'єр — щоб усе подальше було на автоматі.

← Назад до Головна · Далі: Урок 2 Як працює код

---

1. Навіщо жартівливий застосунок?

Учитися працювати з агентом з коду найпростіше, коли код маленький, справжній і з низькими ставками. LockedIn CLI — усі три одразу:

• Маленький: один файл ядра, одна точка входу, один набір тестів, нуль залежностей.
• Справжній: встановлюється як глобальна команда lockedin і поводиться як справжній ШІ-CLI.
• З низькими ставками: це сатира. Якщо ваш агент зробить humblebrag-и на 20% скромнішими, нікого не піднімуть по тривозі.

Ця комбінація дає змогу зосередитися на справжній навичці: добре описати зміну, дати агентові зробити роботу й перевірити результат.

2. Отримайте код

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

Перевірте свою версію Node (потрібна 18+):

node --version

Встановлювати нема чого — жодного npm install залежностей, бо їх немає. Це навмисно: менше рухомих частин, більше навчання.

3. Запустіть

Спробуйте справжню річ:

node bin/lockedin.js            # заставка + банер
node bin/lockedin.js post       # згенерований допис «ідейного лідерства»
node bin/lockedin.js aura       # просканувати вашу професійну ауру
node bin/lockedin.js            # (без аргументів) кидає вас у сесію чату

Надрукуйте /help усередині сесії, поколупайтеся, потім /exit. Усе, що ви бачите, генерується локально з пулів слів — без мережі, без облікових записів. Повний список команд: Довідник команд.

4. Пройдіть тестовий бар'єр

Це найважливіша команда в усьому посібнику:

npm test

Ви маєте побачити стіну зелених галочок, що завершується чимось на кшталт pass 318. Цей набір — ваша страхувальна сітка. Відтепер робочий процес завжди:

змініть щось → npm test → викочуйте лише якщо зелено.

5. Познайомтеся зі своїм агентом

Відкрийте свого агента з коду в теці проєкту, щоб він бачив файли. З GitHub Copilot CLI це:

copilot

Потім, щоб зорієнтуватися, попросіть агента зорієнтувати вас (поки нічого не змінюючи). Спробуйте промпт на кшталт:

«Дай мені дводабзацну екскурсію цим репозиторієм: для чого кожен файл і тека верхнього рівня, і як я запускаю застосунок і тести. Нічого не змінюй.»

Порівняйте його відповідь із тим, що ви бачили в кроках 3–4. Звикнути просити агента пояснювати перед тим, як редагувати — це ключова звичка, ми сильно на неї спиратимемося.

---

✅ Спробуйте зі своїм агентом

1. Запитайте агента: «Що друкує node bin/lockedin.js reflect 'моя кава була холодною', і який файл вирішує цей вивід?» Підтвердіть його відповідь, запустивши команду самостійно.
2. Попросіть його запустити набір тестів і повідомити результат: «Запусти npm test і скажи мені, скільки перевірок проходить.»

Тепер ви побачили застосунок, тести й агента. Далі ми подивимося, чому цей код такий дружній до агентів — на дизайн, що дає змогу передавати зміни з упевненістю.

Далі: Урок 2 Як працює код