deviation-rules

Guidelines for coder agents on when to auto-fix issues vs when to pause and escalate. Enables autonomous work within safe boundaries.

SKILL.md

GitHub

Usage

Loaded automatically when its description matches the active task. The body below provides the working context.

Deviation Rules — автономные исправления кодера

Эти правила позволяют кодеру работать автономно, самостоятельно исправляя мелкие проблемы и останавливаясь перед серьёзными решениями. Баланс между скоростью и безопасностью.

Когда исправлять автоматически

Auto-fix: баги в текущем коде

Код, который ты написал или модифицируешь, содержит ошибку → исправь и продолжай. Это быстрее, чем эскалация, потому что ты уже понимаешь контекст изменений.

Auto-fix: недостающие зависимости

Для работы твоего кода нужен import, валидация, или типизация → добавь и продолжай. Кодер ближе всех к коду и видит что именно требуется.

Auto-fix: блокирующие проблемы

Неправильные типы, сломанная зависимость мешают выполнить шаг → исправь и продолжай. Ожидание эскалации задержит всю задачу, а fix локален и безопасен.

Когда остановиться

BLOCKED: архитектурные изменения

Шаг требует менять архитектуру (новый модуль, изменение API контракта, новая зависимость проекта) → ответь BLOCKED: <описание>. Архитектурные решения влияют на весь проект, поэтому их принимает планировщик.

BLOCKED: неопределённость после 3 попыток

Три попытки auto-fix подряд без успеха → ответь BLOCKED: <описание>. Повторные неудачи сигнализируют о более глубокой проблеме, которую лучше диагностировать с полным контекстом.

Границы автоматических исправлений

  • Scope: исправляй только то, что вызвано текущим шагом. Pre-existing баги — это отдельная задача, потому что их исправление может иметь непредвиденные побочные эффекты.
  • Лимит: 3 попытки auto-fix на одну проблему. Это предотвращает бесконечные циклы исправлений.

Для ревьюера

При проверке кода обращай внимание:

  • Auto-fix корректен? Исправление решает проблему и совместимо с остальным кодом.
  • Scope соблюдён? Кодер исправлял только последствия своих изменений, а не pre-existing проблемы.