Engineering Incidents Playbook

Читатель: посетитель — что это такое и стоит ли брать.

Каталог из 207 правил для Claude Code и GitHub,
где каждое выросло из реальной поломки. Работа с агентскими окнами и сводом проекта (CLAUDE.md),
конвейер GitHub, параллельные исполнители, аудит. Каждая запись — с историей:
что сломалось, как обнаружили, чем обошлось.

🇬🇧 English · Неофициально, к Anthropic отношения не имеет.

На что витрина не отвечает и почему. Набор вопросов один на все проекты
(.rules/showcase.json), и пробел в нём называется, а
не опускается: значка PyPI нет, потому что каталог не пакет и предмета не
существует; значка CI нет, потому что состояние прогонов отдаёт сама
площадка, а второй источник того же расходится с первым молча
(022). Отсутствующий значок и
застывший значок с витрины неотличимы — поэтому пробел назван
(046).

С чего начать: десять правил, с которых начать ·
порядок первого дня ·
весь каталог и вход по областям

Зачем это

Свод «делай так» копируют целиком и не соблюдают. Правило держится, пока живо
понимание, зачем оно, — а понимание живёт в инциденте, а не в формулировке.

Поэтому здесь не список требований, а каталог разборов. Читаете описание
поломки, узнаёте свою ситуацию — берёте правило вместе с причиной.

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

Подключаете проект — CONNECT.md: одна команда собирает
ответ по каждому правилу, канал обратно и ежедневный прогон «входящих».
Каталог отдаёт наружу механизмы, а не только текст, и подключаются командой,
а не копированием.

Начинаете новый проект — пройдите START.md: порядок первого
дня и что можно отложить. Заготовки лежат в templates/ — они
для того, кому инструменты недоступны.

Ищете решение конкретной боли — смотрите rules/: один файл на
правило, вход по номеру или по областям.

Не знаете, с чего начать читать — TOP-10.md: десять правил,
которые переносятся дальше своего стека.

Хотите внести своё — CONTRIBUTING.md: что здесь
принимают, в каком виде и почему правило без инцидента не принимают.

Не копируйте каталог целиком. У каждого правила есть раздел
«Применимость», и в нём честно сказано, где оно не работает. Половина
здешнего заточена под агентские окна, GitHub и лимиты; в проекте на другом
стеке это балласт.

Формат записи

Правило        одной фразой
Инцидент       что сломалось, как обнаружили, чем обошлось
Почему         механизм поломки, а не мораль
Применимость   где работает — и где НЕ работает
След           issue или PR, где поломка видна

След обязателен. Без ссылки на доказательство запись за месяц превращается
в «кто-то говорил, что так лучше».

Как пополняется

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

Запись делается в тот же день. Не «когда-нибудь опишем»: материал портится
быстро. Опыт этого каталога: правила месячной давности приходилось
восстанавливать по документам, потому что в памяти их уже не было.

Полностью — 080.

Язык

Каталог ведётся на двух языках, rules/ru/ и rules/en/, с одинаковыми
именами файлов — поэтому ссылки между правилами разрешаются одинаково в обоих
деревьях.

Указатель rules/README.md — один на оба языка и
собирается скриптом из самих файлов. Правило, добавленное только на одном языке,
сборку не проходит: это и есть механизм, не дающий деревьям разойтись. Два
отдельных указателя такого не дают — каждый выглядит полным сам по себе.

Чем держится правило у потребителей

Собирается прогоном из export/where.json — ответов самих проектов, а не нашей оценки их. Строка на проект, колонки друг под другом: сравнивать глазом можно только то, что стоит на одном месте. Колонка называет сколько правил держится каждым механизмом — доля, которую надо мерить глазом, не читается никак; подпись стоит один раз в шапке и цветом связана со своими числами. Последняя колонка, «не проверяется», складывает два ответа в один: «механизма нет» и «правило к нам не относится». Порознь они обещают разное — долг и решение, — но исполнение не проверяется ни там ни там, а вердикт «не относится» уже был опровергнут четырежды. Разложить сумму можно в таблице. Третье число, «родил», отвечает на другой вопрос: не как проект каталог потребляет, а сколько правил у него родилось. Каталог общий, но растёт неравномерно. Подробно, включая «кто уже решил то, что у соседа не держится ничем», — export/where.md.

В этой сводке нет вас — и каталог об этом не узнает сам. Правила берут без
спроса, они публичны; но обратную сторону — ваш ответ по каждому правилу и ваши
предложения — читать неоткуда, пока адрес не назван. Каталог наружу не пишет и
не ищет: сказать о себе может только сам проект,
заявкой.

Лицензия

Записи, витрина и заготовки-документы — CC BY 4.0: берите, меняйте,
используйте, оставьте ссылку. Скрипты, прогоны и исполняемые заготовки —
MIT: Creative Commons сама не советует свои лицензии для
программ, а заготовки здесь предлагается запускать.

Данные потребителей каталог цитирует с именем проекта и не перелицензирует;
условия — в контракте потребления.