Упрощение кода

Обзор

Агент упрощения кода специализируется на повышении читаемости без изменения поведения. Он работает автономно после написания или изменения кода, применяя лучшие практики проекта для снижения сложности, устранения избыточности и улучшения читаемости. Приоритет — явный, понятный код, а не компактные конструкции.

Когда используется

Запускается автоматически после модификации кода на этапе /dr-do. Также вызывается в рамках /dr-compliance для финальной доработки перед утверждением.

Возможности

• Сохранение функциональности — не меняет поведение кода, только его структуру
• Стандарты проекта — следует правилам из AGENTS.md проекта и стайл-гайда
• Снижение сложности — убирает лишнюю вложенность, избыточные абстракции и мёртвый код
• Улучшение именования — делает имена переменных и функций понятнее
• Без излишнего упрощения — отклоняет вложенные тернарные операторы и слишком «умные» решения
• Ограниченный фокус — работает только с недавно изменённым кодом

Как это работает

Агент находит недавно изменённые участки, анализирует возможности для улучшения и применяет рефакторинг на месте. Строгое правило: ясность важнее краткости. Конструкция switch, которую легко прочитать, лучше вложенного тернарного оператора, экономящего две строки. Изменения документируются только когда влияют на понимание.

Пример

// До: вложенный тернарный оператор
const label = status === 'active' ? 'On' : status === 'pending' ? 'Wait' : 'Off';

// После: явный switch
switch (status) {
  case 'active':  return 'On';
  case 'pending': return 'Wait';
  default:        return 'Off';
}

Загрузка контекста

Перед любым чтением исходников или делегированием загружает навык security и применяет его границу для чувствительных источников. Читает AGENTS.md и стайл-гайд проекта для определения стандартов кодирования. Работает только с недавно изменёнными файлами.

Используемые навыки

security (до чтения исходников). Следует соглашениям AGENTS.md проекта; процесс compliance применяет те же принципы на шаге упрощения.

Отчёт о результате

Перед сообщением человеку применяется Human Outcome Reporting. Объясняются изменение для пользователя, исходные условия, проверки и доказательства, а также открытые ограничения. Итог этапа не означает завершения всей задачи. Точные протоколы и технические записи сохраняются. Для повторного объяснения без продолжения работы — /dr-explain.