Человек определяет смысл.
Система доводит задачу до результата.
Как связать документацию большого Django-проекта, ранбуки и проверку изменений — и сокращать участие человека после принятого решения.
Три раунда реальных дебатов, руководство, шаблоны и эта демонстрация. Статус финальных проверок — в реестре результата.
Сначала универсальная концепция. Человек даёт намерения и решения; модель выполняет механику и использует решения повторно.
Связанные знания, исполняемые ранбуки и доверенные проверки. На живом репозитории эти механизмы ещё не установлены.
Где процесс идёт сам, а где останавливается
Учебный пример: покупатель может отменить неоплаченный заказ до сборки. Все ID и события условные. Кнопки меняют только иллюстрацию и не дают реальных полномочий.
Документ хранит определённый вид знания
Намерение и решение
Зачем меняем поведение, что выбрано, кем и в каких границах.
Норма
Что должно быть верно. Источник — действующее решение или политика.
Наблюдение и карта
Что делает код и как он устроен в конкретном снимке. Не подменяет норму.
Доказательство
Что проверил доверенный исполнитель на определённом кандидате.
Обычные Markdown-ссылки и устойчивые ID связывают документы. Индекс и обратные связи генерируются. Полномочия исполняет доверенный инструмент; текст инструкции сам по себе их не обеспечивает.
Что получает модель перед задачей
Манифест контекста: намерение, действующие нормы и политика, impact map, версии источников, конфликты и существенные неизвестные. Влияние дополнительно проверяется по коду, входным точкам и писателям данных. При нехватке контекста задача делится; важное неизвестное сохраняется.
Как отличать норму от старого поведения
«Так делает код» фиксируется как OBS. «Так должно работать» — как BR со ссылкой на решение. Несовпадение становится отдельным конфликтом. Зелёный тест старого поведения не превращает его в бизнес-требование.
Переход с проверкой результата каждого этапа
| Этап | Механика системы | Условие перехода |
|---|---|---|
| M0 · Мандат | Цель, роли, начальные полномочия и варианты допустимого риска. | Мандат принят; исполнитель отказывает за его пределами. |
| M1 · Baseline | Паспорт, среда, входы, writers, внешние эффекты и исходные проверки. | Другой исполнитель повторяет baseline; ограничения перечислены. |
| M2 · Знания пилота | Правила, источники, oracle, индекс и контекст выбранного среза. | Различены факт и намерение; критические конфликты разрешены. |
| M3 · Ранбуки | Ранбуки изменения и приёмки, журнал, четыре адаптера. | Негативные проверки policy, CI, merge и resume ловят свой сбой. |
| M4 · Реальные задачи | Обычные и скрытые задачи, внедрённые сбои, учёт всех попыток. | Критерии выбранного класса выполнены; скрытая ручная механика выявлена. |
| M5 · Расширение | Сравнить оценку с критериями и подготовить предложение новых областей. | Расширение принято на основании испытаний; новые права активированы отдельно. |
| M6 · Сопровождение | Drift-аудит, восстановление и регрессия при смене модели/инструментов. | Процесс воспроизводим на новых задачах; прошлый успех не переносится вслепую. |
Начните с небольшого полезного среза, минимального индекса и двух ранбуков. Workflow engine, поиск по векторам и отдельная база знаний добавляются при измеренной потребности.
Концепция задаёт проверяемые условия
Какой результат считается достаточным
Для конкретного класса задач определены поведение и область, найдены существенные пути, работает среда, evidence относится к актуальному кандидату, полномочия применимы, сбои обнаруживаются предусмотренными механизмами, восстановление проверено. Это не обещание отсутствия всех будущих ошибок.
Где сохранилась разница между Astra и Fable
Fable предпочитает ручное решение по каждому pilot PR до проверки четырёх адаптеров. Astra допускает узкую автоматизацию при уже доказанной готовности необходимых механизмов. Гайд привязывает допуск к испытанному действию и принятому риску; повторный ручной approval после этого не обязателен.
Что предстоит выяснить в живом репозитории
Версии и топологию, бизнес-оракулы, реальные входы и обходные writers, CI/merge-семантику, внешние эффекты, данные, риск и условия выпуска. Копируемый стартовый запрос для обследования есть в главе 7. Ни одна демонстрационная проверка не выдаётся за тест продукта.