claude-memory-architecture — правило для Claude Code: суть работы
Правило claude-memory-architecture фиксирует внутреннюю архитектуру плагина claude-memory: хуки жизненного цикла сессий, схему базы SQLite, миграции и семантический поиск.
лицензия не указана ★ 276 обновлён 2026-10-29
.claude/rules/claude-memory-architecture.mdЧто делает claude-memory-architecture
Правило описывает технические требования к подсистеме памяти Claude Code. Жизненный цикл сессий контролируется хуками запуска и завершения. При старте фоновый процесс создаёт каталог ~/.claude-memory/, запускает импорт истории и наполняет поисковый индекс. Все диалоги сохраняются в SQLite с включённым режимом WAL и пятисекундным таймаутом ожидания.
В плагине запрещены сторонние зависимости вроде PyYAML, поэтому весь исполняемый код обязан использовать только стандартную библиотеку Python. Координация фоновых задач опирается на системные вызовы flock и msvcrt. Использование PID-файлов запрещено из-за риска состояния гонки при параллельном чтении.
Текстовый поиск организован каскадом через FTS5, FTS4 и LIKE. Дополнительный семантический поиск использует локальный сервис Ollama с векторами на 256 измерений. Для сессий Codex предусмотрен отдельный адаптер, приводящий события к общей структуре сообщений.
Какие задачи решает
- структурировать запуск хуков в сессиях Claude Code
- исключить конфликты параллельных процессов с помощью системных блокировок
- синхронизировать историю диалогов в локальной базе SQLite
- настроить гибридный поиск по контексту через FTS5 и векторы
Примеры запросов агенту
- Проверь порядок выполнения хуков жизненного цикла в plugins/claude-memory/
- Как устроены схема базы SQLite и миграции данных в claude-memory?
- Покажи требования к системным блокировкам при фоновой синхронизации сессий
Как установить claude-memory-architecture
Вручную: положить файлы
.claude/rules/claude-memory-architecture.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/claude-memory-architecture.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/claude-memory-architecture.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/claude-memory-architecture.mdВручную: положить файлы
.clinerules/claude-memory-architecture.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о claude-memory-architecture
Как установить claude-memory-architecture в Claude Code?
Создайте файл правила по пути .claude/rules/claude-memory-architecture.md в корне репозитория.
Для чего нужно правило claude-memory-architecture?
Оно задаёт архитектурные стандарты плагина памяти: схему хранения сообщений в SQLite, порядок хуков, обработку блокировок и миграции.
Какие ограничения действуют для библиотек в рантайме?
Скрипты плагина должны работать исключительно на стандартной библиотеке Python, использование внешних пакетов вроде PyYAML исключено.