Перевірка перед запуском сайту: цикл верифікації агента

Що означає «перевірка перед запуском» простими словами

Уяви: друг шле фото торта. Рівний, блискучий, свічки горять. «Готово, налітай!» Ти приходиш - а всередині сире тісто. Зовні ж краса. Просто зубочисткою ніхто не проколов.

Ось «готово» від ШІ-агента - це рівно той момент, коли зубочистку ще не діставали. Агент чесно зробив те, що ти просив. І щиро вірить, що все чудово. Тільки він не перевіряв. Поки ти не попросив.

Навіщо вайбкодеру перевіряти результат агента

Ти вайбкодер. Код рядок за рядком не читаєш - і це окей. Але саме тому тобі потрібен спосіб перевірити результат, не читаючи код. Цикл перевірки - і є цей спосіб. Опануєш - отримаєш одразу кілька бонусів:

• перестанеш викладати сайти, які ламаються на першому ж кліку;
• упіймаєш помилку, поки вона маленька - а не коли друзі пишуть «у тебе там усе біле»;
• навчишся відрізняти «агент думає, що зробив» від «реально працює»;
• спатимеш спокійно. Бо на руках зелений звіт, а не просто віра в краще.

Між «я виклав сайт» і «я виклав робочий сайт» - один прогін перевірки. Десять хвилин, які заощаджують тобі цілий вечір ганьби.

Як працює цикл перевірки (verification loop) у Claude

У тямущого агента є вбудована звичка - верифікація Верифікація (verification) - перевірка, що зроблене реально працює: збирається, запускається, проходить тести. Не «я думаю, ок», а «я перевірив, ось доказ». . Жодної магії. І жодного одного чарівного тесту. Це чек-лист по фазах, який агент проходить згори вниз. Пройдімося по ньому по-людськи.

Крок 1. Збірка проєкту - а воно взагалі збирається?

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

Крок 2. Перевірка типів - усі деталі стикуються?

Далі - перевірка типів Перевірка типів (type check) - авто-контроль, що дані стикуються: число туди, де чекають число, текст туди, де чекають текст. Ловить купу дурних помилок до запуску. . По-простому: контроль «гвинтик А реально влізає в дірку А, а не забитий молотком навскіс». Машина сама пробігає по проєкту й показує, де щось не стикується. Критичні помилки лагодимо одразу. Не відкладаємо.

Крок 3. Лінтер - прискіпливий сусід-перфекціоніст

Лінтер Лінтер (linter) - авто-перевірка стилю й охайності коду. Не ламає сайт, але ловить сміття, одруки й підозрілі місця. - це вʼїдливий сусід. Ходить квартирою й бурчить: тут пилюка, тут криво повісив, тут лампочку забув укрутити. Від його бурчання сайт не падає. Зате лад наводить - і мимохідь частенько ловить справжні баги.

Крок 4. Тести - хтось тисне за тебе всі кнопки

Тести Тести - маленькі авто-перевірки: «натисни сюди - має статися ось це». Ганяються за секунди й показують, що не зламалося те, що раніше працювало. - це робот, який замість тебе тисне на всі кнопки й звіряє: роблять вони те, що мають, чи ні. Агент їх запускає й доповідає чесно: скільки всього тестів, скільки пройшло, скільки впало.

Крок 5. Безпека - чи не забув ключі в замку

Тут агент шукає те, що ніколи не повинно потрапити в публічний код: паролі, секретні ключі, токени доступу. Це як перевірити, чи не лишив ти ключі від квартири під килимком із написом «КЛЮЧІ ТУТ». А заразом вичищає забуті налагоджувальні «крики в консоль».

Крок 6. Перегляд змін - що взагалі помінялося

Фінал: агент дивиться список того, чого реально торкнувся. Які файли змінилися, скільки рядків. Ось тут і спливають сюрпризи. «Ой, я переписав не той файл». Або «а чому змінилося 40 файлів - я ж просив поправити одну кнопку?»

Як виглядає хороший звіт про перевірку

Наприкінці агент має видати тобі короткий звіт-світлофор. Не простирадло тексту. Ось як з першого погляду відрізнити корисний звіт від пустушки.

Приклад: чому «готово» від агента ламає сайт

Ти вайбкодиш лендинг для свого каналу. Агент годину трудиться не покладаючи процесора - генерить форми, анімації, галерею. І радісно пише: «Готово! Сайт повністю працює 🎉». Ти викладаєш, кидаєш посилання друзям - а там білий екран і одна сумна помилка в кутку.

Що сталося насправді:

1. Агент дописав останню фічу і не перезібрав проєкт - збірка тихо впала.
2. Десь «гвинтик не вліз» (помилка типів), а перевірити було нікому.
3. «Готово» означало «я закінчив друкувати». А не «я перевірив, що працює».

Тямущий вайбкодер зіграв би хитріше. Він заздалегідь заборонив би агенту вимовляти «готово» без звіту:

Коли закінчиш завдання, не пиши мені «готово», поки не проженеш повну перевірку й не покажеш звіт.
Пройди по кроках:

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

Коли запускати перевірку перед запуском

Смикати зубочистку після кожної літери не треба - це повільно й дорого в токенах. Ганяй перевірку на межах:

1. Закінчив фічу - прогнав перевірку, переконався, що не зачепив старе.
2. Перед публікацією - обовʼязково. Останній рубіж перед очима друзів.
3. Після великої переробки - агент багато перетрусив, зачепити щось - завиграшки.
4. Коли «дивно поводиться» - кнопка не тиснеться, картинка не вантажиться. Перевірка покаже, де саме.
5. У довгій сесії - раз на 10-15 хвилин активної роботи, щоб помилка не росла сніговою кулею.

Часті помилки новачка під час перевірки сайту

• Вірити слову «готово». Це гіпотеза. Факт - лише зелений звіт після перевірки.
• Пиляти нове поверх завáленої збірки. Збірка червона - усе решта безглузде. Спершу лагодь її.
• Перевіряти один раз у самому кінці. Помилок накопичиться гора, і спробуй потім розберися, яка звідки. Ганяй на межах.
• Приймати «тести пройшли» без цифр. Скільки їх було? Може, тестів рівно нуль - ось «усі й пройшли».
• Забивати на безпеку. Один забутий ключ у публічному коді - і скористається ним явно не та людина.
• Публікувати, не відкривши сам сайт. Навіть зелений звіт не звільняє від того, щоб глянути на живий сайт власними очима.