Документация эффективнее памяти в виде RAG, но требует структурированных папок, индексов, правил доступа и привязки к коду. Агенты лучше работают с документами в /plans/, /knowledge/, /workbench/, чем с векторными хранилищами, где теряется контекст и данные устаревают. Документы должны быть стабильными и обновляемыми только с разрешения; заметки — эфемерными, чтобы отделить долгосрочное знание от временных мыслей. Индексные файлы (INDEX.md) и привязка документации к коду через ADR, CONTRIBUTING.md, CODING_STANDARDS.md делают знания доступными и проверяемыми. Агенты без доступа к bash используют JSON-память с экспирацией и приоритетами для мониторинга цен и сбоев CI/CD, где структуру определяет LLM. Общий каталог (например, agent-handoff) становится центром коммуникации: агенты обмениваются статусами, решениями и скриншотами. Извлечение семантических утверждений и построение деревьев причин (Whybase) с привязкой к коммитам и коду сохраняет логику решений без потери контекста. Папки как основной механизм хранения (через cd и /resume) — простое и эффективное решение при строгой нумерации и статичной структуре. Поли- и монорепозитории с централизованным хранением кода, документации и прототипов контролируют дрейф контекста и сохраняют историю решений. Агенты лучше работают с инструментами, отображающими доменные типы, чем с универсальными базами, где им приходится гадать о запросах. Документация, извлекаемая из GitHub, Slack, RFC, позволяет ссылаться на реальные источники, повышая точность действий. Сессионная история и простой grep по ней надежнее и дешевле по токенам, чем сложные RAG-системы, которые добавляют шум и стоимость без реальной пользы. Не следует позволять агентам писать в постоянные документы без контроля — это приводит к загрязнению знаний (как в .agents/notes-and-plans/). Линтеры с пояснениями в ошибках (например, для IOSP) дают детерминированную обратную связь, лучше случайных рекомендаций из памяти. Некоторые считают структурированные индексы и 'read-if' условия неумелой заменой умного поиска по тексту и требуют чего-то более интеллектуального, чем grep. Другие утверждают, что агентам нужны и документация, и несколько систем памяти, ссылающихся на документы, и что предложенное решение слишком упрощено.