Дебаты Astra × Fableresponse

Ниже моё независимое предложение для первого раунда. Я не использовал инструменты и не читал файлы, как и требовалось.

Модель знаний и документация

Базовый принцип. Система строится как разделение по источнику истины. Каждая единица знания имеет ровно один тип, и тип определяет, кто может её создать, что её подтверждает и когда она устаревает. Смешивать типы в одном файле запрещено. Типов шесть:

  1. Проекция из кода (PROJ). Генерируется инструментами из репозитория: карта приложений, моделей, URL, сигналов, задач, миграций, зависимостей. Не редактируется руками. Привязана к SHA коммита и пересобирается автоматически.
  2. Наблюдаемое поведение (BEH). Описание того, что система фактически делает, с указанием источника: код, тест, лог, воспроизведённый прогон. Каждое утверждение имеет уровень уверенности и ссылку на доказательство. Пишется моделью, подтверждается проверкой.
  3. Намерение человека (INT). Что человек хочет и почему. Записывается в терминах цели и ограничений, не в терминах решений по коду. Только человек является автором, модель лишь фиксирует и переспрашивает.
  4. Решение (DEC). Выбор человека между вариантами, с контекстом, отвергнутыми альтернативами и следствиями. Неизменяемое после принятия. Новое решение может заменить старое, но не редактировать его.
  5. Утверждённое правило (RULE). Норма, обязательная для всех будущих работ: гайдлайн, инвариант, запрет. Правило всегда ссылается на решение, которым оно введено. Правило имеет версию.
  6. Полномочие (GRANT). Разрешение на автономное выполнение определённого класса действий при определённых условиях. Выводится из решения, имеет область, срок и условия отзыва. Подробно ниже.

Отдельно стоят доказательства (EV): результаты прогонов тестов, линтеров, диффов, ручных проверок. Они не являются знанием о системе, а являются знанием о конкретной проверке в конкретный момент. И ранбуки (RB): исполняемые процедуры, которые связывают всё перечисленное.

Дерево документации. Предлагаю каталог docs/ в корне репозитория, не отдельный репозиторий: знания должны версионироваться вместе с кодом, чтобы PR менял код и документацию атомарно.

docs/
  INDEX.md                     корневой индекс, единая точка входа
  manifest.yaml                машинный реестр всех документов и их метаданных
  00-meta/
    conventions.md             правила идентификаторов, ссылок, фронтматтера
    glossary.md                термины домена и проекта, единый словарь
    trust-model.md             какие типы знаний кому доверяют
  10-projections/              PROJ, генерируется
    apps.md                    список Django-приложений и их назначение
    models/<app>.md            модели, поля, связи, индексы
    urls.md                    маршруты и обработчики
    signals.md                 сигналы, receivers
    tasks.md                   фоновые задачи, расписания
    migrations.md              состояние миграций по приложениям
    deps.md                    зависимости и версии
    entrypoints.md             management-команды, cron, webhook'и
  20-behavior/                 BEH
    domains/<domain>/          по бизнес-доменам, не по приложениям
      overview.md
      flows/<flow>.md          сквозные сценарии
      rules/<rule>.md          бизнес-правила, инварианты
      states/<entity>.md       жизненные циклы сущностей
    architecture/
      layers.md
      cycles/<cycle>.md        циклы запроса, задачи, миграции, деплоя
      algorithms/<name>.md
      quirks.md                известные особенности и обходы
  30-intents/                  INT
    <yyyy>/<id>-<slug>.md
  40-decisions/                DEC
    <id>-<slug>.md
  50-rules/                    RULE
    coding.md
    django.md
    data.md
    security.md
    testing.md
    review.md
  60-grants/                   GRANT
    <id>-<slug>.md
    registry.yaml
  70-runbooks/                 RB
    _template.md
    <id>-<slug>.md
  80-evidence/                 EV, преимущественно машинные
    <sha>/<run-id>.json
    index.md                   агрегат, генерируется
  90-tasks/                    рабочие задачи, контекстные пакеты
    <task-id>/
      task.md
      context.md               собранный минимальный контекст
      log.md                   журнал выполнения ранбука

