---
name: memory
description: Инструкция по работе с файловой памятью opencode-memory (search + save + retro).
---

# File Memory (opencode-memory)

Графовая память (Graphiti/FalkorDB) удалена — была нестабильна и забагована.
Память работает через файловую систему с keyword + semantic search — 5 TS tools (`.opencode/tools/memory-*.ts`), вызывают `python3 -m src.memory`. Плагин `@mathew-cf/opencode-memory` удалён.

## Инструменты

| Инструмент | Назначение |
|---|---|
| `memory-search({ query, category? })` | Гибридный поиск (ripgrep keyword + Python semantic) |
| `memory-list({ category? })` | Список категорий / файлов |
| `memory-save()` | Commit + reindex после записи/редактирования (auto-setup: git init + hook если `OPENCODE_MEMORY_REMOTE` set) |
| `memory-access({ path })` | Отметить файл как прочитанный (bump `last_accessed`/`access_count`) |
| `memory-doctor()` | Read-only диагностика: ripgrep, Python `src.memory`, env vars, index |

## Категории

`preferences` · `repos` · `technical` · `people` · `workflows` · `snippets` · `notes`

## Как работать

1. **Перед началом работы** — `memory-search` по теме
2. **В процессе** — сохранять находки сразу (контекст свежий)
3. **В конце сессии** — retrospective: что узнал → сохранить, что было в памяти → обновить, чего не хватало → создать

## Когда сохранять

- gotcha / workaround (неочевидное поведение)
- структура репозитория, команды сборки/тестов
- quirks инструментов
- коренные причины багов (root cause)
- указатели: «для X используй Y, осторожно с Z»

## Когда НЕ сохранять

- данные, которые живой API возвращает свежими каждый раз
- текущий статус тасок / PR / спринтов
- копии вики-страниц и API-документации
- то, что находится за <1 минуты из первых принципов

## Структура файла

```
---
title: Человекочитаемый заголовок
tags: [tag1, tag2]
summary: Описание в одну строку
created: YYYY-MM-DD
updated: YYYY-MM-DD
importance: high | medium | low
source: откуда информация
source_date: YYYY-MM-DD
related: [category/file.md]
---
```

## Путь для репозиториев

Default: `/root/.local/share/opencode/opencode-memory` (переопределяется через `OPENCODE_MEMORY_DIR`).

```
{memory-dir}/repos/{host}/{org}/{repo}.md
```

Используй один путь последовательно во всех примерах — default (`~/opencode-memory`) или override (`app_data/opencode-memory`), но не оба сразу.

### Формат записей

```
- [YYYY-MM-DD, PR#N] <суть>
```

Дата и PR-номер в тексте — для RAG-поиска и верификации (какой PR принёс знание).

### Что дистиллировать (durable-only)

- gotchas / workaround (неочевидное поведение)
- паттерны, конвенции репозитория
- указатели: «для X используй Y, осторожно с Z»
- коренные причины багов (root cause)

НЕ дистиллировать: статусы, «сейчас делаем», текущие таски, ephemeral контекст.

### ADR — только указатель

```
- [date, PR#N] ADR-NN: <суть> → docs/decisions/NN-title.md
```

Не копируй содержание ADR — только указатель на файл.

### Править вместо дублирования

Если факт уже записан — обнови запись (bump `updated` в frontmatter). Не создавай дубликаты.

### Квитанция ставится всегда

Даже если durable-записей нет, квитанция обязательна:

```
- [date, PR#N] — (нет durable-записей)
```

Это подтверждает, что memory-sync фаза выполнена (audit trail).