Главная / Как это работает
Слой памяти и контроля между вашим кодом и ИИ-агентами
AI Council разбирает репозиторий и тикеты, хранит решения и правила команды, привязанные к коду, и отдаёт агенту то, что нужно для текущей задачи. База пополняется в работе и сама следит за своей актуальностью.
Как это работает, за 12 минут 37 секунд
Демонстрация на открытом проекте Keycloak: от вопроса по реальному тикету до ревью ветки и ответа аналитику.
- 0:00Потерянные знания и повторяющиеся ошибки
- 1:04База знаний проекта
- 4:35Правила проекта
- 5:39Вывод правил из базы знаний
- 7:05Как работает агент с базой знаний
- 8:59Пример работы с задачей
- 10:05Проверка изменений и параллельная работа
- 11:25Автоматизация запуска проекта
Три слоя и выборка без LLM
Граф кода строится статическим анализом, без модели. Векторный поиск находит близкое по смыслу. Отдельный слой хранит то, что из кода не вывести: решения, причины, правила. Агент получает доказательства — фрагменты и правила целиком, а не пересказ.
Знания привязаны к коду
Правило в AI Council — это разобранный случай: что случилось, как это заметили и как теперь делать. Запись о решении указывает на модули и функции, к которым относится.
- Решения, заметки, схемыПочему платежи идут через очередь, какой вариант пробовали и отбросили, как устроен поток запроса. Схемы хранятся рядом с текстом.
- Разборы тикетовЗадачи из GitHub Issues и Redmine импортируются и разбираются: причина, затронутые файлы, статус.
- Документы и связанные проектыК проекту подключаются документы и соседние репозитории, если задачи затрагивают несколько систем.
- Правила командыУровни MUST и SHOULD, область действия: проект, путь или сущность. Правило можно адресовать только ревью.
Агент получает контекст сам
MCP-инструменты агент вызывает не всегда. Поэтому основной канал — хуки агента в Claude Code и Codex: знания и правила приходят на событиях, без запроса.
- Весь свод правил на стартеВ начале работы агент получает все правила уровня проекта целиком. Перед каждым промптом они повторяются по ротации, её частота настраивается.
- Правила и знания для файлаКогда агент открывает или меняет файл, приходят правила по привязкам к этому пути и сущности, знания, привязанные к коду, известные смеллы.
- Без лишнегоСлишком широкие привязки отбрасываются. Если знаний много, они встают в очередь и приходят при следующем вызове инструмента. Уже полученное повторно целиком не присылается.
- KB-first gateПока сессия не обратилась к базе знаний, чтение и правка кода отклоняются. Агенту достаточно запросить знания, чтобы пройти гейт. Отключить гейт может человек.
Знания живут на линиях git
Задача — это git‑ветка. Знания одной задачи не попадают в другую до merge, после merge переходят в целевую ветку. Правила при этом общие для всего проекта: на ветках живут только знания.
Знания проверяются на актуальность
Если код под записью сдвинулся, сама запись изменилась, появилась похожая или слилась ветка, запись уходит на проверку. Модель-ревьюер работает только на чтение и ставит метку с дословной цитатой из источника: «устарела», «расходится с кодом», «заменена», «оспорена». Текст записи не меняется, человек видит метки в журнале и может отменить любую.
Ревью веток по правилам проекта
- Те же правила, что у агентаИзменения сверяются с правилами, которые агент получил перед правкой.
- Три состояния веткиPassed, Blocked с перечнем проблем, которые нужно исправить до слияния, и «устарело», если в ветку пришли непроверенные коммиты. Слияние физически не запрещается: последнее слово за человеком.
- Цитата вместо номера строкиМодель цитирует код, строка вычисляется из цитаты. По каждому файлу ревьюер обязан сказать «проверил» или «не смог, потому что».
Разработчик остаётся в привычной среде
AI Council подключается к Claude Code, Codex и другим агентам с поддержкой MCP. IDE, агента и трекер менять не нужно. Модельная часть работает через Claude Code CLI: к нему можно подключить и другую модель, в том числе open source на ваших серверах.
- Рабочее пространство задачиАгент работает в отдельной среде задачи, изменения видны в интерфейсе в реальном времени.
- Рецепт запуска проектаКак поднять проект и как его проверить, агент записывает сам после успешного запуска. Следующий агент берёт рецепт готовым.
Проектный чат для всей команды
- Для аналитика, QA и поддержкиВопрос задаётся обычным языком, ответ строится по коду и тикетам, со схемами и ссылками.
- Ответ становится знаниемНовый ответ сохраняется с привязкой к коду, и в следующий раз никого не отвлекают тем же вопросом.
- Доступ по ролямПроекты и компании разделены, каждая роль видит то, что ей разрешено.
С чем работает
| Что | Поддерживается |
|---|---|
| ИИ-агенты | Claude Code, Codex и любой агент с поддержкой MCP |
| Модели | Через Claude Code CLI, в том числе open source на ваших серверах |
| Языки | Python, TypeScript и JavaScript, Java, Kotlin, C#, C, C++, PHP |
| Git | GitLab и GitHub, включая merge requests |
| Трекеры | GitHub Issues, Redmine |
| Развёртывание | Облако или ваш сервер, в том числе закрытый контур |
Посмотрите цикл на задаче, похожей на вашу
На живом демо покажем работу платформы на реальном проекте, а не шаблонную презентацию.