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.mdskills/deviation-rules/SKILL.md
GitHubUsage
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 проблемы.