Уровень команды on AI Coding Playbook

Командные процессы

Wed, 01 Jan 2025 00:00:00 +0000

Здорово иметь на уровне команды определённые базовые процессы и правила работы с ИИ-агентами. По мере роста опыта у каждого появятся какие-то свои фишки и паттерны, но лучшие практики всё равно желательно выносить на уровень команды или даже всей компании. В этом разделе мы даём некоторый стартовый фреймворк, с которого можно начать.

Какие есть челленджи при использовании ИИ на уровне команды:

Как сделать, чтоб каждый не изобретал свой велосипед для решения одних и тех же проблем?
Как не превратить репозиторий в ИИ-слоп?
ИИ может значительно ускорить каждого отдельного разработчика. Как в этой ситуации сделать, чтоб они не начали мешать друг другу (дублирование работы; смены контрактов, интерфейсов и тестов; генерация несовместимых кусков кода)?

Становятся ещё более важными традиционные командные процессы:

Работа над задачами

Wed, 01 Jan 2025 00:00:00 +0000

Разные задачи всегда требовали разных процессов. Для мелкой некритичной задачи можно сделать коммит, прогнать тесты и в бой, а где-то нужна декомпозиция, дизайн-ревью, долгие эксперименты. С ИИ-агентами ситуация принципиально не меняется, рекомендуется использовать разные процессы в зависимости от задачи. Эти правила можно закрепить на уровне команды. Например:

Простая задача - как угодно любым способом, просто промпт в сессии. Остальные обязательные командные процессы (автоматические тесты, код-ревью и так далее) соблюдаются
Сложная задача - описываем задачу по командному шаблону (например, с помощью специального скилла вместе с ИИ-агентом)
Большое архитектурное изменение или новый проект - можно попробовать специальные подходы к планированию и дизайну - типа planning-with-files или BMAD-Method
Автономная задача - используем специальные подходы Ralph Loop, Getting Shit Done, etc.
Повторяющаяся задача - используем/создаём скилл или субагента, коммитим в репу

Пример процесса для сложной задачи

Каждая задача для ИИ-агента должна быть сконвертирована в описание по шаблону, например:

AI-friendly документация

Wed, 01 Jan 2025 00:00:00 +0000

Документация для машин

В современной разработке появился новый потребитель документации - это ИИ-агенты. Ранее главной входной точкой в репозитории являлся файл README.md, который служит общим описанием того, зачем репозиторий нужен и как им пользоваться. Многие важные для ИИ-агента вещи в репозитории часто отсутствуют, потому что либо лежат где-то в другом месте, либо в головах у людей:

политики по написанию кода
разрешенные инструменты и библиотеки
бизнес-смысл и архитектура проекта
контекст по работе продукта и ранее принятые решения

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