Создание законченного программного проекта с помощью современных AI-агентов — будь то Claude Code, Cursor или Codex — до сих пор часто упирается в фундаментальную проблему «вайбкодинга»: модель увлекается генерацией кода, теряет из контекста начальные требования заказчика уже к третьей итерации и выдаёт полурабочий прототип с забытыми крайними случаями. Разработчику приходится вручную выполнять роль тимлида, тестировщика и менеджера задач: дробить архитектуру на части, писать длинные промпты и следить за каждым диффом.
Репозиторий nick-vels/skills предлагает принципиально другой подход с помощью навыка Autopilot. Это законченный инженерный фреймворк, превращающий формулировку идеи на естественном языке в полностью собранный, протестированный и зафиксированный в Git проект без необходимости ручного контроля над каждой строкой кода.
Главный принцип: порядок разработки — это и есть продукт
В отличие от классических агентных надстроек, где модель сразу начинает редактировать файлы, Autopilot откладывает написание кода до предпоследней фазы. Логика проста: ошибки в коде исправить легко, а вот потерю изначального замысла или архитектурную кривизну на этапе сборки исправить почти невозможно.
Фреймворк опирается на две аксиомы:
- Бриф — это неизменяемый контракт, а не просто ориентир: слова пользователя трансформируются в нумерованный манифест требований (
manifest.md). Ни одно требование не может тихо исчезнуть в процессе работы. - Бриф — это силуэт: пользователь обычно описывает только идеальный пользовательский сценарий (happy path). Продумывание пустых состояний, ошибок сети, лимитов и крайних случаев — это прямая обязанность фреймворка, глубина которой регулируется флагами запуска.
Четыре режима работы и шкала глубины
Autopilot позволяет точно настроить степень участия человека в процессе разработки. Режим и глубина проработки задаются прямо в первой команде вызова:
| Режим | Команда запуска | Степень контроля человека | Когда применять |
|---|---|---|---|
| Полный автомат (full) | /autopilot full <задача> |
Ноль вопросов. Все архитектурные решения принимаются автономно, а в конце формируется детальный отчёт о сделанном выборе. | Быстрое прототипирование, скрипты автоматизации, типовые микросервисы. |
| Полуавтомат (semi) | /autopilot <задача> (по умолчанию) |
Вопросы задаются только на реальных архитектурных развилках (1–2 коротких раунда с готовыми вариантами ответа). | Большинство реальных проектов и продуктовых фичей. |
| Интервью (interview) | /autopilot interview <задача> |
Глубокий допрос: агент вскрывает все нестыковки, краевые случаи и потенциальные риски до начала проектирования. | Сложные сервисы со специфической бизнес-логикой и интеграциями. |
| Ручной (manual) | /autopilot manual <задача> |
Режим интервью плюс обязательное формальное согласование человеком спецификации и списка задач. | Ответственные модули, где требуется полный контроль над архитектурными границами. |
Дополнительно к режимам доступен модификатор глубины: strict заставляет агента строго держаться сказанного в брифе без додумывания функционала, а deep запускает глубокую проработку граничных условий, структур данных и валидации.
Архитектурный конвейер: от манифеста до слепой приёмки
Жизненный цикл сборки в Autopilot разбит на строго изолированные фазы с формальными шлюзами перехода (gates):
- Фаза 0 (Preflight): определение режима и глубины, инициализация локального Git-репозитория и автоматический запуск интерактивного веб-дашборда.
- Фаза 1 (Manifest): парсинг брифа (из чата или переданного файла
brief.md) и создание нумерованного манифеста требований, с которым сверяются все последующие шаги. - Фаза 2 (Briefing): раунд уточняющих вопросов по выявленным развилкам с нумерованными вариантами ответа.
- Фаза 3 (Spec): составление подробной спецификации (
spec.md) и контрактов границ (interfaces.md). - Фаза 4 (Plan): декомпозиция архитектуры на атомарные тикеты задач (
tickets/NN-*.md) и фиксация плана коммитом в Git. - Фаза 5 (Build): фаза непосредственного написания кода через пул независимых субагентов.
- Фаза 6 (Review): пошаговый код-ревью каждого тикета и итоговый аудит всей ветки на соответствие архитектурным стандартам.
- Фаза 8 (Final & Acceptance): слепая приёмка тремя независимыми субагентами, не имеющими доступа к спецификации.
Изоляция контекста: почему сессии не ломаются
Ключевая инженерная находка Autopilot — строгое соблюдение правила чистоты контекста (Rule 5: You dispatch; you do not build):
Один тикет — один субагент — один чистый контекст. Основной координирующий агент никогда не пишет код прикладных файлов проекта и никогда не читает их дифф. Чтение диффа во 2-м тикете неизбежно засоряет контекст к 8-му тикету, вызывая забывание инструкций.
Координирующий агент имеет доступ только к файлам .autopilot/**, памяти проекта, .gitignore и Git-командам верхнего уровня (status, commit, --stat). Для реализации каждого тикета поднимается изолированный исполнитель, которому передаются пути к файлам и точные заголовки спецификации. После выполнения задачи и прогона тестов контекст исполнителя уничтожается.
Слепая приёмка (Blind Acceptance)
В конце сборки запускается тройка независимых агентов, не общающихся между собой:
- Слепой тестировщик (Blind Checker): получает только оригинальный бриф пользователя и доступ к репозиторию. Ему категорически запрещено передавать спецификацию и список тикетов. Это гарантирует, что проект проверяется на соответствие реальной задаче человека, а не внутренним компромиссам, возникшим при составлении спецификации.
- ADR-агент: анализирует спецификацию и фиксирует архитектурные решения — почему были выбраны именно такие структуры данных и библиотеки.
- Агент долговременной памяти: на основе подтверждённых слепым тестом команд формирует практический гайд по запуску и сопровождению проекта для будущих сессий.
Локальный живой дашборд
При старте работы Autopilot автоматически открывает в браузере локальную веб-страницу дашборда. Она работает полностью автономно (один HTML-файл, не требующий внешнего интернета и сторонних серверов):
- Цветовая индикация состояния: синяя шапка — идёт активная фаза сборки; оранжевая — агент ожидает ответа пользователя; зелёная — сборка успешно завершена и сдана.
- Прогресс задач по волнам: каждая задача отображается динамической цветной полосой с реальными таймерами выполнения.
- Трекинг требований: все пункты пользовательского ТЗ отображаются в исходном виде с отметками о прохождении приёмки.
Установка и быстрый старт
Autopilot распространяется как открытый скил и подключается к любой поддерживаемой среде кодинга одной командой через стандартный менеджер навыков:
# Установка навыка для Claude Code, Cursor или Codex
npx skills add nick-vels/skills --skill autopilot -g -yПосле установки перезапустите сессию агента и запустите задачу:
# Запуск сборки проекта в полуавтоматическом режиме
/autopilot Хочу телеграм-бота для приёма заявок на ремонт техники с сохранением в SQLite и веб-интерфейсом
# Запуск по подробному файлу требований
/autopilot deep brief.mdИтоги
Autopilot наглядно демонстрирует переход от хаотичного «вайбкодинга» к дисциплинированной программной инженерии на базе AI-агентов. Жёсткое разделение ролей, изоляция контекста на уровне тикетов, неизменяемый манифест и слепая приёмка превращают кодинг-агентов из непредсказуемых генераторов сниппетов в надёжный конвейер разработки под ключ.
