AGENTS.md — runbooks
Назначение уровня
Этот уровень содержит пошаговые runbook-инструкции для типовых инцидентов и операционных задач.
Содержание
runbooks/
├── AGENTS.md # ← вы здесь
├── _TEMPLATE.md # шаблон нового runbook
├── etm-session-failure.md # проблемы с сессией ETM
├── kafka-consumer-lag.md # отставание consumer group
├── event-store-projection-lag.md # растущий outbox / lag проекций
├── db-vps-io-saturation.md # диск насыщен: вакуумы часами, docker не создаёт контейнеры
├── migration-deployed-without-code.md # схема впереди кода → тихая порча данных
├── rate-limit-exhausted.md # выгорание rate budget
├── visibility-policy-cache-poisoning.md # неконсистентность policy-кэша
├── category-tree-publish.md # публикация дерева категорий (операционный джоб)
└── analog-rules-carry.md # перенос правил аналогов на живое дерево
Ключевые концепции уровня
- Симптом — что наблюдает оператор.
- Диагностика — как подтвердить проблему.
- Смягчение — что сделать немедленно.
- Root cause — как устранить причину, а не только симптомы.
Когда смотреть сюда
- Уже есть operational issue и нужно пошаговое действие.
- Нужен шаблон нового runbook.
Когда НЕ смотреть сюда
- Нужна архитектура системы →
../../20-architecture/. - Нужен сервисный контракт →
../../30-services/.
Связано
Соглашения
- Каждый runbook должен содержать минимум секции:
Симптом,Диагностика,Смягчение,Устранение root cause. - Если runbook ссылается на несуществующий файл, сначала создайте документ или удалите ссылку.