[Перевод] Вашему ИИ‑агенту нужна карта: LLM Wiki или README достаточно

На платформе Хабр опубликована статья «Вашему ИИ‑агенту нужна карта: LLM Wiki или README достаточно». Материал подготовлен пользователем dykyi_roman и представляет собой перевод и практический обзор идеи, предложенной Андреем Карпаты в апреле 2026 года в gist под названием LLM Wiki.

В публикации отмечается, что традиционные подходы — RAG по сырым документам или вручную поддерживаемые вики — не справляются с накоплением и актуализацией знаний в больших системах. LLM Wiki предлагает минимальную структуру из трёх папок (raw, wiki, log) и трёх операций агента: ingest, query и lint. Агент самостоятельно пишет и обновляет страницы, а человек курирует источники и задаёт вопросы.

Автор реализовал подход на практике поверх платёжного ядра крупной платформы (DDD + CQRS, около 37 000 PHP-файлов). Вики размещена в .claude/wiki/, содержит 70 страниц и намеренно исключена из командной документации. Структура включает CLAUDE.md (конституция), index.md (маршрутизатор), log.md и разделы по контекстам, провайдерам, концепциям и сценариям.

Каждая страница вики следует строгому формату: фронтматтер с метаданными (verified, sources), вводный абзац, один уровень заголовков, раздел «Открытые вопросы» и лимит в 120 строк. Доступ к вики осуществляется через кастомную команду /wiki с семью подкомандами, включая seed, ingest, query, sync, verify, lint и status.

В статье сравнивается LLM Wiki с ранее описанным README-ориентированным подходом. Подчёркивается, что вики служит персональным слоем синтеза поверх модульной документации репозитория. Материал входит в рубрику «Искусственный интеллект» и отмечен как обзор и перевод.

Оригинальный gist Карпаты доступен на GitHub, а статья на Хабре опубликована недавно и уже набрала охват более 100 читателей.

Источник: https://habr.com/ru/articles/1063946/?utm_campaign=1063946&utm_source=habrahabr&utm_medium=rss