# claude-memory-architecture

Правило claude-memory-architecture фиксирует внутреннюю архитектуру плагина claude-memory: хуки жизненного цикла сессий, схему базы SQLite, миграции и семантический поиск.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 276 у репозитория
- Автор: gupsammy
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gupsammy/Claudest/tree/HEAD/.claude/rules/claude-memory-architecture.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/claude-memory-architecture

## Что делает

Правило описывает технические требования к подсистеме памяти Claude Code. Жизненный цикл сессий контролируется хуками запуска и завершения. При старте фоновый процесс создаёт каталог `~/.claude-memory/`, запускает импорт истории и наполняет поисковый индекс. Все диалоги сохраняются в SQLite с включённым режимом WAL и пятисекундным таймаутом ожидания.

В плагине запрещены сторонние зависимости вроде PyYAML, поэтому весь исполняемый код обязан использовать только стандартную библиотеку Python. Координация фоновых задач опирается на системные вызовы `flock` и `msvcrt`. Использование PID-файлов запрещено из-за риска состояния гонки при параллельном чтении.

Текстовый поиск организован каскадом через FTS5, FTS4 и LIKE. Дополнительный семантический поиск использует локальный сервис Ollama с векторами на 256 измерений. Для сессий Codex предусмотрен отдельный адаптер, приводящий события к общей структуре сообщений.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/claude-memory-architecture.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/claude-memory-architecture.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/claude-memory-architecture.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/claude-memory-architecture.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/claude-memory-architecture.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gupsammy/Claudest/tree/HEAD/.claude/rules/claude-memory-architecture.md

## Когда брать
- структурировать запуск хуков в сессиях Claude Code
- исключить конфликты параллельных процессов с помощью системных блокировок
- синхронизировать историю диалогов в локальной базе SQLite
- настроить гибридный поиск по контексту через FTS5 и векторы

## Примеры запросов агенту
- Проверь порядок выполнения хуков жизненного цикла в plugins/claude-memory/
- Как устроены схема базы SQLite и миграции данных в claude-memory?
- Покажи требования к системным блокировкам при фоновой синхронизации сессий

## Похожие
- [Titen Memory](https://affpapa.org/nevibecode/mcp/titen-memory.md) — MCP-сервер · ★ 19 у репозитория
- [Local Memory](https://affpapa.org/nevibecode/mcp/local-memory.md) — MCP-сервер · ★ 15 у репозитория
- [claudex](https://affpapa.org/nevibecode/mcp/claudex.md) — MCP-сервер · ★ 97 у репозитория
- [recall](https://affpapa.org/nevibecode/plugins/recall.md) — плагин · ★ 23 у репозитория
- [Kagura Memory Cloud](https://affpapa.org/nevibecode/mcp/kagura-memory-cloud.md) — MCP-сервер · ★ 14 у репозитория
- [Provena Agent Memory](https://affpapa.org/nevibecode/mcp/provena-agent-memory.md) — MCP-сервер · ★ 8 у репозитория

Из того же набора: [gupsammy/claudest](https://affpapa.org/nevibecode/by/gupsammy/claudest.md) — 47 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
