Агент мониторинга ошибок: правила incidents.md

Ошибки в продукте ты узнаёшь от клиентов: «у меня не проходит оплата» приходит в личку через три часа после того, как она сломалась. Логи есть, но в них сотни строк, и непонятно, что из этого пожар, а что шум. Агент может читать логи по расписанию и писать тебе в Telegram, но без правил он будет либо молчать, либо будить из-за каждого предупреждения.

incidents.md — эти правила. В нём записано, какие ошибки считать проблемой и с какого порога, какой у неё уровень серьёзности, кому и как сообщать и что агенту делать запрещено. Ниже промпты, которые соберут файл под твой продукт и проверят его на кусках реальных логов, прежде чем ты подключишь агента к расписанию.

Что внутри incidents.md

• 📏Пороги

  Конкретно: «больше [N] ошибок оплаты за [M] минут» или «одна ошибка при создании заказа». Числа ставишь ты, агент их не выдумывает.

• 🚨Уровни серьёзности

  Три уровня по тому, что чувствует пользователь: не может заплатить или войти; что-то работает с ошибками; шум без последствий для людей.

• 📣Маршрут оповещения

  Кому, каким способом и когда. Первый уровень будит ночью, второй ждёт утра, третий попадает в недельную сводку.

• 🚫Границы агента

  Агент читает и сообщает. Не перезапускает сервер, не правит код и не пишет клиентам сам.

Как использовать

1. 1Собери образцы логов

   20–50 строк из файла логов или сервиса ошибок за обычный день и за день, когда что-то ломалось. Убери из них почты, телефоны, токены.

2. 2Собери incidents.md

   Промпты шагов 1 и 2. Сохрани ответ как incidents.md в папке docs проекта или рядом с настройками агента.

3. 3Проверь на образцах

   Промпт шага 3 в новом чате: агент получает только incidents.md и логи. Сверь, какие уровни он поставил, с тем, что поставил бы сам.

4. 4Подключи к расписанию

   Когда разметка совпадает, запускай агента по расписанию с этим файлом как инструкцией. Первую неделю перечитывай его сообщения и правь пороги.

Как настроить сам запуск агента по расписанию, разобрано в материале про регулярный мониторинг. Здесь — только правила, по которым он решает.

Рядом по теме: Личный агент, который знает тебя с первого сообщения, CLAUDE.md, который агент правда читает, Как тестировать код от ИИ-агента: вход, доступы, ошибки, статья «Cursor или Claude Code» и VIBERZ Product Brain — единый контекст для AI-скиллов (бесплатно после регистрации).

Что дальше

• Из хаотичных логов в баг-репорты для AI-разработчика — что делать с оповещением, чтобы агент-разработчик починил причину.
• Постмортем инцидента — разбор после SEV1, чтобы он не повторился.
• План отката релиза — если SEV1 случился сразу после выкатки.