База знаний и поиск

База знаний собирает документы и решения проекта в одном дереве: то, что вы пишете руками, и то, что записывают агенты. Найти нужное в этой истории можно двумя путями: в облаке — по названию, а агенты и бот в Telegram ищут по смыслу, с учётом русской морфологии, так что «приёмка» найдёт и «приёмку», и «принятые».

Важно различать три места поиска. Одни работают в облаке для людей, другие — для агентов и бота. Ниже всё по порядку.

Где в облакеКопировать ссылку на раздел

Сайдбар «База знаний». Вверху две вкладки: «Документы» и «Система» (о ней — в Карте системы). Рядом в сайдбаре пункт «Журнал» с историей задач, отчётов и артефактов.

Что хранится в базе знанийКопировать ссылку на раздел

• Документы фичи — типы «PRD», «Руководство», «Справка» и «Release notes». Документ всегда привязан к фиче.
• ADR — архитектурные решения со статусами «Предложено», «Принято» и «Устарело». Статус меняется на странице решения. ADR можно привязать ко всему пространству, к релизу или к фиче.
• Артефакты журнала — спеки, планы, документы и решения, которые записали агенты. У ADR из журнала стоит пометка «из журнала».

Слева дерево: папки по фичам, релизам, «Всё пространство» и проектам журнала. Над деревом поле «Найти документ» (фильтр по названию) и кнопки «Все», «ADR» и «Документы»; выбранный фильтр запоминается. Справа — список или открытый документ.

Как создать документ или ADRКопировать ссылку на раздел

1. Нажмите «+» над деревом и выберите «Документ» или «ADR». Из фичи то же делают кнопки «Документ» и «ADR» на вкладке «Документы».
2. Документ. Укажите название и фичу (если фич нет, документ создать нельзя — сначала заведите фичу), выберите тип и пишите в редакторе. «Создать документ» сохранит его.
3. ADR. Заполните «Название решения», «Относится к» (всё пространство, фича или релиз) и разделы «Контекст» и «Решение». «Последствия» и «Альтернативы» необязательны. Нажмите «Создать ADR».

Создавать документы и ADR могут владелец и админ.

Как документы приходят от агентовКопировать ссылку на раздел

Агент записывает артефакт инструментом record_artifact. Виды spec, plan, doc и decision попадают в «Документы» с версиями («v1», «v2»). Вид adr превращается в настоящий ADR облака, если в тексте есть разделы «## Контекст» и «## Решение» (иначе запись отклоняется), а «## Последствия» и «## Альтернативы» добавляются по желанию. Повторная запись с тем же названием обновляет тот же ADR. Если указать task_id, решение привяжется к фиче этой задачи; до принятия задачи у него статус «Предложено», после — «Принято».

Правка в облаке не возвращается в журнал, а новая версия артефакта из журнала перезапишет ручные правки — об этом предупреждает пометка на странице.

ПоискКопировать ссылку на раздел

В облаке. Командная палитра (Cmd/Ctrl+K) ищет по фичам и задачам: введите от двух символов — название или ключ вроде ACT-12. Задачи агентов находятся по названию фичи и номеру «AI #N» или по id задачи журнала. Результаты сгруппированы на «Фичи», «Задачи» и «Задачи агента», а группа «Перейти» открывает основные разделы. Палитра ищет по подстроке, документы и решения она не показывает. Найти документ или ADR в облаке можно по названию через поле над деревом. На странице «Журнал» есть фильтры по проекту и статусу (вкладки «Задачи», «Инциденты», «Артефакты»), а при выборе задачи — полный текст задания, отчёт исполнителя, хронология и связи.

Для агентов. Инструмент search_precedents ищет по всему журналу: задачи (задания и отчёты), артефакты и инциденты. Он понимает морфологию русского и английского, поднимает выше результаты текущего проекта и показывает свежую версию артефакта. Агент использует его перед стартом работы, чтобы узнать о похожих задачах и принятых решениях. Подробнее — в справочнике MCP и разделе Журнал и статусы.

Для бота и AI. Облако индексирует фичи, задачи, ADR, документы, артефакты журнала и публичные запросы и ищет по ним и по словам, и по смыслу. Этим пользуются бот в Telegram, AI-продакт и AI-разбивка. Поиск по смыслу работает на ключе платформы и в квоту встроенного AI не входит.

Что не индексируетсяКопировать ссылку на раздел

Служебные артефакты журнала (acceptance:, release:, released:, brief:) в поиск не попадают. Код репозитория тоже не индексируется: ни облако, ни бот по коду не ищут.

Связь с журналом и агентамиКопировать ссылку на раздел

Решения и документы, которые агенты пишут в журнал, оказываются в базе знаний после синхронизации — то есть в одном месте с тем, что вы написали руками. Так следующий агент, который начнёт работу над связанной фичей, находит прежние решения через search_precedents и не повторяет чужих ошибок.