🤖 AI Dev OS ✓ Готово

Разработка с AI —
под контролем на каждом шаге

Набор протоколов для Claude Code: агент сначала сверяет понимание, находит готовые компоненты, фиксирует план — и только потом пишет код. Каждое решение задокументировано.

⚡ /go-fast 🧭 flow-first 📚 library-first 🗺️ plan-first 🚀 ship-first
Попробовать бесплатно →

AI пишет — но непонятно что и зачем

🤯
Понял по-своему
Агент получил задачу и сразу начал писать код. Понял не так. Переделывать дороже чем сделать заново.
💨
Контекст потерян
Сессия оборвалась — в новой сессии агент не знает что уже сделано и с чего остановились. Объясняй заново.
🕳️
Нет трассируемости
Код задеплоен, но непонятно почему именно так, что обсуждали, какие риски учли. История — нигде.

От задачи до деплоя — 5 шагов под контролем

⚡ /go-fast
🧭 flow-first
📚 library-first
🗺️ plan-first
💻 код
🚀 ship-first

⚡ Протокол 1

/go-fast — одна команда запускает весь цикл

Опишите задачу — агент сам пройдёт все шаги по порядку: сверит понимание, найдёт готовые компоненты, покажет план и дождётся апрува на каждом этапе. Ни один шаг не будет пропущен.

  • Автоматически запускает flow-first → library-first → plan-first
  • Каждый протокол ждёт явного «ок» перед переходом дальше
  • Задача регистрируется в routing.db и лог-папке с первого шага
  • Работает из любой папки проекта
«Раньше писал задачу агенту и молился. Теперь /go-fast — и вижу таблицу понимания. Если что-то не так — ловлю сразу, до кода. Не после.»
Одна команда
→ весь цикл под контролем

🧭 Протокол 2

flow-first — агент показывает понимание до кода

Прежде чем идти в код, агент заполняет таблицу 4×3: что сейчас есть, в чём проблема, что меняем и что получится — по трём уровням (UI / БД / Интеграции). Вы видите понимание агента и апрувите или правите.

  • Таблица Ландшафт / Проблема / Решение / Результат × 3 уровня
  • Агент читает только те файлы которые вы указали — не сканирует всё подряд
  • «не затронут» явно — нет пустых ячеек-догадок
  • Апрув таблицы = агент понял задачу правильно на всех уровнях
«flow-first поймал что агент собирался трогать БД — а я имел в виду только UI. Без него бы узнал об этом уже в git diff.»
🧭
Таблица понимания 4×3
→ апрув до первой строки кода

📚 Протокол 3

library-first — сначала найти готовое, потом писать

Агент сканирует проект и строит таблицу LOC: что уже есть (Библиотека ✅), что нужно писать с нуля (С нуля ⚠️) и сколько строк. Вы видите оценку до начала кода — и можете скорректировать подход.

  • Таблица: что делаем / откуда берём / LOC / тип (ui, backend, infra...)
  • Максимум переиспользования — минимум нового кода
  • LOC-оценка до начала выполнения — нет сюрпризов по объёму
  • Если LOC > 150 — предупреждение и предложение разбить задачу
«Агент нашёл что компонент уже есть под другим именем. Сэкономил 80 строк и час работы. Без library-first написал бы дубль.»
📚
LOC-таблица до кода
→ максимум готового, минимум нового

🗺️ Протокол 4

plan-first — план шагов на апруве перед выполнением

Агент строит таблицу шагов (7–15 строк), показывает риски и out of scope — и ждёт апрува. После «ок» выбираете режим: Автопилот (без остановок), Пошаговый (апрув после каждого шага) или Гибридный (автопилот до конкретного шага).

  • Таблица: шаг / краткая сводка — никакого research в плане
  • Риски и out of scope — явно, не молча
  • Три режима выполнения под ваш уровень доверия к задаче
  • После каждого блока — отчёт с наблюдениями и дальнейшими шагами
«Пошаговый режим для первых задач в новом проекте — видишь каждый шаг и можешь остановить. Потом переходишь на автопилот. Это как права категории A и B.»
🗺️
План шагов + режим работы
→ выполнение без сюрпризов

🚀 Протокол 5

ship-first — задача закрыта только после прода

