Использование файлов Markdown в качестве системы памяти для AI-агентов программирования

Основной метод: Общение в файлах вместо окна чата

Разработчик использует Claude Code, но избегает стандартного интерфейса чата. Вместо этого он инструктирует агента создать файл {topic}_LOG.md, в котором ведутся и сохраняются все важные обсуждения. В окне чата он пишет только /response, чтобы указать Claude посмотреть текущий файл обсуждения и ответить там, оставляя чат для тривиальных побочных вопросов, не требующих сохранения.

Структура файлов и аннотации

Ответы обычно добавляются в конец LOG-файла, как в обычном чате, но комментарии также можно вставлять внутри текста, чтобы отвечать на конкретные моменты. Это особенно полезно для параллельного уточнения во время планирования проекта. Для ясности при повторном чтении все комментарии человека помечаются C:, чтобы отличать их от вклада Claude.

Архитектура двойной системы памяти

В дополнение к LOG-файлу Claude инструктируют создать и поддерживать файл {topic}_SUMMARY.md. Эта сводка содержит ссылки на исходный LOG с номерами строк, поскольку LOG часто становится слишком большим для размещения в памяти. Сводка действует как декларативная память высокого уровня, а LOG служит детальной процедурной памятью.

Запуск агента и управление памятью

Когда запускается новый агент или после сжатия, процесс следующий:

• Пользователь предоставляет контекст: "Ваша задача — продолжить обсуждение {topic}. Мы сосредоточимся на X."
• Агент читает {topic}_SUMMARY.md, чтобы понять, что важно
• Сводка указывает, где обсуждался X (например, строки 100-200 и 500-800 LOG)
• Агент загружает эти конкретные строки LOG плюс последние сто строк для свежего контекста
• Агент может автономно решать, когда искать детали, упомянутые в сводке

Обслуживание и контроль качества

Простые субагенты периодически сканируют сводки, чтобы обеспечить правильную синхронизацию с соответствующими логами. Сводки разных тем содержат перекрёстные ссылки, где это уместно, предоставляя любому рабочему агенту инфраструктуру для поиска дополнительных деталей. Агенты также отмечают любые комментарии C:, на которые никогда не отвечали, предотвращая пропущенные вопросы.

Резервный вариант и преимущества документации

Для максимальной надёжности независимо от стоимости токенов нового агента можно проинструктировать перечитать весь LOG-файл, что требует меньше памяти, чем исходное обсуждение, поскольку исключает другие операции, такие как чтение файлов Python или веб-сёрфинг. В качестве бонуса LOG-файлы служат тщательной документацией для других людей, работающих над тем же проектом.