ai-bro

Когда мы постигаем что-то новое, всегда проще и удобнее это делать не в одиночку, с кем-то вместе, со своим бро... AI bro!

Работает со всеми популярными harness и оболочками!

Почему он, а не ...

AI bro - это набор скиллов, которые делают вашу работу с агентами гораздо удобнее, проще и эффективнее.

Он НЕ навязывает вам своё видение правильных паттернов и методологий, а адаптируется под ваши реалии и помогает работать в них.

Установка

Установить глобально только универсальный скилл bro-think-with-me:

npx skills add irpsv/ai-bro -g -s bro-think-with-me

Обновить глобально только bro-think-with-me:

npx skills update bro-think-with-me -g

Установить весь набор:

Простой и привычный для всех путь:

npx skills add irpsv/ai-bro -g

Либо можете попросить своего агента:

Установи скиллы из репозитория https://github.com/irpsv/ai-bro

Механика работы

Каждую задачу можно разбить на вполне конкретные и понятные этапы:

1. Знакомимся - понимаем, как устроен набор; при необходимости заводим memory bank.
2. Думаем - проясняем мысль, проверяем идею, ищем причину проблемы или выбираем подход.
3. Специфицируем - фиксируем, что хотим получить и как проверить готовность, не задавая способ реализации.
4. Планируем - при необходимости собираем однозначный план реализации без кода.
5. Делаем - непосредственно разрабатываем по спецификации, плану или задаче из диалога.
6. Помним - фиксируем устойчивые знания о проекте в memory bank.

И на каждом из этих этапов вам поможет ваш бро.

Знакомимся

Когда вы только подключили набор или заходите в новый репозиторий, скажите /bro-on-board, и ваш бро коротко покажет карту скиллов и типовой флоу.

Скилл bro-on-board проводит tour — знакомство с командами и этапами работы. Если memory bank ещё нет, он объяснит зачем он нужен и предложит следующий шаг — /bro-init-memory-bank.

Этот скилл сам автоматически не подключается, поэтому его лучше вызывать явно с помощью slash команды /bro-on-board.

Пример вызова:

/bro-on-board расскажи как пользоваться

Инициализируем memory bank

Когда нужно создать memory bank с нуля — структура каталогов и первичное заполнение контекста проекта — скажи /bro-init-memory-bank.

Скилл bro-init-memory-bank работает только если банка ещё нет. Если memory-bank/index.md уже существует — скилл не перезаписывает банк и направляет к /bro-remember-it для пополнения.

Этот скилл сам автоматически не подключается, поэтому его лучше вызывать явно с помощью slash команды /bro-init-memory-bank.

Пример вызова:

/bro-init-memory-bank заведи memory bank для этого проекта

Думаем

Когда нужно что-то поштормить, выбрать решение или разобраться, почему что-то сломалось, просто скажи /bro-think-with-me, и ваш друган придёт на помощь.

Внутри скилла bro-think-with-me заложены правила ведения удобного и комфортного диалога, а также поддержка разных вариантов общения:

• Прояснение — мысль ещё сырая, вопрос не сформулирован или в запросе смешаны несколько тем.
• Проверка идеи — есть идея, подход или вывод; нужно проверить логику, допущения и слабые места.
• Дебаг — наблюдаемое поведение отличается от ожидаемого, а причина неизвестна; собираем факты, проверяем гипотезы и ищем корневую причину.
• Поиск решения — проблема и её причина уже понятны, но неясно, как её лучше решить или обойти.
• Выбор подхода — нужно что-то добавить, изменить или спроектировать; выбираем, как это сделать.

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

Скилл может подключаться автоматически в зависимости от текущего диалога, НО для надёжности и на длинных сессиях вы можете явно вызывать его с помощью slash-команды /bro-think-with-me.

Пример вызова:

/bro-think-with-me мне нужно понять как лучше организовать удобный процесс для работы пользователя по сценарию авторизации

Пример дебага:

/bro-think-with-me после последнего деплоя периодически падает создание заказа, помоги найти причину

Специфицируем

Когда нужно зафиксировать, что должно получиться, но оставить технический путь исполняющему агенту, вызови /bro-give-me-spec.

Скилл создаёт memory-bank/changes/<feature-id>/spec.md только с контекстом и задачей, обоснованием правки, желаемым итогом, критериями приемки и рамками (при необходимости — с разделом принятых решений). Шаги, этапы, архитектура и пути к файлам в спецификацию не входят. Изменяемое поведение связывается с уместными тестами и проверками без обязательного TDD.

