К содержимому
Разработка с ИИ

Держать агента на поводке

ИИ-инструменты — самый быстрый способ построить продукт и самый быстрый способ накопить код, которого никто не понимает. Разница целиком в правилах, заданных до того, как агент начал.

Что входит в категорию

Правила, разборы и аудит перед переписыванием

Написано из опыта: что эти инструменты делают хорошо, а что — уверенно и плохо.

Инструкции проекта

Постоянные правила, которые ваши сессии Claude Code читают каждый раз: что это за проект, что нельзя менять никогда и что здесь считается готовым.

Процедура независимого разбора

Вторая модель проверяет работу первой, с явным контрактом на выход, чтобы она вернула находки, а не пересказ собственных действий.

Правила ИИ-разработки

Кому можно запускать агента и по какому коду, какие изменения требуют живого проверяющего и где граница между помощью и самостоятельностью.

Защита от разрушительных переписываний

Конкретные ограничители, которые не дают агенту «прибраться» в работающей подсистеме, которую он не понял.

Готовность репозитория к ИИ

Что делает код пригодным для агента: структура, имена, тесты и файлы контекста, из-за отсутствия которых он начинает угадывать.

Аудит перед ИИ-рефакторингом

Зафиксировать, что система делает сегодня, чтобы потом можно было доказать, что рефакторинг не изменил поведение тихо.

Как идёт работа с правилами ИИ

  1. Сначала зафиксировать исходное состояние

    Что система делает сейчас — записано. Без этого фраза «ИИ-рефакторинг что-то сломал» недоказуема и неисправима.

  2. Правила под ваш проект

    Общие рекомендации по ИИ перестают выполняться к третьей сессии. Правила, называющие ваши настоящие ограничения, выполняются.

  3. Проверяющий, который не писал этот код

    Самопроверка моделью, сделавшей работу, не находит почти ничего. Независимость — это и есть весь механизм.

  4. Доказательства важнее уверенности

    Агенты утверждают. Процедура требует показать файл и строку, и именно там тихо умирает большая часть уверенных заявлений.

Когда это важно

Менее срочно, если

Ни один ИИ-инструмент не трогает боевой код

Каждое изменение уже проходит живой разбор

Код настолько мал, что читается за день

Срочно, если

Большая часть продукта построена с помощью ИИ

Команда выкладывает написанное агентом без разбора

Непонятно, какие части человек действительно проверил

Агента вот-вот направят на старую подсистему

Выберите категорию под своё беспокойство

Опишите ситуацию своими словами и посмотрите процедуру — и её стоимость — до того, как что-то потратите.