Architecture Simplicity Guard: проверка планов реализации на оверинжиниринг
Бывает, попросишь агента составить план реализации. Задача вроде небольшая, ничего особенного. Через десять минут у тебя дополнительные роли, ключи, снапшоты и проверки. Сам попросил помочь, какие теперь претензии.
Из таких историй и появился Architecture Simplicity Guard. Это скилл, который проверяет архитектуру на этапе подготовки плана реализации, ДО начала кодинга.
▶ Разбирается, какие механизмы нужны для текущей задачи. Почему ещё один сервис? Зачем отдельные доступы, если подходят существующие? Что даёт эта проверка, кроме возможности не пройти ещё одну проверку? На «пригодится в будущем» просит обоснование. Будущее пока требований не присылало.
▶ Предлагает упрощения, в том числе другой подход к задаче. Если ради этого нужно изменить поведение продукта, объясняет последствия и оставляет выбор человеку. Ранее согласованные решения тоже можно пересмотреть, когда обнаружились проблемы. Бывает, одобрил архитектуру, а потом с ней познакомился поближе.
Инструкции адаптированы под модели OpenAI, Kimi и Anthropic. Если используете Agent Flow в Codex, Guard уже включён в его работу.
Адаптация под модели Anthropic сделана исключительно по документации и пока не тестировалась. Буду рад обратной связи от тех, кто попробует: замечания разберу и постараюсь оперативно внести исправления.
Пример запроса:
Проверь этот план через arch-simplicity-guard. Что можно убрать или сделать иначе, чтобы решить задачу проще?