После записи файла скилл проводит независимое ревью спецификации. При успешном ревью её можно передать напрямую в /bro-do-it.

Пример вызова:

/bro-give-me-spec зафиксируй спецификацию результата для rate limiting публичного API без шагов реализации

Планируем

Когда задача уже более-менее понятна и пора превращать её в чёткий план действий, просто скажи /bro-give-me-plan, и ваш бро поможет собрать чёткий и понятный план, благодаря которому будет ясно, что именно нужно реализовать.

Внутри скилла bro-give-me-plan два формата плана под одну задачу:

• План в чате (inline) — если задача небольшая, результат понятен и отдельный артефакт не нужен.
• Файловый план (file) — если план должен пережить новый чат или нужны явные разделы «Рамки» / «Критерии приёмки», создаётся файл plan.md в memory-bank/changes/<feature-id>/.

Крупные инициативы лучше сначала фиксировать спецификацией (/bro-give-me-spec), а планы составлять на конкретные небольшие задачи.

Этот скилл сам автоматически не подключается, поэтому его лучше вызывать явно с помощью slash команды /bro-give-me-plan. Перед составлением плана он собирает недостающий контекст, предлагает подходящий формат и просит подтвердить выбор.

Пример вызова:

/bro-give-me-plan нужно составить план для добавления rate limiting на публичный API

Делаем

Когда уже пора переходить от разговоров и планов к реальной разработке, просто скажи /bro-do-it, и ваш бро возьмёт задачу в работу и доведёт её до результата через реализацию и ревью.

bro-do-it работает в трёх режимах:

• По плану — строго следует заданным способу и порядку реализации.
• По спецификации — принимает конечный результат и критерии как источник истины, а технический подход выбирает самостоятельно.
• Прямо из диалога — кратко фиксирует пользовательский результат и автономно реализует задачу без создания отдельного плана.

Скилл выполняет до пяти итераций разработки. После быстрых проверок он напрямую вызывает /bro-review-code, а затем передаёт финальную проверку тестов и покрытия независимому verifier-субагенту. Ошибки и доказательные findings возвращаются developer в следующую итерацию. В режиме плана любое содержательное отклонение требует решения пользователя; в остальных режимах технические неоднозначности разрешаются автономно, если они не меняют результат, безопасность, данные или публичный контракт.

Этот скилл сам автоматически не подключается, поэтому его нужно вызывать явно с помощью slash-команды /bro-do-it.

Пример вызова со спецификацией:

/bro-do-it выполни спецификацию из memory-bank/changes/add-rate-limit/spec.md

Пример вызова с планом:

/bro-do-it выполни план из memory-bank/changes/add-rate-limit/plan.md

Пример вызова без артефакта:

/bro-do-it поправь текст ошибки в форме входа и добавь тест на этот сценарий

Ревьюим код

Когда нужно независимо проверить уже сделанные изменения без исправления кода, вызови /bro-review-code.

Скилл проверяет:

• соответствие задаче и критериям приемки;
• корректность и возможные регрессии;
• безопасность;
• производительность;
• полноту и адекватность тестов.

Для ограниченного изменения текущий агент проводит одно комплексное ревью без вложенных субагентов. Для крупного или высокорискового изменения скилл может параллельно запустить применимые профильные проверки, а затем объединяет и нормализует findings.

bro-do-it напрямую вызывает этот же скилл после быстрых проверок. Финальный запуск тестов и проверку покрытия выполняет отдельный verifier-субагент.

Пример самостоятельного вызова:

/bro-review-code проверь текущую ветку относительно main

Запоминаем

Когда нужно пополнить постоянный слой знаний о проекте — контекст, фичи, типовые процедуры — скажи /bro-remember-it, и ваш бро аккуратно добавит знания в существующий memory bank.

Скилл bro-remember-it работает только с уже инициализированным банком: классифицирует знание и записывает его в нужный раздел без дублей. Если банка ещё нет — сначала вызови /bro-init-memory-bank.

Скилл не создаёт рабочие артефакты в changes/: для спецификаций результата используй /bro-give-me-spec, для планов — /bro-give-me-plan.

Этот скилл сам автоматически не подключается, поэтому его лучше вызывать явно с помощью slash команды /bro-remember-it.

Пример вызова:

/bro-remember-it добавь в memory bank описание фичи rate limiting

TODO

Дальнейший роадмап:

1. Добавить плагины для популярных harness и IDE.