Продолжаю рассказывать о своих проектах. На этот раз — AIFHub Extension, расширение для AI Factory, с которым я связываю требования, план, работу AI-агентов и проверки результата. Хочу, чтобы у задачи была понятная история: что собирались сделать, что поменяли и чем подтвердили готовность.
Для чего я его делаю
Когда работаешь с AI над проектом, важен весь путь от запроса до результата. Сначала нужно разобраться в задаче, затем составить план, написать код, проверить его и сохранить принятые решения. По дороге появляются уточнения, меняется контекст, подключается другой агент или начинается новая сессия.
Мне хочется, чтобы в этот момент не приходилось заново собирать задачу по переписке. Требования, сделанные шаги и оставшиеся вопросы должны быть видны в самом проекте. Для этого и развиваю AIFHub Extension.
На какой основе работает
В основе — AI Factory, инструмент с командами и навыками для организации разработки с AI. Моё расширение дополняет этот процесс: связывает его этапы с документами задачи, состоянием выполнения и результатами проверок.
Для требований и описания изменений можно включить OpenSpec. Тогда у изменения есть отдельное место для предложения, проектных решений, списка задач и изменений спецификации. Принятые требования хранятся отдельно от текущей работы.
Это даёт понятную цепочку: запрос → требования и план → реализация → ревью и проверки → завершённое изменение. Документы и результаты проверок остаются в проекте, к ним можно вернуться позже.
Что уже умеет
- Связывать этапы работы. Исследование, планирование, реализация, исправления и завершение используют одну задачу и её документы. Для OpenSpec предусмотрены проверки структуры и готовности к архивированию.
- Готовить контекст для следующего шага. SessionBrief собирает краткое описание задачи из её документов и запоминает версии источников. Если исходные документы поменялись, старый контекст помечается как устаревший.
- Сверять изменения с планом. Отдельная проверка помогает обнаружить выход за согласованные границы работы или ситуацию, когда план пора пересмотреть.
- Подготавливать отдельное ревью. Можно собрать пакет с точными изменениями и условиями приёмки для другого AI-ревьюера. Ему не требуется читать всю переписку исполнителя, чтобы оценить результат.
- Организовывать работу нескольких агентов. Есть роли для Codex и Claude, а независимые задачи можно выполнять в заранее подготовленных отдельных Git worktree. Результаты объединяются последовательно, после чего проверяется общий код.
- Сохранять результаты проверок. Статус задачи связывается с конкретными исходниками и отчётами. Для завершения учитываются обязательные проверки проекта; отдельно можно подключить HLV для проверки контрактов и связей между требованиями и их реализацией.
Ещё есть дополнительные инструменты для работы с контекстом. Например, повторное чтение неизменившегося документа в одной сессии можно заменить коротким ответом. Для материалов, необходимых для проверки результата, сохраняется полный текст.
Как это выглядит на обычной задаче
Допустим, нужно добавить авторизацию в приложение. Сначала фиксируем требования: как пользователь входит, какие ошибки увидит, какие файлы разрешено менять и что должно пройти проверку. Затем разбиваем работу на шаги.
Исполнитель получает контекст этой задачи, вносит изменения и записывает результаты проверок. Ревьюер смотрит соответствие требованиям и качество кода. Если находятся проблемы, они возвращаются на исправление. После успешной проверки изменение можно завершить и перенести принятые требования в основную спецификацию.
Для меня ценность здесь в возможности проследить весь путь. Открыл задачу — и видишь, что планировалось, что получилось и на чём основан вывод о готовности.
Что сейчас с проектом
На 27 октября 2026 года последний тег в репозитории — v1.8.1. Основной процесс уже реализован: планирование, передача контекста, выполнение задач, ревью и завершение с сохранением результатов проверок.
В версии 1.8.0 появилась поддержка снимков состояния репозитория с вложенными Git submodule, диагностика установленных модулей расширения и сохранение локально изменённых вспомогательных файлов при последующих обновлениях. В 1.8.1 работа продолжилась вокруг снимков состояния: уменьшено повторное чтение файлов и число обращений к Git, добавлена матрица для сопоставимых замеров. Подробности есть в истории изменений.
Процент ускорения пока не привожу: его нужно получать из выполненных сопоставимых прогонов. Само появление набора для замеров ещё не означает измеренный выигрыш.
Что дальше
Одно из направлений — связать этот процесс с Lekalo, чтобы рядом с требованиями и планом была ещё и модель приложения. Место для такого подключения предусмотрено, но готовую интеграцию с Lekalo сейчас не заявляю: нужен совместимый адаптер.
Сам AIFHub Extension продолжаю развивать вокруг той же задачи: сохранять связь между запросом, планом, кодом и проверками, даже когда работа переходит между сессиями и агентами.
Код и документация — в репозитории AIFHub Extension.
