Дебаты Astra × Fable01-operating-model

1. Целевая модель разработки

Статус: универсальная концепция. Состояние проверки итоговой версии указано в реестре результата.

Что мы строим

Результат перехода — воспроизводимый процесс, в котором модель получает намерение, находит достаточный контекст, выполняет разрешённые ранбуки, предоставляет проверяемый кандидат изменения и доводит его до результата. Документация — память и контракт этого процесса. Она не заменяет работающую среду, тесты, контроль полномочий и приёмку.

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

Это универсальная концепция для существующего Django-проекта. Ни один пример заказов, скидок, PostgreSQL, Celery или DRF ниже не является утверждением о вашем живом репозитории. Состав стека выясняется при применении гайда.

Семь сущностей, которые нельзя путать

Сущность Что хранит Кто/что служит основанием
Намерение, INT Нужный результат, мотив, ограничения Сообщение уполномоченного человека
Решение, DEC Выбранный вариант и границы выбора Аутентифицированный ответ на конкретный пакет решения
Норма, BR/POL Требуемое бизнес-поведение или правило процесса Действующее решение либо утверждённая политика
Наблюдение, OBS Что обнаружено в определённых условиях Код, эксперимент, тест, история, разрешённые наблюдения
Проекция, PROJ Механически извлечённая структура Конкретные версии анализатора, исходников и конфигурации
Доказательство, EV Результат конкретной проверки Доверенный исполнитель и идентифицированные входы
Полномочие, GRANT Разрешённые действия и условия их выполнения Решение о полномочиях и доверенная система исполнения

Ранбук RB связывает эти сущности в процедуру. Контракт изменения CHG задаёт, какое поведение должно измениться и по каким критериям результат принимается.

«Тест проходит», «так написано в старом коде», «так хочет бизнес» и «это разрешено выкладывать в production» — четыре разных утверждения. Совпадение первых двух не разрешает подменять ими третье или четвёртое.

Статусы по разным осям

Не используйте один флаг verified для всего документа. Минимальная модель:

  • жизненный цикл записи: draft, active, retired;
  • нормативный статус правила: proposed, accepted, superseded;
  • основание знания: extracted, observed, inferred, unknown;
  • актуальность к снимку: current, suspect, stale, unknown;
  • наличие противоречия: none, open, resolved;
  • полномочие: proposed, active, expired, revoked;
  • результат проверки: passed, failed, blocked, not_run, not_applicable.

Диагноз flaky хранится отдельно от результата конкретной попытки: нестабильная проверка может иметь и passed, и failed в истории. Приёмка записывает accept/reject/blocked; устаревшее evidence даёт blocked с причиной stale_evidence, а не новую разновидность успешной приёмки.

Изменение кода делает зависимое наблюдение кандидатом на перепроверку, но не отменяет бизнес-норму. Новая норма может быть утверждена раньше её реализации: такая запись честно хранит implementation: pending. Пропущенный тест не равен пройденному. not_applicable требует основания от доверенного правила отбора, а не свободной отписки автора PR.

Решение человека один раз, исполнение многократно

Начальный пакет решения содержит: цель, точные варианты, последствия, рекомендацию, существенные неизвестные, версию рассматриваемых материалов, какие действия разрешаются и чего это решение не определяет.

Если человек уже ясно сказал «новая скидка действует только для будущих заказов», это фиксируется как решение о границе поведения. Повторно спрашивать то же самое не нужно. Если неизвестно, что считать будущим заказом (создание, оплата или подтверждение), модель исследует варианты и задаёт вопрос только об этой разнице.

Нужно различать два допуска:

  1. Право действовать: например, доверенная политика разрешает публикацию и merge определённого класса изменений после проверок.
  2. Правильность результата: конкретное изменение удовлетворяет контракту.

Действующий GRANT не делает ошибочную реализацию приемлемой. Одобрение бизнес-смысла само по себе не расширяет технические права инструмента.

Решение сохраняется с автором, временем, ID и хешем пакета, выбранным вариантом, областью действия и заменяемыми решениями. Его нельзя получить простым созданием моделью файла approved: true. Клиент, через который человек отвечает, фиксирует реальное событие ответа; исполнитель проверяет его происхождение и текущую применимость. В Git допустима читаемая проекция такого события, но она не является самостоятельным источником полномочий.

Граница доверия

Для начала достаточно небольшого доверенного сервиса/CI-адаптера, отдельной учётной записи приёмки и хранилища событий; отдельная большая платформа не обязательна. Принцип обязателен: автор изменения не может тем же PR переписать действующие правила собственной приёмки или выдать себе доступ.

Проверка использует утверждённую версию политики из доверенного источника. Если PR меняет эту политику, новая версия является кандидатом и проходит отдельный ранбук изменения процесса. До её принятия действует прежняя версия. Публикация новой политики в основной ветке и её активация — разные события. Активация требует права по прежней политике и фиксирует точную версию. Смешанный PR с политикой и бизнес-кодом разделяется, если бизнес-части нужно разрешение, которое ещё только предлагается этим же PR. Привилегированные credentials не передаются процессу, который исполняет произвольный код проверяемого PR.

Файлы AGENTS.md и CLAUDE.md объясняют процедуру и навигацию. Это не техническая блокировка действий. Документация Claude Code прямо различает контекст и принудительные ограничения. См. проверенные источники.

Полномочия без постоянного участия человека

GRANT фиксирует проект, роль исполнителя, разрешённые действия, класс задач, область и исключения, риск, требуемые проверки, применимые версии ранбуков и политики, срок/условия окончания, отзыв и поведение текущих запусков.

Для повторяемой механики возможен ограниченный допуск на класс работ; для отдельного чувствительного действия — на точный кандидат. Нельзя определять низкий риск только количеством строк или маской каталога: одна строка проверки прав может менять доступ ко всем данным.

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

Адаптер определяет точку допуска действия и упорядочивает её с отзывом: отзыв, принятый раньше этой точки, блокирует действие; более поздний отзыв не отменяет уже допущенный внешний эффект задним числом. Для этого нужна сериализация/проверяемый протокол, а не только сравнение SHA веток. Если платформа оставляет окно отзыва, его границы явно входят в принятую политику.

Что считать достаточной автономностью

Автономность задаётся по паре «область × класс действий»: например, добавление проверок в известном домене уже допускается до merge, а изменение схемы данных пока требует решения перед выпуском. Это точнее одного глобального уровня зрелости всего репозитория.

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

В результате человек получает подготовленное решение, а не очередь команд «нажмите за меня». Но неоднозначный бизнес-смысл, конфликт интересов и изменение допустимого риска остаются поводами вернуть его в процесс.