Идентификаторы. Каждый документ имеет уникальный идентификатор вида TYPE-NNNN, где TYPE это PROJ, BEH, INT, DEC, RULE, GRANT, RB, EV, TASK. Номер выдаётся монотонно из manifest.yaml, никогда не переиспользуется. Имя файла содержит идентификатор и слаг, но истина только в идентификаторе: переименование файла не ломает ссылки, потому что ссылки идут по идентификатору, а резолвятся через манифест.

Фронтматтер. Обязателен для всех документов, кроме корневого индекса:

id: BEH-0042
type: behavior
title: Расчёт скидки при оформлении заказа
status: draft | verified | disputed | superseded
domain: orders
sources:
  - code: apps/orders/services/pricing.py#L40-L118
    sha: 3f2a9c1
  - test: tests/orders/test_pricing.py::test_bulk_discount
confidence: high | medium | low
verified_by: EV-0311
supersedes: null
depends_on: [BEH-0017, RULE-0003]
stale_when:
  - path_changed: apps/orders/services/pricing.py
  - path_changed: apps/orders/models.py
last_reviewed: 2026-09-08

Поле stale_when ключевое: инструмент при каждом коммите сравнивает изменённые пути с этими правилами и переводит документ в disputed автоматически. Документ в disputed не может использоваться как основание для автономного действия.

