Cuplikan materi

feature_list.json для AI-агента: WIP=1, статусы фич и верификация через verify.sh

Как ограничить AI-агента одной задачей за раз (WIP=1): feature_list.json с состояниями фичи, гранулярность задач, scripts/verify.sh как единственный гейт статуса passing, строгая и слабая верификация.

WIP=1 гранулярность задачи feature_list.json конечный автомат фичи сторож гейта

Apa yang akan Anda pelajari dalam kuliah ini

Внедрите WIP=1 и увидите, как падает число незаконченных параллельных изменений.
Заведёте feature_list.json с честным конечным автоматом состояний вместо самоотчётов агента.
Напишете verify.sh, который единственный имеет право ставить статус passing.

Awal materi

Двенадцать файлов, восемьсот строк, ноль готовых фич

Просьба была одна: «сделай регистрацию»
Агент по пути «заодно» подключил email-верификацию, bcrypt, рефакторинг middleware
Полученный код сильно связан, но ни один сценарий не проходит целиком
Следующая сессия открывает эту кашу с нуля

Просьба была ровно одна — сделать регистрацию. Вот как она на практике расползлась на шесть направлений: агент моделирует пользователя, потом решает, что нужна верификация почты, подключает почтовый сервис, вспоминает про хеширование паролей, тянет отдельную библиотеку, замечает несогласованную обработку ошибок и рефакторит middleware, а заодно причёсывает структуру тестов. Шесть направлений, каждое наполовину, всё сильно связано между собой — и ни одного сквозного прогона. Следующая сессия открывает этот код и не понимает, с чего начать.

Арифметика, а не метафора

C — полезная ёмкость контекста агента
k — число одновременно активных задач
На каждую задачу приходится примерно C/k ресурса рассуждения
Как только C/k падает ниже минимума — ни одна задача не доводится до конца

Это не метафора, а арифметика. Обозначим полезную ёмкость контекста агента буквой C, а число одновременно активных задач — буквой k. На каждую задачу приходится примерно C, делённое на k, ресурса рассуждения. Как только это значение падает ниже минимума, необходимого, чтобы довести одну задачу до конца, не доводится до конца ни одна. Чем больше задач держит агент одновременно, тем меньше шансов, что хоть одна из них по-настоящему завершится.

Грабли: одна просьба превращается в шесть проектов

❌ Агент видит «заодно поправить» как бесплатное действие, и часто делают именно так: тянет email-сервис, bcrypt, рефакторинг middleware, реорганизацию тестов — всё в рамках одной задачи
✅ Одна просьба = одна ветка работы; всё замеченное по пути — в BACKLOG.md, а не в текущий скоуп

«Заодно поправлю» — самая дорогая фраза в словаре агента. Просят сделать регистрацию — и агент, раз уж он уже внутри кода, заодно чинит обработку ошибок, заодно подключает верификацию почты, заодно причёсывает тесты. Каждое из этих «заодно» кажется агенту почти бесплатным. Это грабли, на которые наступают постоянно: расширение скоупа стоит агенту почти ноль токенов, а цена для проекта — реальная. Правильный ход другой: одна просьба — одна ветка работы, а всё остальное замеченное фиксируется отдельно и не трогается.

Materi lengkap tersedia dengan langganan

23 slide lagi di versi lengkap.

Video, semua slide, catatan, tes, tutor AI, dan wawancara terbuka setelah masuk dan berlangganan.

Masuk atau daftar Berlangganan

Isi materi

Двенадцать файлов, восемьсот строк, ноль готовых фич
Арифметика, а не метафора
Грабли: одна просьба превращается в шесть проектов
Миф: больше кода — больше прогресса
У агента нет тормозов
Правило #1: принудительный WIP=1 в AGENTS.md
BACKLOG.md — клапан для импульса «заодно»
«Готово» — это команда, а не ощущение
Скоуп — наружу, в файл
VCR: метрика, которая держит агента в узде
❓ Ваш ход: разбейте «сделать корзину» на кванты WIP=1
💡 Не слишком широко, не слишком узко: рабочий размер фичи
Фича = сессия = коммит = сценарий: проверка на размер
WIP=1 наведён. Но кто помнит, что уже готово?
📖 «Корзина почти готова, но баги» — почти готова для кого?
Список фич — позвоночник harness, не памятка
Три поля, без которых запись о фиче — просто слова
У фичи только четыре состояния — и ни одного лишнего перехода
Гейт passing: агент может запросить, но не объявить
Правила списка фич — тоже в AGENTS.md
scripts/verify.sh — единственный, кто имеет право ставить passing
Два уровня проверки: сначала общее, потом частное
«Функция существует» — не значит, что она работает
Путь фичи от очереди до passing: три места, где можно застрять
Шаг 4 сквозного проекта: feature_list.json для платёжного бэкенда
Тормоза ставит harness, а не агент