✦ Контекст-слой для AI-агентов
Вики, которую читают агенты —
до того как трогают код
Машиночитаемая карта монорепо. Прежде чем менять код, AI-агент — и человек — грепом находит нужную заметку: архитектурное решение, бизнес-правило или готовый рецепт. И грузит контекст, который иначе пришлось бы восстанавливать по крупицам.
Зачем это бизнесу
Знание о системе перестаёт жить только в головах
Пять рынков на одной кодовой базе — это годы решений и исключений. Вики превращает их в актив, который читается за секунды: и человеком, и AI-агентом.
Быстрее онбординг
Новый разработчик или агент не реверс-инженерит архитектуру по коду — читает готовую карту: почему так сделано и где границы.
Меньше регрессий
Бизнес-правила и мульти-рыночные исключения зафиксированы явно. Меньше шанс сломать то, о чём «знал только один человек».
Кодовая база готова к AI
Агенты работают точнее, когда грузят правильный контекст до правок. Вики — это интерфейс между кодом и агентом.
Как это работает через AI
Один вызов агента — с вики и без неё
AI-агент решает задачу в терминах смысла, а не путей файлов. Вики даёт ему первый ход, который иначе стоит десятков «слепых» грепов по коду.
Агент реверс-инженерит вслепую
- Грепает код по догадкам, читает десятки файлов, строит модель системы с нуля
- Не видит почему так сделано — архитектурные решения и мульти-рыночные исключения невидимы
- Копирует чужой паттерн, который устарел → пишет код, который не соберётся
- Пропускает «уже сделанную» работу или ломает то, о чём знал один человек
Агент грузит контекст первым ходом
- Один запрос к вики — по теме или по файлу — сразу ведёт к нужной странице
- Получает TL;DR, архитектурное «почему», бизнес-правила и точные пути в поле
code: - Идёт по рецепту, сверенному с кодом — контракты классов, реальные флаги, актуальные шаги
- Сверяется с кодом (истина — код) и обновляет заметку в том же PR
Два способа найти
Нужное находится с двух сторон
Знаешь тему — или уже открыл файл. В обоих случаях нужная страница находится сразу, без чтения кода по кусочкам.
По теме
«Ваучеры», «оплата», «поиск» — по названию задачи вики сразу отдаёт нужную страницу с её правилами и решениями.
По файлу
Открыл файл в коде — и сразу видишь, какие решения и бизнес-правила его касаются. Ничего не надо помнить наизусть.
Почему этому можно доверять
Вики не расходится с кодом молча
Код — истина, вики — контекст. Если что-то расходится — верим коду. Страница не может «переспорить» код, а обновляется вместе с ним.
Навигация собирается сама. Указатели и связи строятся из самих страниц — вручную ничего не поддерживают, поэтому рассинхрон исключён.
Синхрон проверяется на каждом изменении. Автопроверки сверяют страницы с кодовой базой; если что-то устарело — это видно сразу, а не спустя месяцы.
Проверено
Вики сверена с кодом — и держится в синхроне
Заметки прошли аудит из 80 AI-агентов — по агенту на заметку, каждый сверял её с реальным кодом. А автоматика не даёт вики разойтись: индексы генерируются из самих заметок, а CI сверяет ключевые числа с кодовой базой на каждом прогоне.
80 AI-агентов
Каждую заметку проверил отдельный агент против реального кода — независимая сверка за один прогон, плюс сквозные проверки схемы, ссылок и покрытия.
Схема и ссылки чистые
100% заметок проходят проверку схемы, ноль битых внутренних ссылок, детерминированный тулинг регенерации индексов.
Не расходится молча
Правило простое: код — истина, вики — контекст. Заметка обновляется в том же PR, что и код, а CI ловит рассинхрон.
Как пользоваться
Просто опиши задачу — остальное AI сделает сам
Не нужно вручную искать контекст. AI сам найдёт нужную страницу в вики, разберётся, как устроена фича — почему так сделано, какие правила и где это в коде, — и внесёт правки точно.