MemoryCustodian

1) Установите MemoryCustodian (выберите путь, соответствующий вашему агенту/рабочему процессу): Выберите один из способов установки: - Попросите вашего агента по кодированию установить навык из репозитория: https://github.com/waittim/MemoryCustodian - Codex (локальный маркетплейс): запустите `codex plugin marketplace add .` из чекаута, затем `codex plugin add memory-custodian@memory-custodian-dev`. - Claude Code (плагин): для локального тестирования запустите `claude --plugin-dir .` или установите в личные навыки с помощью `./install.sh claude`. - Агенты в стиле Gemini: установите с помощью `./install.sh gemini` или `gemini skills link ./skills/memory-custodian`. - CLI/исходный чекаут: запустите из репозитория через `scripts/memory-custodian ...` или установите редактируемый с помощью `python3 -m pip install -e .`, чтобы получить команду `memory-custodian`.

2) Инициализируйте MemoryCustodian в проекте (один раз для каждого репозитория): Запустите инициализацию один раз для каждого целевого проекта: - Если установлено как консольный скрипт: `memory-custodian init --project-root /path/to/project --agent all` - Из исходного чекаута: `scripts/memory-custodian init --project-root /path/to/project --agent all` Используйте `--agent codex`, `--agent claude`, `--agent gemini` или `--agent all` для создания тонких файлов начальной загрузки, которые читает ваш агент.

3) Поймите, что создает инициализация (где хранится память): Инициализация создает набор постоянной памяти по умолчанию в `docs/memory/`: - `manifest.md` (маршрутизирует, что загружать) - `brief.md` (текущая структура проекта) - `decisions.md` (ключевые решения) - `constraints.md` (жесткие требования) - `do-not-use.md` (отклоненные пути / надгробия) - `inbox.md` (область подготовки) Файлы начальной загрузки платформы (например, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) остаются тонкими и указывают агентам на `docs/memory/`.

4) Курируйте сгенерированный бриф, прежде чем полагаться на него: После `init` `brief.md` начинается как шаблон с TODO. Заполните его из авторитетных источников проекта (README, код, документация), прежде чем считать память готовой. Используйте `memory-custodian status --project-root /path/to/project` (или `scripts/memory-custodian status ...`), чтобы узнать, не курирован ли бриф; `status` и `check` сообщают о некурированном брифе.

5) Загрузите правильную память для задачи (чтение манифеста): Предполагаемый рабочий процесс для агентов: 1) Прочитать `docs/memory/manifest.md`. 2) Прочитать `docs/memory/brief.md`. 3) Загрузить только те файлы, относящиеся к задаче, которые указаны в манифесте. Для ручной проверки сгенерируйте пакет контекста с помощью: - `memory-custodian read --project-root /path/to/project --task planning` - `memory-custodian read --project-root /path/to/project --task implementation` - `memory-custodian read --project-root /path/to/project --task artifact`

6) Добавьте постоянную память, когда что-то должно сохраниться после текущего чата: Записывайте решения/ограничения/предпочтения/отклоненные подходы с помощью CLI: - `memory-custodian add "Мы выбрали загрузку манифеста." --type decision` - `memory-custodian add "Сохранить синхронизацию повторных попыток." --type decision --area sync --reason "Сохранять повторные попытки в пределах запусков."` Держите записи решений короткими (инструмент применяет руководство по токенам и отклоняет слишком длинные записи, если вы явно не разрешаете длинные записи).

7) Включайте необязательные модули памяти только тогда, когда они становятся актуальными: Необязательные модули (например, правила, профили, области) являются необязательными и не загружаются, если они не включены и не маршрутизированы манифестом. Включайте их по мере необходимости: - `memory-custodian enable preferences` - `memory-custodian enable rules/output` - `memory-custodian enable profile/git` - `memory-custodian enable area/frontend` Включение никогда не перезаписывает существующий файл модуля.

8) Используйте 'do-not-use' для сохранения отклоненных подходов и предотвращения регрессий: Когда вы намеренно отклоняете подход (например, бэкенд хранилища или архитектуру), запишите его в `docs/memory/do-not-use.md` (путем редактирования или соответствующего рабочего процесса добавления/забывания), чтобы будущие сессии не предлагали его повторно.

9) Регулярно проверяйте работоспособность и совместимость протокола: Запускайте детерминированную проверку для обеспечения правильности структуры, бюджетов и метаданных протокола: - `memory-custodian check --project-root /path/to/project` Используйте `memory-custodian status` для быстрого обзора и обнаружения некурированного брифа.

10) Сжимайте и поддерживайте память (сначала предварительный просмотр, безопасные изменения): Используйте команды обслуживания, чтобы память оставалась небольшой и актуальной: - `memory-custodian compact --project-root /path/to/project` Сжатие защищено и сначала предварительный просмотр; применяйте изменения только после просмотра плана. Сжатие входящих сообщений консервативно (например, удаление точных дубликатов верхнего уровня и фильтрация надгробий) и ожидает, что агент/человек выполнит семантическое продвижение в решения/ограничения.

11) Безопасно забывайте устаревшую информацию (сначала предварительный просмотр): Удаляйте или редактируйте устаревшие темы с помощью предварительного просмотра: - Предварительный просмотр: `memory-custodian forget "old deployment note" --mode soft --project-root /path/to/project` - Применить после просмотра: `memory-custodian forget "old deployment note" --mode soft --apply --project-root /path/to/project` Широкие совпадения требуют явного подтверждения (например, `--allow-broad-match`). Некоторые случаи требуют ручного переписывания; инструмент откажется от небезопасных массовых удалений.

12) При необходимости восстановите или замените существующую настройку: Если файлы отсутствуют или метаданные нуждаются в обновлении без перезаписи курированного контента: - Восстановление: `memory-custodian init --project-root /path/to/project --repair` Если вы намеренно хотите полную замену, используйте замену с предварительным просмотром и применяйте только тогда, когда она правильна: - `memory-custodian init --project-root /path/to/project --replace-existing` - затем добавьте `--apply` только если перечисленные файлы должны быть заменены.

13) Мигрируйте версии протокола/памяти проекта при обновлении инструмента: Когда `check` сообщает о старых или отсутствующих метаданных протокола, мигрируйте манифест проекта в автономном режиме: - Предварительный просмотр: `memory-custodian migrate --project-root /path/to/project` - Применить после просмотра: `memory-custodian migrate --apply --project-root /path/to/project`

14) Используйте правильный вызов в Windows по сравнению с исходным чекаутом: В Windows установите консольную команду и используйте `memory-custodian ...`. Из чекаута репозитория на любой платформе вы можете запустить `scripts/memory-custodian ...` в качестве обертки.