Дебаты Astra × Fableresponse
Ниже моё независимое предложение для первого раунда. Я не использовал инструменты и не читал файлы, как и требовалось.
Модель знаний и документация
Базовый принцип. Система строится как разделение по источнику истины. Каждая единица знания имеет ровно один тип, и тип определяет, кто может её создать, что её подтверждает и когда она устаревает. Смешивать типы в одном файле запрещено. Типов шесть:
- Проекция из кода (PROJ). Генерируется инструментами из репозитория: карта приложений, моделей, URL, сигналов, задач, миграций, зависимостей. Не редактируется руками. Привязана к SHA коммита и пересобирается автоматически.
- Наблюдаемое поведение (BEH). Описание того, что система фактически делает, с указанием источника: код, тест, лог, воспроизведённый прогон. Каждое утверждение имеет уровень уверенности и ссылку на доказательство. Пишется моделью, подтверждается проверкой.
- Намерение человека (INT). Что человек хочет и почему. Записывается в терминах цели и ограничений, не в терминах решений по коду. Только человек является автором, модель лишь фиксирует и переспрашивает.
- Решение (DEC). Выбор человека между вариантами, с контекстом, отвергнутыми альтернативами и следствиями. Неизменяемое после принятия. Новое решение может заменить старое, но не редактировать его.
- Утверждённое правило (RULE). Норма, обязательная для всех будущих работ: гайдлайн, инвариант, запрет. Правило всегда ссылается на решение, которым оно введено. Правило имеет версию.
- Полномочие (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/ на каждую задачу. Процедура сборки контекстного пакета:
- Задача получает идентификатор
TASK-NNNNи файлtask.mdс целью, ссылкой на намерение и оценкой класса изменения. - Инструмент по описанию задачи и по затрагиваемым путям строит граф: от путей к проекциям, от проекций к документам BEH, чьи
sourcesпересекаются, далее поdepends_onна одну степень. - Добавляются все RULE, соответствующие классу изменения, и все GRANT, которые могут покрыть действия.
- Добавляются ранбук и последние доказательства для затронутых путей.
- Результат сохраняется в
context.mdкак список идентификаторов с обоснованием включения и общим объёмом. Установлен верхний бюджет, скажем в токенах, и при превышении инструмент сначала выбрасывает документы сconfidence: low, затем транзитивные зависимости. - Пакет фиксируется в задаче. Если в ходе работы модель запросила документ вне пакета, это записывается в журнал: такие запросы являются сигналом для улучшения графа связей.
Отдельно поддерживается запрос «что ещё я мог не увидеть»: инструмент возвращает список документов со статусом disputed в затронутых доменах. Модель обязана их перечислить в PR.
Подробное документирование бизнес-логики. Единица описания это не модуль, а бизнес-правило и сквозной поток. Для каждого домена заполняются четыре вещи:
- Потоки. Последовательность шагов от триггера до наблюдаемого результата, с указанием, где шаг реализован. Ветвления описываются явно. Для каждого шага пишется, что проверено, а что предположено.
- Правила. Инварианты и условия в форме «если X, то Y, иначе Z», с примером входа и выхода. Каждое правило ссылается на код и, если существует, на тест. Правило без теста помечается как кандидат в характеризационный тест.
- Состояния. Жизненный цикл сущностей: статусы, переходы, кто инициирует, что запрещено.
- Открытые вопросы. Список мест, где код допускает несколько прочтений или где поведение выглядит случайным. Каждый вопрос адресован человеку и превращается либо в решение, либо в подтверждение поведения.
Извлечение бизнес-логики и архитектуры: процедура с неопределённостью. Извлечение идёт слоями, от механического к интерпретирующему:
- Механический слой. Генерация проекций из кода средствами Django и статического анализа. Здесь неопределённости нет, но есть неполнота: динамические импорты, условные URL, сигналы, подключаемые в неочевидных местах. Каждая проекция содержит раздел «известные слепые зоны».
- Структурный слой. Модель по проекциям определяет кандидаты в домены, границы между ними и точки входа. Результат это гипотезы с уверенностью. Человек подтверждает или правит границы доменов. Это первая точка решения, потому что вся дальнейшая навигация зависит от доменов.
- Поведенческий слой. Для каждого домена модель читает код точек входа и трассирует потоки. Каждое утверждение получает одну из меток:
observedпри наличии теста или воспроизведённого прогона,readпри выводе из чтения кода,inferredпри выводе из косвенных признаков,assumedпри отсутствии оснований. Утвержденияassumedзапрещено помещать в верифицированные документы. - Слой циклов и практик. Описываются циклы: обработка запроса от middleware до ответа, жизненный цикл фоновой задачи, цикл миграции данных, цикл деплоя, цикл релиза. Для каждого цикла фиксируются точки, где проект отклоняется от стандартной для Django практики, и почему, если причина восстанавливаема из истории коммитов или комментариев. Практики, которые повторяются в коде трижды и более, кандидаты в правила. Практики, которые встречаются один раз и противоречат остальным, кандидаты в
quirks.md. - Слой проверки. Каждый документ 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. Три независимых слоя, ни один не может видеть выводы другого до формирования собственного заключения:
- Машинные проверки. Тесты, линтеры, миграционные проверки, проверка документации, проверка полномочия. Результат это EV с привязкой к SHA головы PR.
- Независимая проверка моделью. Отдельный экземпляр с чистым контекстом получает диф, контекстный пакет и правила. Не получает журнал выполнения и описание PR. Задачи проверяющего: найти нарушения правил, найти изменения поведения, не отражённые в документах, найти утверждения в документах, не подтверждаемые дифом, найти отсутствующие тесты для изменённых правил. Только после формирования заключения ему показывают описание PR для сверки с разделом «что я не проверил».
- Решение человека. Требуется, если изменение вышло за полномочие, если проверяющие разошлись, если затронуты домены с
disputedдокументами, или если ранбук помечен как требующий приёмки человеком. В остальных случаях автоматическое слияние допустимо, если это разрешено правилом слияния и полномочием.
Привязка доказательств и устаревание. Каждое доказательство EV содержит SHA коммита, на котором получено, идентификаторы задачи и ранбука, набор проверок, результат, хеши окружения. При появлении нового коммита в PR все доказательства предыдущей головы помечаются stale. Слияние возможно только с полным набором свежих доказательств на текущей голове. Доказательства не удаляются: они остаются в истории для аудита. Проверка независимости фиксируется: в EV указано, какой контекст получал проверяющий.
Стратегия тестирования старого проекта. Полное покрытие недостижимо, и его не нужно обещать. Стратегия:
- Инвентаризация. Проекция существующих тестов: что покрыто, что запускается, что пропускается, сколько времени идёт. Отдельно выделяются тесты, которые падают на чистом чекауте: они переводятся в карантин с фиксацией причины.
- Характеризационные тесты. Для каждого верифицированного бизнес-правила без теста создаётся тест, фиксирующий текущее поведение, даже если оно выглядит неправильным. Название теста ссылается на идентификатор BEH. Неправильное поведение помечается открытым вопросом, а не исправляется.
- Приоритизация по риску. Домены ранжируются по частоте изменений в истории, по числу инцидентов, по объёму денежных или юридически значимых операций. Характеризация идёт сверху списка. Порог перехода к автономным изменениям в домене: наличие характеризационных тестов для всех правил с
confidence: highв этом домене. - Слои. Юнит-тесты сервисов и правил; интеграционные тесты потоков через тестовый клиент; тесты миграций на копии схемы; контрактные тесты внешних интеграций с записанными ответами; снимковые тесты для ответов API, где структура важна.
- Скорость. Полный набор запускается на приёмке. На шагах ранбука запускается подмножество, вычисляемое по затронутым путям через проекции. Это решение спорное, вынес его ниже.
- Тестовые данные. Фабрики или фикстуры по доменам с документацией в BEH, какие сценарии данных существуют.
Rollout и rollback процесса. Процесс вводится не для всего репозитория сразу, а по доменам и по классам действий. Каждый домен имеет уровень зрелости:
- Уровень 0: только проекции. Модель ничего не меняет.
- Уровень 1: документы BEH верифицированы, есть ранбуки, модель готовит PR, человек принимает каждый.
- Уровень 2: есть характеризационные тесты и полномочия на узкие классы действий, автономное слияние для них.
- Уровень 3: широкие полномочия, человек участвует только по эскалации и по новым намерениям.
Понижение уровня происходит автоматически при событиях: откат в проде, изменение из PR модели, два подряд PR с расхождением проверяющих, срабатывание disputed более чем на порог документов домена. Понижение записывается как решение с причиной. Откат самого процесса означает переход всех доменов на уровень 1, при этом документация и тесты сохраняются, потому что они полезны и без автономии. Ничего в процессе не должно делать репозиторий непригодным для обычной ручной разработки: все инструменты работают поверх обычного git и обычных тестов.
Миграция, проверка достаточности, сценарий, риски
Последовательность миграции.
- Инвентаризация. Вход: репозиторий, доступ к истории, CI, окружения. Работа модели: сбор проекций, инвентаризация тестов, статистика изменений по путям, список внешних интеграций, версии зависимостей. Точка решения: нет. Выход:
10-projections/, отчёт о слепых зонах, отчёт о состоянии тестов. Критерий перехода: проекции собираются воспроизводимо, известны падающие тесты. - Границы доменов и словарь. Вход: проекции, интервью с командой в форме коротких ответов. Работа модели: гипотезы доменов, глоссарий, карта потоков. Точка решения: человек утверждает домены и словарь. Выход: DEC о доменах,
glossary.md, доменные обзоры в статусе draft. Критерий: каждое приложение отнесено к домену, нет терминов с двумя значениями. - Пилотный домен. Выбирается домен со средним риском и высокой частотой изменений. Работа модели: полное извлечение BEH с уверенностью, независимая проверка, характеризационные тесты, первые ранбуки. Точка решения: человек разбирает открытые вопросы, каждый превращается в DEC или в подтверждение. Выход: домен на уровне 1. Критерий: все BEH домена в статусе verified или disputed с назначенным вопросом, ни одного assumed.
- Правила и первые полномочия. Вход: результаты пилота, история PR. Работа модели: извлечение практик в правила, черновики полномочий для двух-трёх узких классов действий. Точка решения: человек утверждает правила и полномочия. Выход:
50-rules/,60-grants/, ранбуки версии 1. Критерий: три задачи из реального бэклога пройдены по ранбукам с приёмкой человеком без исправлений вне процесса. - Автономия в пилоте. Домен переводится на уровень 2. Точка решения: человек утверждает переход. Критерий: за наблюдательный период не было понижения уровня.
- Масштабирование по доменам. Повторение шагов три-пять по списку приоритетов. Параллельно команда работает по новому процессу и в остальных доменах на уровне 1.
- Передача поддержки процесса. Ранбуки для изменения ранбуков, правил, полномочий. Модель ведёт процесс, человек принимает решения. Критерий: изменение процесса прошло через сам процесс.
Роль команды. Разработчики в переходе выполняют три вещи: отвечают на открытые вопросы, принимают решения, проверяют PR на уровне 1. Их знания извлекаются через вопросы модели, а не через требование написать документацию: человек делится умыслами, модель пишет. Рецензирование человеком на уровне 1 намеренно дорого и является главным источником правил: каждое замечание человека модель обязана классифицировать как кандидата в правило, в ранбук или в единичный случай, и человек подтверждает классификацию.
Проверка достаточности. Наличие Markdown ничего не гарантирует. Достаточность проверяется поведением системы, а не объёмом:
- Тест закрытой книги. Свежий экземпляр модели получает только контекстный пакет и задачу из реального прошлого PR. Результат сравнивается с реальным PR по набору критериев: те же файлы, те же правила, те же тесты. Расхождения дают либо дефект знаний, либо дефект старого PR.
- Тест на ложные утверждения. В документы намеренно вносится ложное утверждение, независимая проверка должна его найти. Это проверяет, что проверка работает, а не штампует.
- Тест на слепые зоны. Случайные пути из репозитория проверяются на достижимость из документации. Недостижимые пути с историей изменений это дыра.
- Метрики процесса. Доля PR, вернувшихся с приёмки; доля документов в
disputedстарше недели; доля задач, запросивших документы вне контекстного пакета; число эскалаций на задачу. Метрики сами по себе не цель, они триггеры разбора. - Явные границы. Корневой индекс содержит раздел «чего эта документация не утверждает», обновляемый при каждом аудите. Обещания полноты запрещены как класс формулировок в документах и проверяются линтером по словарю запрещённых фраз.
Сквозной условный сценарий. Условный проект, условный домен «заказы». Человек пишет: «Хочу, чтобы для корпоративных клиентов скидка применялась к сумме без учёта доставки, сейчас считается с доставкой, это ошибка».
- Модель создаёт INT-0031 с целью и ограничением, переспрашивает одно: распространяется ли изменение на уже оформленные заказы. Человек отвечает: нет.
- Модель создаёт TASK-0120, собирает контекстный пакет: PROJ моделей заказов, BEH-0042 о расчёте скидки, BEH-0017 о типах клиентов, RULE-0011 о денежных вычислениях, RB-0006 «изменить бизнес-правило», GRANT-0009 на изменения бизнес-правил в домене заказов при наличии теста до и после. В пакете отмечено, что BEH-0042 имеет уверенность high и доказательство EV-0311.
- Модель проверяет: полномочие покрывает класс действия, домен на уровне 2, документов
disputedв домене нет. Решение человека дополнительно не требуется. Это записывается в журнал задачи. - Ранбук RB-0006. Шаг один: написать тест, воспроизводящий текущее поведение с доставкой, и тест ожидаемого поведения, который должен упасть. Проверка: первый проходит, второй падает. Шаг два: изменить функцию расчёта. Проверка: второй тест проходит, характеризационные тесты домена проходят, кроме одного, зафиксировавшего старое поведение. Ранбук предписывает: изменить характеризационный тест только со ссылкой на INT и DEC. DEC отсутствует. Модель формирует запрос на решение: старое поведение было зафиксировано как правило, требуется подтверждение, что это дефект, а не намеренное. Человек отвечает: дефект. Создаётся DEC-0027, тест обновляется, характеризация заменена целевым тестом.
- Шаг три: обновить BEH-0042, статус draft, уверенность read,
sourcesна новый SHA. Обновитьquirks.md, если там было упоминание. Шаг четыре: полный прогон, EV-0340 на SHA головы. Шаг пять: коммиты с идентификаторами, черновик PR с описанием, раздел «что я не проверил»: не проверялось влияние на отчёты, использующие сумму скидки. - Приёмка. Машинные проверки: зелёные. Независимый проверяющий с чистым контекстом находит: в домене отчётов есть BEH-0058, ссылающееся на BEH-0042 через
depends_on, а изменение его не учло. Заключение: требуется анализ влияния. Совпадает с разделом «что я не проверил». Так как расхождение в зоне, которую модель сама отметила, ранбук предписывает не эскалацию, а дополнительный шаг: модель проверяет отчёт, находит, что он использует итоговую сумму из заказа, а не пересчитывает, и добавляет тест на отчёт. Новый коммит, EV-0340 устаревает, EV-0341 на новой голове. - Повторная приёмка: проверяющий подтверждает. Полномочие разрешает автоматическое слияние. Слияние. Пост-слияние: BEH-0042 переводится в verified с
verified_by: EV-0341, BEH-0058 получает пометку о проверке. Замечание проверяющего классифицируется как кандидат в правило: «при изменении правила проверять все входящиеdepends_on». Человек получает предложение правила и утверждает его как RULE-0019 с одним решением. Ранбук RB-0006 получает версию с новым обязательным шагом.
Человек в сценарии принял три решения: ограничение по старым заказам, признание дефекта, утверждение правила. Всё остальное сделано без него.
Пять способов, которыми концепция может дать сбой.
- Инфляция полномочий. Человек, устав от эскалаций, выдаёт полномочие с широкой областью. Формально всё в рамках системы, фактически контроль потерян. Защита в виде срока и событийного отзыва помогает, но не мешает выдать широкое полномочие. Нужен лимит на область одного полномочия и обязательный аудит полномочий по расписанию.
- Ложная верификация. Независимый проверяющий с той же моделью разделяет те же слепые пятна и подтверждает то же неверное прочтение кода. Тест на ложные утверждения ловит грубые случаи, но не систематические. Смягчение: часть проверок делать разными моделями или через исполнение, а не чтение.
- Гниение
stale_when. Правила устаревания по путям пропускают косвенные зависимости: изменение общей утилиты не переводит вdisputedдокументы доменов, которые ею пользуются. Документация выглядит верифицированной и не является. Нужен анализ импортов, а не только путей, и это техническая работа с неизвестной стоимостью. - Перегрузка человека вопросами в фазе извлечения. Открытых вопросов в старом проекте будут сотни. Если каждый требует ответа, человек перестаёт отвечать, домены застревают на уровне 1, и процесс воспринимается как бюрократия. Нужна приоритизация вопросов по риску и допустимость временных подтверждений поведения с последующим пересмотром.
- Расхождение между процессом и реальностью команды. Часть команды продолжает делать изменения мимо ранбуков, документы не обновляются,
disputedрастёт, автономия понижается, и система деградирует к «документация, которой не доверяют». Механизм понижения уровней это ловит, но не лечит. Нужна защита на уровне репозитория: PR без идентификатора задачи не проходит, и это решение команда может отвергнуть.
Пять спорных решений для второго раунда.
- Документация в том же репозитории, что и код. Плюс атомарность, минус шум в истории и рост объёма репозитория, а также конфликт с монорепо или несколькими сервисами.
- Идентификаторы как единственный ключ ссылок с резолвом через манифест. Даёт устойчивость к переименованиям, но требует инструмента для чтения и ломает стандартные ссылки Markdown в обычных просмотрщиках.
- Уверенность документа равна минимальной уверенности утверждений. Заставляет дробить документы, но может сделать большие потоки перманентно low и обесценить метку.
- Подмножество тестов на шагах ранбука по затронутым путям. Ускоряет, но пропускает косвенные зависимости и создаёт ложную уверенность до приёмки. Альтернатива: всегда полный прогон и принять цену времени.
- Автоматическое слияние на уровне 2. Ускоряет, но означает, что ни один человек не видел изменение до попадания в основную ветку. Альтернатива: автономная подготовка всегда, слияние всегда человеком, при этом одна кнопка без чтения.
Дополнительные аспекты, которые считаю существенными и не перечисленными в задании. Безопасность и секреты: модель не должна видеть продовые данные, а характеризационные тесты не должны включать реальные записи. Данные для миграций: ранбук миграции данных требует прогона на копии и обратной миграции. Наблюдаемость после слияния: доказательства должны включать не только предслияние, но и постдеплойные сигналы, иначе понижение уровня срабатывает слишком поздно. Юридические и лицензионные ограничения на отправку кода в модель. Стоимость: бюджет токенов на задачу как часть контракта ранбука. Мультиязычность документации: словарь должен фиксировать, на каком языке пишутся идентификаторы, документы и коммиты.
Требуемые проверки первичных источников. Я не утверждаю следующее как факт и прошу координатора проверить: возможности конкретных инструментов линтинга Markdown с фронтматтером и валидацией ссылок по идентификаторам; наличие в текущих версиях Django команд для машинного экспорта схемы моделей, URL и сигналов в формате, пригодном для проекций; поддержку в целевой системе хостинга git правил, запрещающих слияние без свежих проверок на текущей голове; возможность запуска независимого проверяющего с гарантированно изолированным контекстом в выбранной среде исполнения модели.