ITTales :(){ :|:& };:

Чему меня научили десятки AI-агентов: как я в качестве эксперимента написал хранилище Blockstor

Многие просили меня рассказать каким образом я в одиночку навайбкодил аналог LINSTOR для Kubernetes. Получилась довольно интересная история.

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

https://habr.com/ru/companies/aenix/articles/1068652/

Я всё ждал какого-то RFC или общепринятого стандарта на трейлеры описывающие использование AI-агентов в ваших коммитах.

Из практики нескольких крупных проктов:
- Linux Kernel
- Fedora
- LLVM

Популярность получил Assisted-By:

В Kubernetes однако же есть строгий запрет на любые трейлеры, включая этот. А при создании пулреквестов вас обязывают расскрыть использование AI в явной форме.

И теперь я понял почему. Согласно правовой системе США, под которую попадают и все проекты CNCF, ваш код помеченный трейлером
Co-Authored-By: Claude
который Claude Code так заботливо штампует во все ваши коммиты, автоматически распространяет права на этот код и Антропику. То есть, согласно законодательству, он может реально на него претендовать.

По данной проблеме заведён issue, предлагающий заменить Co-Authored-By на Assisted-By, но антропики кажется не торопятся.

Факт остаётся фактом, единого стандарта до сих пор нет, но Co-Authored-By им точно не станет. А пока что предлагаю поддержать инициативу и перестать использовать Co-Authored-By для AI-агентов в своём коде.

Лично я переключаюсь на Assisted-By по умолчанию.
Но и конечно же читайте правила проекта, как оформлять свои коммиты для контрибьюта во внешние проекты.

Следующая мысль - это агенты, visibility это хорошо, но я не хочу следить за агентами, я хочу чтобы агенты работали сами и приходили ко мне с вопросами.

К чему я хочу стремиться? - Мне нужен условный Meeseeks Box 🗳 с красной кнопкой. Я нажимаю на кнопку появляется Mr. Meeseeks, говорю что оно мне нужно и дальше он бежит и делает задачу пока не выполнит.

Каждый Mr. Meeseeks живёт только для того чтобы выполнить задачу, он чуствует себя плохо если не может завершить её в срок. При необходимости Mr. Meeseeks может сам вызвать других Mr. Meeseeks чтобы они помогли ему с решением проблемы.

(отсылка к Рик и Морти)

Забавно но кто-то по мотивам мульт-сериала уже создал агента и скилл для Claude Code.

Применять в продакшене я это, конечно, не стал, но я пошёл дальше и начал работать над созданием оркестратора над claude agents.

Что я понял для себя: мне нужен mcp-сервер для claude-agents и набор инструкций как с этим работать.
Мне нужна одна управляющая сессия которая будет меня менеджерить и дать возможность ей работать с агентами, запускать, общаться, переименовывать точно так же как это делаю я.

Другими словами меняем push модель на pull

В качестве интерфейса с человеком - это по прежнему чат, здесь ограничение вызвано в первую очередь мной (человеком) и моей пропускной способностью.
Я не смогу следить за 20 агентами и при этом сохранять контекст, мне нужен менеджер, который будет этим управлять.

В итоге родился
https://github.com/kvaps/claude-agents-mcp
Теперь клод может самостоятельно работать с сессиями, а я могу оперативно подключиться к ним и проконтроллировать его работу

Итак находка первая - это claude agents
https://code.claude.com/docs/en/agent-view

Как оказалось в официальном claude code есть так называемый agent view.

Его изначальное предназначение - это менеджер долгоживущих background-сессий.
Так получилось что именно такие я и использую. Абсурд ситуации дошёл до того что мне проще переиспользовать существующую сессию чем заново объяснять контекст в новой. Но таких постоянных сессий у меня около 10 штук.

Так вот что бы в этом всём этом бардаке не теряться claude agents позволяет выводить их все на одном экране, переименовывать, видеть статусы и переключаться между ними.

Я даже перестал использовать свой плагин для tmux который выводит статусы в таб, и настроил себе алиас:
alias ca='claude agents'