Ссылки. Внутри Markdown ссылки пишутся как [[BEH-0042]] или [[BEH-0042#section]]. Линтер проверяет, что каждый идентификатор существует, что нет ссылок на superseded, и что каждый документ типа BEH, DEC, RULE, GRANT имеет хотя бы одну входящую ссылку из индекса. Проекции ссылаются на код по пути и SHA, а не по номерам строк как единственному ключу, поскольку строки плывут.

Индексы. Три уровня. Корневой INDEX.md ведёт к индексам разделов и содержит карту доменов. Индексы разделов генерируются из манифеста и содержат таблицу: идентификатор, заголовок, статус, уверенность, дата проверки. Доменные обзоры пишутся вручную и являются единственным местом с нарративом. Правило: если документ не достижим из корня за три перехода, линтер выдаёт предупреждение.

Минимальный достаточный контекст для задачи. Это самое важное для автономности, потому что модель не должна читать все docs/ на каждую задачу. Процедура сборки контекстного пакета:

  1. Задача получает идентификатор TASK-NNNN и файл task.md с целью, ссылкой на намерение и оценкой класса изменения.
  2. Инструмент по описанию задачи и по затрагиваемым путям строит граф: от путей к проекциям, от проекций к документам BEH, чьи sources пересекаются, далее по depends_on на одну степень.
  3. Добавляются все RULE, соответствующие классу изменения, и все GRANT, которые могут покрыть действия.
  4. Добавляются ранбук и последние доказательства для затронутых путей.
  5. Результат сохраняется в context.md как список идентификаторов с обоснованием включения и общим объёмом. Установлен верхний бюджет, скажем в токенах, и при превышении инструмент сначала выбрасывает документы с confidence: low, затем транзитивные зависимости.
  6. Пакет фиксируется в задаче. Если в ходе работы модель запросила документ вне пакета, это записывается в журнал: такие запросы являются сигналом для улучшения графа связей.

Отдельно поддерживается запрос «что ещё я мог не увидеть»: инструмент возвращает список документов со статусом disputed в затронутых доменах. Модель обязана их перечислить в PR.

Подробное документирование бизнес-логики. Единица описания это не модуль, а бизнес-правило и сквозной поток. Для каждого домена заполняются четыре вещи:

  • Потоки. Последовательность шагов от триггера до наблюдаемого результата, с указанием, где шаг реализован. Ветвления описываются явно. Для каждого шага пишется, что проверено, а что предположено.
  • Правила. Инварианты и условия в форме «если X, то Y, иначе Z», с примером входа и выхода. Каждое правило ссылается на код и, если существует, на тест. Правило без теста помечается как кандидат в характеризационный тест.
  • Состояния. Жизненный цикл сущностей: статусы, переходы, кто инициирует, что запрещено.
  • Открытые вопросы. Список мест, где код допускает несколько прочтений или где поведение выглядит случайным. Каждый вопрос адресован человеку и превращается либо в решение, либо в подтверждение поведения.

Извлечение бизнес-логики и архитектуры: процедура с неопределённостью. Извлечение идёт слоями, от механического к интерпретирующему:

  1. Механический слой. Генерация проекций из кода средствами Django и статического анализа. Здесь неопределённости нет, но есть неполнота: динамические импорты, условные URL, сигналы, подключаемые в неочевидных местах. Каждая проекция содержит раздел «известные слепые зоны».
  2. Структурный слой. Модель по проекциям определяет кандидаты в домены, границы между ними и точки входа. Результат это гипотезы с уверенностью. Человек подтверждает или правит границы доменов. Это первая точка решения, потому что вся дальнейшая навигация зависит от доменов.
  3. Поведенческий слой. Для каждого домена модель читает код точек входа и трассирует потоки. Каждое утверждение получает одну из меток: observed при наличии теста или воспроизведённого прогона, read при выводе из чтения кода, inferred при выводе из косвенных признаков, assumed при отсутствии оснований. Утверждения assumed запрещено помещать в верифицированные документы.
  4. Слой циклов и практик. Описываются циклы: обработка запроса от middleware до ответа, жизненный цикл фоновой задачи, цикл миграции данных, цикл деплоя, цикл релиза. Для каждого цикла фиксируются точки, где проект отклоняется от стандартной для Django практики, и почему, если причина восстанавливаема из истории коммитов или комментариев. Практики, которые повторяются в коде трижды и более, кандидаты в правила. Практики, которые встречаются один раз и противоречат остальным, кандидаты в quirks.md.
  5. Слой проверки. Каждый документ BEH проходит независимую проверку другим экземпляром модели с отдельным контекстом, который получает только код и документ и должен найти утверждения, не подтверждаемые кодом. Утверждения с меткой read, которые проверяющий не смог подтвердить, понижаются до inferred. Затем выборка утверждений превращается в характеризационные тесты: если тест проходит, утверждение поднимается до observed.

Уверенность документа равна уверенности его самого слабого утверждения, используемого в потоке. Это грубо, но заставляет разбивать документы.

Как решение человека становится полномочием. Человек делится намерением. Модель формирует запрос на решение: варианты, последствия, что изменится в правилах. Человек выбирает. Из решения модель выводит документ GRANT:

id: GRANT-0007
derived_from: DEC-0019
scope:
  action_class: schema_change_additive
  paths: ["apps/orders/**"]
  excludes: ["apps/orders/migrations/00*_squash*"]
conditions:
  - all_tests_pass: true
  - no_disputed_docs_in_domain: true
  - runbook: RB-0004
  - max_diff_lines: 400
valid:
  from_version: 1
  until: 2027-03-01
  until_event: "изменение RULE-0011"
  max_uses: null
revocable_by: [owner]
status: active

Ключевые свойства: полномочие покрывает класс действий, а не любые действия. Оно проверяется инструментом перед каждым автономным шагом, а не только в момент выдачи. Оно версионируется: изменение условий даёт новую версию, старая помечается superseded, а задачи в процессе завершаются по старой версии или останавливаются в зависимости от поля on_supersede. Срок обязателен. Событийный отзыв позволяет привязать полномочие к правилам, от которых оно зависит. Всё, что не покрыто активным полномочием, требует явного решения, и это единственный путь вернуть человека в цикл.

Исполнение: ранбуки, изменения, приёмка, тесты

Ранбуки: выделение. Кандидаты в ранбуки берутся из трёх источников: история PR за выбранный период, классифицированная по типам изменений; список типовых задач от команды; сама модель знаний, где каждый цикл порождает хотя бы один ранбук. Типовой стартовый набор для Django-проекта: добавить поле в модель с миграцией; добавить эндпоинт; изменить бизнес-правило с тестами; добавить фоновую задачу; миграция данных; обновить зависимость; исправить баг по репорту; рефакторинг без изменения поведения; обновить документацию после изменения; провести аудит домена.

Контракт ранбука. Ранбук это машиночитаемый документ с обязательными разделами:

id: RB-0004
title: Аддитивное изменение схемы
version: 3
applies_to: [schema_change_additive]
requires_grant: true
inputs:
  - task: TASK-*
  - context_pack: обязателен
  - decision_or_grant: DEC-* | GRANT-*
preconditions:
  - branch_clean: true
  - baseline_evidence: EV-* не старше 24ч для затронутых путей
steps:
  - id: s1
    do: изменить модель
    check: makemigrations --check --dry-run показывает ровно одну миграцию
    on_fail: stop, report
  - id: s2
    do: сгенерировать миграцию
    check: миграция обратима, нет RunPython без reverse
    on_fail: retry_once, then escalate
  - id: s3
    do: обновить BEH и PROJ
    check: doc-lint проходит
  - id: s4
    do: написать или обновить тесты
    check: новые тесты падают до изменения, проходят после
  - id: s5
    do: прогнать полный набор проверок
    check: EV сформирован
outputs:
  - commit(s)
  - PR draft
  - EV-*
  - изменённые документы
postconditions:
  - все stale_when не сработали, либо документы обновлены
resume:
  state_file: 90-tasks/<id>/log.md
  idempotent_steps: [s1, s3, s4, s5]
escalation:
  to: human
  with: последнее состояние, диф, список нарушенных проверок

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

Ранбуки версионируются. Задача фиксирует версию ранбука при старте. Изменение ранбука само является изменением через ранбук «обновить ранбук», с обязательным тестовым прогоном на учебной задаче.

Создание коммитов и PR. Отделяется от приёмки полностью. Правила:

  • Один коммит соответствует одному шагу ранбука или одной логической единице. Сообщение коммита содержит идентификатор задачи, идентификатор ранбука и шага, список затронутых документов.
  • Коммиты с кодом и коммиты с документацией допускаются раздельно, но PR не может содержать код без обновления документов, если сработал stale_when.
  • Инструмент до коммита проверяет: линтер документов, соответствие полномочию, размер диффа, отсутствие изменений вне области полномочия.
  • PR создаётся в состоянии черновика и содержит генерируемое описание: намерение, решение, полномочие, ранбук, список утверждений о поведении, которые изменились, список тестов, добавленных или изменённых, список disputed документов в доменах, идентификаторы доказательств.
  • PR-описание содержит раздел «что я не проверил», заполняемый обязательно. Пустой раздел означает, что модель утверждает полную проверку, и это будет проверено на приёмке.

Приёмка PR. Три независимых слоя, ни один не может видеть выводы другого до формирования собственного заключения:

  1. Машинные проверки. Тесты, линтеры, миграционные проверки, проверка документации, проверка полномочия. Результат это EV с привязкой к SHA головы PR.
  2. Независимая проверка моделью. Отдельный экземпляр с чистым контекстом получает диф, контекстный пакет и правила. Не получает журнал выполнения и описание PR. Задачи проверяющего: найти нарушения правил, найти изменения поведения, не отражённые в документах, найти утверждения в документах, не подтверждаемые дифом, найти отсутствующие тесты для изменённых правил. Только после формирования заключения ему показывают описание PR для сверки с разделом «что я не проверил».
  3. Решение человека. Требуется, если изменение вышло за полномочие, если проверяющие разошлись, если затронуты домены с disputed документами, или если ранбук помечен как требующий приёмки человеком. В остальных случаях автоматическое слияние допустимо, если это разрешено правилом слияния и полномочием.

Привязка доказательств и устаревание. Каждое доказательство EV содержит SHA коммита, на котором получено, идентификаторы задачи и ранбука, набор проверок, результат, хеши окружения. При появлении нового коммита в PR все доказательства предыдущей головы помечаются stale. Слияние возможно только с полным набором свежих доказательств на текущей голове. Доказательства не удаляются: они остаются в истории для аудита. Проверка независимости фиксируется: в EV указано, какой контекст получал проверяющий.

Стратегия тестирования старого проекта. Полное покрытие недостижимо, и его не нужно обещать. Стратегия:

  • Инвентаризация. Проекция существующих тестов: что покрыто, что запускается, что пропускается, сколько времени идёт. Отдельно выделяются тесты, которые падают на чистом чекауте: они переводятся в карантин с фиксацией причины.
  • Характеризационные тесты. Для каждого верифицированного бизнес-правила без теста создаётся тест, фиксирующий текущее поведение, даже если оно выглядит неправильным. Название теста ссылается на идентификатор BEH. Неправильное поведение помечается открытым вопросом, а не исправляется.
  • Приоритизация по риску. Домены ранжируются по частоте изменений в истории, по числу инцидентов, по объёму денежных или юридически значимых операций. Характеризация идёт сверху списка. Порог перехода к автономным изменениям в домене: наличие характеризационных тестов для всех правил с confidence: high в этом домене.
  • Слои. Юнит-тесты сервисов и правил; интеграционные тесты потоков через тестовый клиент; тесты миграций на копии схемы; контрактные тесты внешних интеграций с записанными ответами; снимковые тесты для ответов API, где структура важна.
  • Скорость. Полный набор запускается на приёмке. На шагах ранбука запускается подмножество, вычисляемое по затронутым путям через проекции. Это решение спорное, вынес его ниже.
  • Тестовые данные. Фабрики или фикстуры по доменам с документацией в BEH, какие сценарии данных существуют.

Rollout и rollback процесса. Процесс вводится не для всего репозитория сразу, а по доменам и по классам действий. Каждый домен имеет уровень зрелости:

  • Уровень 0: только проекции. Модель ничего не меняет.
  • Уровень 1: документы BEH верифицированы, есть ранбуки, модель готовит PR, человек принимает каждый.
  • Уровень 2: есть характеризационные тесты и полномочия на узкие классы действий, автономное слияние для них.
  • Уровень 3: широкие полномочия, человек участвует только по эскалации и по новым намерениям.

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

Миграция, проверка достаточности, сценарий, риски

Последовательность миграции.

  1. Инвентаризация. Вход: репозиторий, доступ к истории, CI, окружения. Работа модели: сбор проекций, инвентаризация тестов, статистика изменений по путям, список внешних интеграций, версии зависимостей. Точка решения: нет. Выход: 10-projections/, отчёт о слепых зонах, отчёт о состоянии тестов. Критерий перехода: проекции собираются воспроизводимо, известны падающие тесты.
  2. Границы доменов и словарь. Вход: проекции, интервью с командой в форме коротких ответов. Работа модели: гипотезы доменов, глоссарий, карта потоков. Точка решения: человек утверждает домены и словарь. Выход: DEC о доменах, glossary.md, доменные обзоры в статусе draft. Критерий: каждое приложение отнесено к домену, нет терминов с двумя значениями.
  3. Пилотный домен. Выбирается домен со средним риском и высокой частотой изменений. Работа модели: полное извлечение BEH с уверенностью, независимая проверка, характеризационные тесты, первые ранбуки. Точка решения: человек разбирает открытые вопросы, каждый превращается в DEC или в подтверждение. Выход: домен на уровне 1. Критерий: все BEH домена в статусе verified или disputed с назначенным вопросом, ни одного assumed.
  4. Правила и первые полномочия. Вход: результаты пилота, история PR. Работа модели: извлечение практик в правила, черновики полномочий для двух-трёх узких классов действий. Точка решения: человек утверждает правила и полномочия. Выход: 50-rules/, 60-grants/, ранбуки версии 1. Критерий: три задачи из реального бэклога пройдены по ранбукам с приёмкой человеком без исправлений вне процесса.
  5. Автономия в пилоте. Домен переводится на уровень 2. Точка решения: человек утверждает переход. Критерий: за наблюдательный период не было понижения уровня.
  6. Масштабирование по доменам. Повторение шагов три-пять по списку приоритетов. Параллельно команда работает по новому процессу и в остальных доменах на уровне 1.
  7. Передача поддержки процесса. Ранбуки для изменения ранбуков, правил, полномочий. Модель ведёт процесс, человек принимает решения. Критерий: изменение процесса прошло через сам процесс.

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

Проверка достаточности. Наличие Markdown ничего не гарантирует. Достаточность проверяется поведением системы, а не объёмом:

  • Тест закрытой книги. Свежий экземпляр модели получает только контекстный пакет и задачу из реального прошлого PR. Результат сравнивается с реальным PR по набору критериев: те же файлы, те же правила, те же тесты. Расхождения дают либо дефект знаний, либо дефект старого PR.
  • Тест на ложные утверждения. В документы намеренно вносится ложное утверждение, независимая проверка должна его найти. Это проверяет, что проверка работает, а не штампует.
  • Тест на слепые зоны. Случайные пути из репозитория проверяются на достижимость из документации. Недостижимые пути с историей изменений это дыра.
  • Метрики процесса. Доля PR, вернувшихся с приёмки; доля документов в disputed старше недели; доля задач, запросивших документы вне контекстного пакета; число эскалаций на задачу. Метрики сами по себе не цель, они триггеры разбора.
  • Явные границы. Корневой индекс содержит раздел «чего эта документация не утверждает», обновляемый при каждом аудите. Обещания полноты запрещены как класс формулировок в документах и проверяются линтером по словарю запрещённых фраз.

Сквозной условный сценарий. Условный проект, условный домен «заказы». Человек пишет: «Хочу, чтобы для корпоративных клиентов скидка применялась к сумме без учёта доставки, сейчас считается с доставкой, это ошибка».

  1. Модель создаёт INT-0031 с целью и ограничением, переспрашивает одно: распространяется ли изменение на уже оформленные заказы. Человек отвечает: нет.
  2. Модель создаёт TASK-0120, собирает контекстный пакет: PROJ моделей заказов, BEH-0042 о расчёте скидки, BEH-0017 о типах клиентов, RULE-0011 о денежных вычислениях, RB-0006 «изменить бизнес-правило», GRANT-0009 на изменения бизнес-правил в домене заказов при наличии теста до и после. В пакете отмечено, что BEH-0042 имеет уверенность high и доказательство EV-0311.
  3. Модель проверяет: полномочие покрывает класс действия, домен на уровне 2, документов disputed в домене нет. Решение человека дополнительно не требуется. Это записывается в журнал задачи.
  4. Ранбук RB-0006. Шаг один: написать тест, воспроизводящий текущее поведение с доставкой, и тест ожидаемого поведения, который должен упасть. Проверка: первый проходит, второй падает. Шаг два: изменить функцию расчёта. Проверка: второй тест проходит, характеризационные тесты домена проходят, кроме одного, зафиксировавшего старое поведение. Ранбук предписывает: изменить характеризационный тест только со ссылкой на INT и DEC. DEC отсутствует. Модель формирует запрос на решение: старое поведение было зафиксировано как правило, требуется подтверждение, что это дефект, а не намеренное. Человек отвечает: дефект. Создаётся DEC-0027, тест обновляется, характеризация заменена целевым тестом.
  5. Шаг три: обновить BEH-0042, статус draft, уверенность read, sources на новый SHA. Обновить quirks.md, если там было упоминание. Шаг четыре: полный прогон, EV-0340 на SHA головы. Шаг пять: коммиты с идентификаторами, черновик PR с описанием, раздел «что я не проверил»: не проверялось влияние на отчёты, использующие сумму скидки.
  6. Приёмка. Машинные проверки: зелёные. Независимый проверяющий с чистым контекстом находит: в домене отчётов есть BEH-0058, ссылающееся на BEH-0042 через depends_on, а изменение его не учло. Заключение: требуется анализ влияния. Совпадает с разделом «что я не проверил». Так как расхождение в зоне, которую модель сама отметила, ранбук предписывает не эскалацию, а дополнительный шаг: модель проверяет отчёт, находит, что он использует итоговую сумму из заказа, а не пересчитывает, и добавляет тест на отчёт. Новый коммит, EV-0340 устаревает, EV-0341 на новой голове.
  7. Повторная приёмка: проверяющий подтверждает. Полномочие разрешает автоматическое слияние. Слияние. Пост-слияние: BEH-0042 переводится в verified с verified_by: EV-0341, BEH-0058 получает пометку о проверке. Замечание проверяющего классифицируется как кандидат в правило: «при изменении правила проверять все входящие depends_on». Человек получает предложение правила и утверждает его как RULE-0019 с одним решением. Ранбук RB-0006 получает версию с новым обязательным шагом.

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

Пять способов, которыми концепция может дать сбой.

  1. Инфляция полномочий. Человек, устав от эскалаций, выдаёт полномочие с широкой областью. Формально всё в рамках системы, фактически контроль потерян. Защита в виде срока и событийного отзыва помогает, но не мешает выдать широкое полномочие. Нужен лимит на область одного полномочия и обязательный аудит полномочий по расписанию.
  2. Ложная верификация. Независимый проверяющий с той же моделью разделяет те же слепые пятна и подтверждает то же неверное прочтение кода. Тест на ложные утверждения ловит грубые случаи, но не систематические. Смягчение: часть проверок делать разными моделями или через исполнение, а не чтение.
  3. Гниение stale_when. Правила устаревания по путям пропускают косвенные зависимости: изменение общей утилиты не переводит в disputed документы доменов, которые ею пользуются. Документация выглядит верифицированной и не является. Нужен анализ импортов, а не только путей, и это техническая работа с неизвестной стоимостью.
  4. Перегрузка человека вопросами в фазе извлечения. Открытых вопросов в старом проекте будут сотни. Если каждый требует ответа, человек перестаёт отвечать, домены застревают на уровне 1, и процесс воспринимается как бюрократия. Нужна приоритизация вопросов по риску и допустимость временных подтверждений поведения с последующим пересмотром.
  5. Расхождение между процессом и реальностью команды. Часть команды продолжает делать изменения мимо ранбуков, документы не обновляются, disputed растёт, автономия понижается, и система деградирует к «документация, которой не доверяют». Механизм понижения уровней это ловит, но не лечит. Нужна защита на уровне репозитория: PR без идентификатора задачи не проходит, и это решение команда может отвергнуть.

Пять спорных решений для второго раунда.

  1. Документация в том же репозитории, что и код. Плюс атомарность, минус шум в истории и рост объёма репозитория, а также конфликт с монорепо или несколькими сервисами.
  2. Идентификаторы как единственный ключ ссылок с резолвом через манифест. Даёт устойчивость к переименованиям, но требует инструмента для чтения и ломает стандартные ссылки Markdown в обычных просмотрщиках.
  3. Уверенность документа равна минимальной уверенности утверждений. Заставляет дробить документы, но может сделать большие потоки перманентно low и обесценить метку.
  4. Подмножество тестов на шагах ранбука по затронутым путям. Ускоряет, но пропускает косвенные зависимости и создаёт ложную уверенность до приёмки. Альтернатива: всегда полный прогон и принять цену времени.
  5. Автоматическое слияние на уровне 2. Ускоряет, но означает, что ни один человек не видел изменение до попадания в основную ветку. Альтернатива: автономная подготовка всегда, слияние всегда человеком, при этом одна кнопка без чтения.

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

Требуемые проверки первичных источников. Я не утверждаю следующее как факт и прошу координатора проверить: возможности конкретных инструментов линтинга Markdown с фронтматтером и валидацией ссылок по идентификаторам; наличие в текущих версиях Django команд для машинного экспорта схемы моделей, URL и сигналов в формате, пригодном для проекций; поддержку в целевой системе хостинга git правил, запрещающих слияние без свежих проверок на текущей голове; возможность запуска независимого проверяющего с гарантированно изолированным контекстом в выбранной среде исполнения модели.