Практичний процес роботи з ШІ-агентами

ШІ-агент для коду найкорисніший, коли ставитися до нього як до сильного виконавця з вузьким завданням, а не як до автомата з випадковим кодом. Нечітке побажання він заповнить власними здогадками. Чіткий результат, межі й спосіб перевірки перетворюють роботу на те, що легко прочитати та оцінити.

Процес нижче підходить для Claude Code, Codex, Cursor та схожих інструментів. Їхні інтерфейси швидко змінюються, але базовий цикл стабільний: описати результат, дати агенту спочатку розібратися, перевірити зміни й залишити судження людині.

Вигадане завдання, яке більше, ніж здається

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

• база даних має надійно зберігати стан нагадування;
• планувальник повинен вибирати потрібні зустрічі без дублів;
• шаблон листа має враховувати мову й часовий пояс;
• повторна спроба не повинна перетворити одне повідомлення на три;
• тести мають покривати скасування та перенесення.

Автодоповнення допоможе всередині окремого файлу. Агент може пройти весь шлях і помітити, що простого sent: true недостатньо, коли одночасно працюють два воркери.

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

Пишіть бриф, а не побажання

Корисний промпт схожий на короткий опис задачі:

Мета: надіслати одне нагадування за 24 години до підтвердженої зустрічі.
Використати: наявні scheduler, mail adapter і locale formatter.
Не змінювати: публічні API-маршрути та модель статусів зустрічі.
Крайні випадки: скасування, перенесення і два воркери на одному job.
Перевірка: додати цільові тести й запустити наявну тестову команду.

Кожен рядок прибирає окремий вид невизначеності. Мета описує поведінку, яку можна побачити. «Використати» веде до поточної архітектури. «Не змінювати» не дає локальній задачі стати редизайном системи. Крайні випадки називають важливі відмови. Перевірка визначає докази завершення.

Для зміни на кілька файлів спочатку попросіть план. У Claude Code для цього є Plan Mode і пам’ять проєкту. Короткий план робить хибне припущення дешевим для виправлення.

Спочатку дослідження, потім реалізація

Перша корисна дія агента — зазвичай читання, а не запис. Він має знайти точку входу, сусідні конвенції, тести й команду, якою репозиторій уже перевіряється. Якщо завдання торкається збережених даних або публічного API, треба пройти шлях читання і запису.

У прикладі з консультаціями план може показати, що нагадування вже представлені як jobs. Тоді найменша зміна — новий тип job та idempotency key, а не друга система планування. Саме це дає контекст репозиторію: приваблива відповідь «з нуля» стає сумісною локальною зміною.

Якщо агент пропонує нову залежність, фоновий сервіс або схему ще до огляду наявного шляху, варто зупинитися. Ідея може бути правильною, але її ціна ще нічим не виправдана.

Обирайте інструмент за формою роботи

Робоча поверхня важливіша за назву продукту.

Claude Code зручний, коли центр задачі — термінал: логи, скрипти й реальний вивід команд. Codex підходить для ізольованої тривалої роботи; модель Codex із worktree розділяє паралельні завдання. Cursor залишається близько до редактора, де перегляд diff і контрольні точки зручні для невеликих виправлень та уважного читання.

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

Агент не повинен сам ставити собі оцінку

«Тести пройшли» — твердження. Команда, код завершення та вивід — доказ. Надійний цикл може виглядати так:

npm test -- reminder
npm run typecheck
npm run build

Точні команди залежать від репозиторію. Важливо, щоб вони вже були частиною проєкту або свідомо перевіряли нову поведінку. Агент не має звужувати перевірку, видаляти assertion чи перетворювати помилку на warning лише заради зеленого результату.

Після автоматичних перевірок прочитайте diff:

• Реалізація відповідає вимозі чи лише тестовому fixture?
• Чи може retry або паралельний воркер порушити інваріант?
• Чи випадково не змінився публічний контракт або формат даних?
• Чи буде помилка зрозумілою тому, хто обслуговує систему?
• Нова абстракція справді простіша за код, який замінила?

Візуальний результат треба відкрити у вузькому й широкому вікні. Конфігурацію — перевірити реальною відповіддю чи станом процесу, а не лише синтаксисом.

Намір і дозвіл залишаються людині

Агенти добре перетворюють рішення на узгоджені правки. Вони слабші, коли не визначене саме рішення. Людині варто залишити:

• продуктову мету і прийнятий компроміс;
• фінальний текст, тон і фактичні твердження;
• дозвіл на деплой, облікові дані та руйнівні дії;
• рішення про публічні URL, збережені дані й межі безпеки;
• вибір прийняти, переписати чи викинути згенеровану роботу.

У вигаданому сервісі хтось усе одно має вирішити, що робити із запізнілим нагадуванням: надіслати, пропустити чи передати оператору. Жоден контекст коду не відповість на продуктове питання, яке ніхто не вирішив.

Де процес найчастіше ламається

Типова проблема — не синтаксис, а відсутній контекст. Агент бачить один файл і створює новий патерн, хоча потрібний уже є. Перейменовує публічний маршрут, бо так охайніше. Повторює впевнений факт зі старої статті.

Інструкції репозиторію допомагають із повторюваними правилами, але мають бути короткими. Разові обмеження належать задачі. Для нестабільних фактів потрібні першоджерело й дата. А важливу роботу корисно завершувати питанням: «Що залишилося неперевіреним?»

Хороший агент не просто видає патч. Він залишає межі цього патчу видимими.

Навичка, що живе довше за реліз моделі

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

Такий цикл робить агентів кориснішими, не призначаючи їх автономними власниками. Він так само покращує специфікації для людей. Швидке виконання цінне; чітка відповідальність робить цю швидкість безпечною.