Сейчас я запускаю клод только таким образом. Что удобно, в случае запуска новой сессии через claude agents, клод автоматом подхватывает директорию проекта, в которой я сейчас нахожусь, но в то же время я в любой момент могу нажать ← и увидеть список всех других сессий запущенных таким же образом в других проектах. Я могу быстро переключиться меду ними или даже закрыть окно, и вернуться к нему позже. Сессии продолжат работать в бэкграунде.

В итоге все мои сессии живут долго, переживают перезапуск компа, а я оперативно вижу все статусы и если агент требует моего внимания.

/me в очередной раз взглянув на свою колонку In Progress на рабочей доске (задачи на сегодня) взргустнул и подумал нужно эвулюционировать и продолжать оркестрировать свою работу дальше.

Всё сводится к тому что нужно строить свой собственный meta-harness над claude code.

Все предпосылки к этому уже выполнены:

- уже давнее время мы собираем транскрипты всех встреч в компании, они дают отличный артефакт для постановки задачи и начала работы.
- пачка MCP-серверов уже настроены во всевозможные каналы (google workspace, github, telegram, slack, read.ai) и прочее, могут постить от моего имени, забирать и отправлять документы.
- как жить с 4+ сессиями и не сойти с ума? И вот тут поподробнее

Когда эта проблема возникла, я начал ресёрчить, первым же делом я обратился к коллегам, в частности к @xor_dev (тимлиду нашей reliability команды по Cozystack)
У которого, в виду загруженности и разрозненности задач такая проблема была испокон веков.

Ваня постоянно поддерживает контекст с десятками клиентов и контроллирует работу команды.
Для того чтобы контекст не разъезжался, в первую очередь у него в голове, он сделал свой тул - Grimoire, который содержит в себе базу данных по каждому проекту и клиенту, и позволяет запускать сессии Claude Code прямо в браузере. Через стартовый промпт он сразу инструктирует их куда и как складывать контекст, откуда его вычитывать и как работать с этой системой.

В отличие от Obsidian вся история чуть-более интерактивная и крутится вокруг заметок. Каждая заметка - это своего рода entrypoint для входа в интерактивную сессию.
В интерфейсе можно выбрать заметку и запустить из неё нового агента, который уже будет знать весь необходимый контекст и обогощать общую базу знаний.
Исходники Grimoire доступны на GitHub: https://github.com/IvanHunters/grimoire

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

Следующие несколько постов будут именно про это.

Ralph Wiggum простыми словами: цикл в Claude Code, который не останавливается (перевод)

https://habr.com/ru/companies/aenix/articles/1041372/

Последний мейнтейнер

Недалёкое будущее. В каждом GitHub-репозитории появилась программа-хранитель. Он отвечает на issues, обновляет зависимости, пишет код и годами поддерживает проект почти без участия людей.
Казалось бы, что могло пойти не так?

https://habr.com/ru/articles/1041332/

Третья часть серии про внутренности controller-runtime и Kubernetes API.

Теперь поговорим про жизненный цикл объектов в Kubernetes. Что происходит между kubectl apply и записью в etcd? Как работают admission webhooks, ownerReferences, финализаторы и Garbage Collector? Почему объекты застревают в Terminating и как Kubernetes выполняет каскадное удаление? Эволюция CRD от v1alpha1 до v1, conversion webhooks и совместимость между версиями API.

https://habr.com/ru/companies/aenix/articles/1040618/

Для тех кому интересно что из этого в итоге вышло, вчера выехала первая версия Blockstor. Пайплайн готов, тест кейсы собраны. Развлечение на вечер пятницы обернулось приключением на три недели. Но весь необходимый функционал был реализован, включая DRBD, ZFS, LVM, шифрование, снапшоты, совместимость с linstor-клиентами была сохранена.

Анонс на опеннете:
https://www.opennet.ru/opennews/art.shtml?num=65546

Исходники проекта:
https://github.com/cozystack/blockstor

Присоединяйтесь к разработке и тестированию

Вторая часть серии про внутренности controller-runtime и Kubernetes API — теперь про запись.

Если в прошлый раз говорили про кэш, watch'и и чтение объектов, то теперь разберём: как работает three way merge и server side apply, зачем нужны managedFields, как apiserver хранит ownership полей.

И главное — как всё это позволяет нескольким контроллерам безопасно менять один объект одновременно.

https://habr.com/ru/companies/aenix/articles/1039282/