После выполнения агент не просто говорит «готово». Он пишет отчёт, делает коммит, пушит, запускает smoke-тест на проде, регистрирует результат в routing.db — и только потом спрашивает «закрываем?».

  • report.md + user-note.md — что сделано и что изменилось для пользователя
  • Автоматический деплой через git push → post-receive хук
  • Smoke-тест: curl на конкретный endpoint или UI-чеклист
  • Задача в routing.db помечается done только после прода
«Раньше "сделано" означало "написал код". Теперь сделано — это задеплоено и проверено. Разница ощутима.»
🚀
Отчёт → деплой → smoke-тест
→ задача закрыта на проде

📝 Протоколы 6

note-first и human-first — не теряй инсайты и понимай агента

note-first сохраняет последнее сообщение агента как заметку в лог задачи — одной командой. human-first объясняет последнее сообщение агента простым языком с примерами — когда текст слишком технический.

  • /note-first — важный ответ агента → note-01.md в лог задачи, ссылка в task.md
  • /human-first — объяснение без жаргона, с аналогиями и примерами из жизни
  • Оба работают без аргументов — берут предыдущее сообщение автоматически
  • Заметки остаются в задаче и восстанавливаются в новой сессии
«Агент написал что-то важное про архитектуру. /note-first — и это теперь в задаче. Новая сессия — читаю notes, контекст восстановлен.»
📝
Сохранить инсайт одной командой
→ объяснить проще без потери контекста

🗃️ Система артефактов

Полная история задачи — от описания до деплоя

Каждая задача оставляет полный след: task.md с описанием, артефакты каждого протокола (flow-first, library-first, plan-first), отчёты по блокам, заметки сессий. Всё регистрируется в routing.db и восстанавливается в любой новой сессии.

  • task.md — единый файл задачи со ссылками на все артефакты
  • routing.db — единая БД всех задач: статусы, блоки, артефакты, коммиты
  • report-N.md — что сделано, что важного по ходу, что дальше
  • /go-start восстанавливает контекст зависшей задачи за 30 секунд
«Сессия оборвалась на середине. /go-start → "продолжение" → вставил копипаст — агент нашёл задачу, прочитал последний report и продолжил. Ни шага заново.»
🗃️
task.md + routing.db + reports
→ полная история, восстановима в любой сессии

Для сложных задач — отдельный уровень

🏗️
arch-first
Для задач из 5+ блоков: миграции БД, переписывание модулей, масштабные рефакторинги. Управляет архитектурными решениями на длинной дистанции.
🔍
audit-first
Для аудитов безопасности и поиска дыр перед фиксом. Сканирует по 6 плоскостям, приоритизирует проблемы — и только потом исправляет.

Больше возможностей VSCHK AI


Частые вопросы об AI Dev OS

Протоколы работают из коробки через Claude Code. Установите скиллы в папку .claude/skills/ вашего проекта — и пишите /go-fast с описанием задачи. Никакой дополнительной конфигурации не нужно.
Да. Каждый протокол работает независимо: /flow-first, /library-first, /plan-first, /note-first, /human-first — можно вызывать в любой момент. Цепочка /go-fast просто запускает их по порядку автоматически.
Запустите /go-start → выберите «продолжение» → вставьте копипаст из оборванного терминала. Агент найдёт задачу в routing.db, прочитает последний report.md и продолжит с места остановки. Контекст восстанавливается за 30 секунд.
Все артефакты — в vschk-platform/tasks/log/{дата}-{slug}/. Там task.md со ссылками на все файлы, артефакты протоколов (flow-first-1.1.md, library-first-1.1.md и т.д.) и отчёты report-N.md. Единая БД routing.db индексирует всё.
Для мелких правок (одна строка, один параметр) — протоколы не нужны, Claude справится напрямую. Полная цепочка /go-fast рассчитана на задачи от 20 строк кода. Граница: если задача требует понимания контекста и может привести к регрессии — запускайте /go-fast.
Начать бесплатно

Запустите AI Dev OS на следующей задаче

Установите скиллы, напишите /go-fast — и первая задача пройдёт по всей цепочке протоколов.

Начать бесплатно →

Регистрация без карты. 5 дней полного доступа.