Дебаты Astra × Fableresponse
Критика и обновлённые решения второго раунда. Инструменты не использовал.
Что принять у Astra и где оба предложения ломаются
Сильные стороны Astra, которые принимаю. Первое: единица управления это изменение с контрактом, а не диалог и не PR. Мой TASK был слабее, потому что не содержал согласованных критериев результата до начала работы. Второе: замена численной уверенности на «какого свидетельства недостаёт». Моя схема high/medium/low с правилом минимума действительно обесценивается на больших потоках, а перечень недостающих свидетельств прямо порождает следующую проверку. Третье: разделение локального коммита, push и открытия PR как отдельных действий с отдельными условиями. Четвёртое: явное правило, что инструкции из issue, логов и внешних страниц не выдают полномочий. Пятое: разграничение «так сделано в старом коде», «так рекомендовано», «так запрещено», которое не даёт частому антипаттерну стать гайдом. Шестое: перечень Django-механизмов для обследования без предположения об их наличии, теперь подкреплённый S04 и S05.
Ниже недостатки. Нумерую сквозным списком, у каждого указываю, чьё это утверждение и как исправить.
1. Сокращение контекста выбрасыванием low-confidence и транзитивных зависимостей. Моё. Сценарий сбоя: документ с низкой уверенностью описывает единственный известный побочный эффект в бухгалтерской выгрузке, инструмент его выбрасывает ради бюджета, модель меняет расчёт и не видит риска. Низкая уверенность означает не «неважно», а «здесь неизвестное», и это ровно то, что должно дойти до исполнителя. Исправление: пакет никогда не отбрасывает узлы графа молча. При превышении бюджета допустимы три действия. Заменить полный текст документа на его заголовок и раздел «недостающие свидетельства», сохранив идентификатор в обязательном списке «известные неизвестные». Разделить задачу на части с меньшей областью. Провести исследовательский ранбук, который сжимает несколько документов в проверенную сводку с собственным идентификатором и ссылками. Правила и полномочия не сжимаются никогда. У Astra это сформулировано верно, принимаю.
2. Изменение кода как автоматическая отмена нормы. Моё, частично Astra. У меня stale_when переводит документ в disputed, и документ в disputed не может быть основанием действия. Для BEH это правильно, для RULE и GRANT нет: правило «денежные суммы только в Decimal» не перестаёт действовать оттого, что кто-то тронул модуль расчёта. Astra пишет, что изменение исходников «не должно автоматически переписывать нормативное правило», но не даёт механизма. Исправление: четыре независимых поля вместо одного статуса. status описывает жизненный цикл записи и меняется только явным действием: draft, active, superseded. verification описывает проверенность относительно кода и вычисляется: current, stale, never. evidence_gap перечисляет недостающие свидетельства. authority относится только к GRANT и описывает применимость: active, expired, revoked. Изменение кода переводит verification фактов и проекций в stale и не трогает status норм. Норма меняется решением. Полномочие может ссылаться на условие «verification зависимых фактов = current», и тогда оно временно неприменимо, но не отозвано. Это отличие важно: отзыв требует решения, неприменимость снимается перепроверкой без человека.
3. Саморазрешение через PR. Оба. У меня полномочия лежат в docs/60-grants/, у Astra в governance/ и changes/. Если исполнитель меняет в одном PR и код, и файл полномочия, и конфигурацию проверок, то проверка «полномочие покрывает действие» читает документ, который сам исполнитель и написал. Astra называет проблему, но ограничивается «отдельным маршрутом». Исправление, опирающееся на S10, S11, S15: политику исполняет компонент вне ответа модели и вне ветки PR. Конкретно, оценщик полномочий читает реестр полномочий, правила и конфигурацию приёмки только из базовой ветки на момент проверки, никогда из головы PR. Пути реестра полномочий, конфигурации CI и правил приёмки защищены на уровне платформы владельцами путей: PR, который их трогает, требует решения человека независимо от любого полномочия. Локальные хуки только для обратной связи, потому что их можно обойти. Обязательные проверки на платформе должны проверяться агрегатором по имени и результату, а не по общему зелёному индикатору, поскольку S11 указывает, что пропущенные статусы могут удовлетворять правилу. Исполнитель работает с токеном, у которого нет права слияния и права изменять защиту веток. Слияние выполняет отдельный компонент с собственным токеном после оценки политики.
4. Цикл SHA при записи доказательств в дерево. Моё. Я предложил 80-evidence/<sha>/<run-id>.json в репозитории и поле verified_by во фронтматтере. Коммит с доказательством меняет SHA, и доказательство ссылается на предыдущее состояние, а не на текущее. У Astra тот же дефект в evidence-manifest.yaml внутри changes/. Исправление: доказательства и статус проверенности не хранятся в дереве, которое проверяют. Хранилище доказательств это отдельное место, привязанное к SHA как к ключу: статусы проверок платформы, хранилище артефактов, либо отдельная ветка или git notes, если платформа их поддерживает. Это факт для проверки координатором по выбранной платформе. Фронтматтер содержит только утверждения автора: на каком SHA документ писался и какие источники читались. Поле verification вычисляется инструментом из хранилища доказательств при сборке индексов и контекстных пакетов и никогда не коммитится в документ. В репозиторий попадает только сгенерированный отчёт о здоровье знаний, и он допускает отставание на один коммит, потому что не является основанием для решения.
5. Что именно принимается. Оба неточно. Я писал «SHA головы PR», Astra «head SHA, основание сравнения, конфигурация и версия правил». Этого недостаточно. Принимаемый объект это кортеж: SHA базы, SHA головы, SHA результата слияния, отпечаток окружения проверки, версии правил и версия каждого применённого полномочия, версия ранбука. Все доказательства привязаны к этому кортежу. Новый коммит в ветке меняет голову, кортеж новый, доказательства прежнего кортежа остаются в истории, но не пригодны. Изменение базы меняет результат слияния, и требуется как минимум повтор машинных проверок на результате слияния. Очередь слияния платформы, если она есть, делает это штатно, и это следует проверить по S11 для выбранной платформы. Истечение или отзыв полномочия проверяется в момент финального шлюза, а не только при старте задачи: если полномочие истекло между подготовкой и слиянием, кандидат остаётся принятым по разработке, но не сливается без нового решения. Человек получает готовый пакет «кандидат принят, полномочие истекло, продлить или отклонить».
6. Идентификаторы и wiki-ссылки. Моё. Счётчик в manifest.yaml конфликтует при параллельных ветках. Обязательный формат [[BEH-0042]] ломает чтение в обычных просмотрщиках. Исправление: идентификатор это тип плюс короткий случайный суффикс, например BEH-k7f3q, выданный при создании без обращения к реестру. Уникальность проверяет линтер на слиянии, вероятность коллизии при коротком суффиксе низкая, но не нулевая, и линтер обязан отклонить коллизию. Ссылки пишутся обычным Markdown по относительному пути с текстом ссылки, содержащим идентификатор. Линтер проверяет, что путь существует и что фронтматтер по пути содержит именно этот идентификатор. При переименовании файла инструмент переписывает пути по идентификатору из фронтматтера. Нестандартный синтаксис не нужен.
7. Проверки миграций. Моё. makemigrations --check --dry-run доказывает только отсутствие незафиксированных изменений моделей. Наличие функции reverse у RunPython не доказывает, что данные восстанавливаются. Корректный набор проверок для ранбука схемы, с учётом S03: количество новых файлов в каталоге миграций равно ожидаемому по дифу; миграции применяются на пустой базе вперёд, откатываются к предыдущему состоянию и применяются снова; для миграций данных прогон на копии данных со снятыми инвариантами до и после, например число строк, суммы по ключевым полям, распределение статусов, и сравнение инвариантов после отката; вывод SQL миграции проверяется на блокирующие операции по правилам целевой СУБД; RunPython использует только исторические модели из переданного registry, что проверяется статически; необратимая миграция допускается только с явной пометкой и с описанной компенсацией. Проверка транзакционных свойств по S01 и S02 добавляется, когда миграция сопровождается внешними эффектами.
8. Возобновление после сбоя. Оба недостаточно конкретны. Astra верно говорит «сверить внешнее состояние», я верно говорю «проверить состояние перед повтором», но ни один не описал процедуру. Исправление: журнал выполнения хранит для каждого шага отпечаток входов, тип шага и внешние идентификаторы. При возобновлении: если результат внешней операции неизвестен, исполнитель запрашивает состояние по детерминированному ключу, например ветка с именем задачи существует, PR по этой ветке существует, и переиспользует найденное; повтор без сверки запрещён для любого шага с внешним эффектом. Локальные изменения сверяются с отпечатком последнего успешного шага: совпадают, значит продолжать; не совпадают, значит рабочее дерево сбрасывается к последнему коммиту задачи, а расхождение сохраняется как патч и упоминается в журнале. Версия ранбука фиксируется при старте, возобновление идёт по ней; если версия помечена как отозванная, задача останавливается с пакетом для решения, и это единственный случай, когда новый ранбук требует человека. Публикация PR идемпотентна по ключу «идентификатор задачи в теле PR».
9. Исторический PR как оракул. Моё. Сравнение «те же файлы, те же тесты» наказывает лучшие решения и поощряет подгонку. Кроме того, история PR лежит в репозитории, и исполнитель может её увидеть. Исправление: оценка проводится проспективно и вслепую. Отложенный набор формируется из задач, возникших после снимка, на котором строилась документация, чтобы решение не было в истории. Для ретроспективных задач исполнитель получает снимок до PR с урезанной историей и без доступа к ветке решения. Сравнение ведёт независимый судья по рубрике: названы ли те же затронутые инварианты и точки входа; проходят ли тесты, добавленные в оригинальном PR, на решении модели, при этом тесты скрыты от исполнителя; не нарушены ли правила; сформулированы ли неизвестные. Совпадение файлов не оценивается. Расхождение по инвариантам разбирается вручную и может обнаружить дефект оригинала.
10. Повторный вопрос при ясном намерении. Моё, и это ошибка в моём же сценарии. Человек написал «это ошибка», а модель потом спросила «дефект ли это». Вопрос дублировал намерение. Исправление: намерение, зафиксированное человеком, само является решением о желаемом поведении, и отдельный DEC для этого не нужен. Что требуется отдельно, так это право исполнения, и оно уже было в полномочии. Характеризационный тест, зафиксировавший старое поведение, переопределяется со ссылкой на намерение, а не на новый DEC. Вопрос человеку допустим только когда проверка обнаруживает конфликт с ранее записанным решением или правилом, и тогда он формулируется как выбор между двумя записями, а не как «вы точно это имели в виду». Уточняющие вопросы до старта допускаются только по параметрам, которые меняют объём работы, например по старым заказам, и задаются одним пакетом.
11. Тяжесть обеих архитектур. Astra предлагает governance из пяти политик, реестр объектов, карту зависимостей и HTML-макет до первого изменения. Я предложил девять каталогов и четыре уровня зрелости. Ни один из нас не сказал, с чего начать за неделю. Ниже минимальный вариант.
12. Расплывчатые критерии у Astra. «Количество пилотов определяется разнообразием рисков» и «проверка результата объединения может потребоваться» не дают проверяемого условия. Мой набор триггеров понижения уровня конкретнее, но ему тоже нужны пороги, и их следует калибровать по метрикам пилота, а не назначать заранее.
Спорные решения и минимальный вариант
Для каждого пункта: рекомендация, альтернатива, условие смены.
Документация в репозитории кода. Рекомендую в репозитории: атомарность PR с кодом важнее шума истории. Альтернатива: отдельный репозиторий знаний с привязкой по SHA. Выбирать альтернативу, если сервисов несколько и домен пересекает репозитории, либо если платформа не позволяет защитить пути внутри одного репозитория.
Идентификаторы и ссылки. Рекомендую случайный суффикс и обычные ссылки по пути с проверкой линтером. Альтернатива: центральный реестр с выдачей номеров через инструмент. Выбирать её, если команда требует читаемых номеров для устного общения и готова принять сериализацию создания записей.
Уверенность документа. Рекомендую отказаться от общей метки и хранить evidence_gap по утверждениям. Альтернатива: метка документа как минимум по утверждениям. Выбирать её только для генерируемых сводных индексов, где нужна одна колонка.
Подмножество тестов на шагах ранбука. Рекомендую полный прогон на каждом шаге, где это укладывается в порог времени, и подмножество только для быстрых итераций внутри шага. Альтернатива: подмножество по путям всегда до приёмки. Выбирать её, если полный набор идёт больше порога, при этом обязательно расширять подмножество анализом импортов, а не только путями.
Автоматическое слияние. Рекомендую автономную подготовку и автоматическое слияние только для классов действий с полностью машинной проверкой: обновление документации, зависимости с зафиксированной версией, добавление тестов без изменения кода. Для изменений поведения слияние по решению человека одной кнопкой на готовом пакете. Альтернатива: автоматическое слияние для всех классов с полномочием. Выбирать её только после наблюдательного периода, в котором доля возвратов с приёмки в классе ниже согласованного порога, и с автоматическим откатом к первой политике по триггеру.
Хранение реестра полномочий. Рекомендую в репозитории под защитой путей, чтение только из базовой ветки. Альтернатива: внешний реестр. Выбирать её, если платформа не защищает пути или если полномочия должны действовать на несколько репозиториев.
Строгость схемы Markdown. Рекомендую строгую схему только для GRANT, RB и фронтматтера всех записей; тело документов свободное. Альтернатива: строгая схема для всего. Выбирать её, если планируется машинное сопоставление правил и примеров, и команда готова платить за это скоростью написания.
Независимость приёмки по риску. Рекомендую три ступени: машинная проверка для низкого риска; плюс независимый проверяющий с чистым контекстом для изменения поведения; плюс решение человека для миграций данных, прав доступа, внешних эффектов и файлов политики. Альтернатива: единый маршрут. Выбирать её на первые недели пилота, пока классификация риска не откалибрована.
Характеризация как обязательство совместимости. Рекомендую считать характеризационный тест обязательством по умолчанию до появления намерения, которое его отменяет, и отменять его со ссылкой на намерение без отдельного решения. Альтернатива: характеризация только диагностика. Выбирать её для доменов, где человек явно заявил, что текущее поведение не считается эталоном.
Минимальный жизнеспособный процесс. Не платформа, а шесть вещей, которые можно сделать до конца пилота на существующих инструментах.
- Один файл конвенций и словарь. Фронтматтер с идентификатором, типом, статусом, источниками и SHA. Линтер на существование ссылок и уникальность идентификаторов.
- Проекции, которые собираются одной командой из существующих средств Django и статического анализа. Без собственных парсеров на старте.
- Один пилотный домен: карточки правил с
evidence_gap, характеризационные тесты для правил с денежным или юридическим весом, открытые вопросы, ранжированные по риску, не более десяти в пакете для человека. - Три ранбука: изменение бизнес-правила, аддитивная схема, исправление дефекта. Журнал выполнения в виде обычного файла. Возобновление по описанной процедуре.
- Полномочия как файлы в защищённом каталоге, оценка политики скриптом в CI, читающим базовую ветку. Исполнитель без права слияния. Доказательства в статусах проверок платформы, не в дереве.
- Человек принимает каждый PR пилота одной кнопкой на готовом пакете. Каждое замечание классифицируется как кандидат в правило.
Границы расширения. Автоматическое слияние, независимый проверяющий-модель, анализ импортов для устаревания, реестр объектов и очередь слияния добавляются по одному, каждый с метрикой, которая его оправдывает: доля возвратов, доля устаревших записей, число эскалаций на задачу. Уровни зрелости доменов остаются, но триггеры понижения калибруются по первым тридцати задачам, а не назначаются заранее.
Исправления моего первого раунда, сведённые. Убираю численную уверенность и правило минимума. Разделяю статус, проверенность, пробел свидетельств и применимость. Выношу доказательства из дерева. Ввожу кортеж принятия. Меняю выдачу идентификаторов и формат ссылок. Заменяю проверки миграций. Описываю возобновление. Заменяю тест закрытой книги на проспективную слепую оценку. Убираю дублирующий вопрос из сценария. Добавляю чтение политики из базовой ветки и защиту путей.
Нерешённые вопросы для следующего раунда.
- Кто исполняет шлюз слияния и с какими правами, если платформа не выбрана: нужен ли собственный сервис или достаточно защиты веток и очереди слияния платформы. Требует факта по S11 и S12 для конкретной платформы.
- Где хранить доказательства, чтобы они пережили удаление веток и смену платформы: статусы проверок, артефакты с ограниченным сроком или отдельная ветка. Выбор влияет на аудит и на стоимость.
- Как проводить проспективную оценку достаточности, если бэклог пилота мал: допустима ли ретроспектива с урезанной историей, и как гарантировать, что исполнитель не восстановит решение из соседних веток или из документов, написанных после PR.