fix(docs): align tool names to kebab-case in active documentation (#78 )

Co-authored-by: opencode-agent <agent@opencode.local>

2026-07-26 17:48:55 +03:00

4.3 KiB

Raw Blame History

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

File Memory (opencode-memory)

Графовая память (Graphiti/FalkorDB) удалена — была нестабильна и забагована. Теперь память работает через @mathew-cf/opencode-memory — файловая система с keyword + semantic search.

Инструменты

Инструмент	Назначение
`memory_search(query, category?)`	Гибридный поиск (keyword + semantic)
`memory_list(category?)`	Список категорий / файлов
`memory_save()`	Commit + re-index после записи/редактирования
`memory_access(path)`	Отметить файл как прочитанный
`memory-setup()`	Проверить статус бэкендов

Категории

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

Как работать

Перед началом работы — memory_search по теме
В процессе — сохранять находки сразу (контекст свежий)
В конце сессии — 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: ~/opencode-memory (переопределяется через OPENCODE_MEMORY_DIR, например app_data/opencode-memory).

{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).

4.3 KiB Raw Blame History Unescape Escape