Документация компонента
Документация по компоненту: API, варианты, состояния, доступность, использование.
Handoff контекста: сохранить прогресс, переехать при необходимости
Сохранение прогресса в HANDOFF.md в конце каждой большой итерации: точечное обновление, проверенные цифры, ловушки. Плюс указатель в CLAUDE.md и хук, который сразу после автокомпакта напоминает модели перечитать HANDOFF. Новый чат — только по сигналам: заполненный контекст не повод.
Architecture Decision Record (ADR)
Зафиксировать архитектурное решение: контекст, варианты, выбор и trade-offs.
ADR-практика: lifecycle, что туда писать, что НЕ
Когда писать ADR (architectural, не каждый PR), формат, lifecycle (proposed/accepted/superseded), как сделать живым, что НЕ ADR.
Шаблон описания Pull Request
Что / зачем / как тестировать / риски / связанные ссылки / скриншоты. Ревьюер не должен гадать.
Runbook design checklist
Чеклист runbook'а: trigger, severity, первые 5 команд, диагностика, mitigation, эскалация, verification, что НЕ делать.