Перейти к содержанию

LLM Wiki — организация памяти проекта для агентов✦

Что это✦

LLM Wiki — паттерн организации памяти проекта для AI-агентов, предложенный Андреем Карпаты (один из основателей исследовательской группы OpenAI, с мая 2026 года — в Anthropic, где руководит исследованиями pretraining). Идея опубликована в виде «idea file» в GitHub Gist весной 2026 года. Вместо того чтобы грузить в контекст все документы проекта сразу или строить RAG на эмбеддингах, агент ведёт структурированную вики из markdown-файлов и ориентируется в ней по индексу.

Как работает✦

Ключевой элемент — индексный файл index.md, играющий роль оглавления: перечень всех страниц вики с однострочным описанием каждой, сгруппированный по разделам. Агент сначала читает только индекс, а затем открывает лишь те файлы, которые нужны для конкретной задачи. Так контекст не перегружается, а дорогая инфраструктура векторного поиска не требуется — по опыту автора подход хорошо работает на масштабе до ~100 источников и сотен страниц.

Структура делится на три слоя:

raw/        # исходники — неизменяемые входные материалы; агент их читает, но не правит
wiki/       # страницы, сгенерированные моделью:
            #   entities/  — сущности (в нашей сборке: входные данные компании)
            #   concepts/  — концепты (выводы и отчёты агентов)
CLAUDE.md   # схема: правила именования и работы с базой (в оригинале — CLAUDE.md / AGENTS.md)
index.md    # оглавление вики
log.md      # append-only журнал операций и истории изменений

Карпаты выделяет три операции: ingest (внести новый источник, обновив связанные страницы), query (найти нужные страницы через индекс и ответить со ссылками) и lint (периодическая проверка на противоречия, устаревшие факты и «осиротевшие» страницы). Файл log.md при этом хронологически, только на дозапись, фиксирует все загрузки, запросы и проверки.

Как применяли в команде✦

В нашей агентной системе на Claude Code (маркетинговый конвейер) вики стала общей памятью между стадиями: аналитические агенты писали отчёты в слой concepts, а следующие стадии читали их оттуда, не перечитывая исходники целиком. Внутри вики лежит собственный CLAUDE.md, описывающий работу именно с этой базой знаний (это и есть слой-схема). Поскольку страницы связаны wiki-ссылками, граф связей удобно смотреть в Obsidian — и человеку, и агенту, чтобы понять, какие файлы на какие ссылаются. Исходные документы после переноса в вики (в «агентном» формате) можно удалять — вики их дублирует.

Источники✦