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 проекций
├── rate-limit-exhausted.md             # выгорание rate budget
└── visibility-policy-cache-poisoning.md # неконсистентность policy-кэша

Ключевые концепции уровня

• Симптом — что наблюдает оператор.
• Диагностика — как подтвердить проблему.
• Смягчение — что сделать немедленно.
• Root cause — как устранить причину, а не только симптомы.

Когда смотреть сюда

• Уже есть operational issue и нужно пошаговое действие.
• Нужен шаблон нового runbook.

Когда НЕ смотреть сюда

• Нужна архитектура системы → ../../20-architecture/.
• Нужен сервисный контракт → ../../30-services/.

Связано

• ../AGENTS.md
• _TEMPLATE.md
• ../../50-processes/documentation-standard.md

Соглашения

• Каждый runbook должен содержать минимум секции: Симптом, Диагностика, Смягчение, Устранение root cause.
• Если runbook ссылается на несуществующий файл, сначала создайте документ или удалите ссылку.