# memory-scout

Субагент memory-scout ищет релевантные заметки об ошибках и соглашениях в базе .flow/memory/ перед планированием новой задачи.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 730 у репозитория
- Автор: Gordon Mickel
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/memory-scout.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/memory-scout

## Что делает

Субагент работает в режиме чтения без доступа к редактированию файлов или созданию вложенных задач. Он принимает описание изменения либо идентификатор задачи и извлекает из `.flow/memory/` прошлые архитектурные решения, правила кодовой базы и разборы багов.

Поиск идёт строго через утилиту `flowctl memory`, а не прямым чтением каталогов. Скрипт поддерживает новую категоризированную структуру каталогов `bug/` и `knowledge/`, а также устаревшие плоские списки. Если скрипт `flowctl` не найден по ожидаемым путям плагина, агент сразу прекращает поиск и выводит ошибку вместо сканирования диска вручную.

Результат агент возвращает короткой сводкой из пяти-десяти самых близких записей с привязкой к модулям или категориям. По умолчанию записи со статусом `hardened` не выводятся: если опыт уже перенесён в тесты или линтеры аудитом проекта, он не засоряет контекст.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add gmickel/flow-next
```
В чате агента (не в терминале):
```text
/plugin install flow-next@flow-next
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/memory-scout.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/memory-scout.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/memory-scout.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/memory-scout.md

## Когда брать
- Найти прошлые сбои и ошибки в конкретном модуле
- Проверить архитектурные соглашения проекта перед написанием фичи
- Собрать контекст по известным ловушкам без чтения всей базы вручную

## Примеры запросов агенту
- Проверь через memory-scout, есть ли зафиксированные соглашения по модулю `src/auth.ts`
- Найди в памяти проекта известные ошибки производительности перед рефакторингом запросов
- Вызови memory-scout для задачи fn-1.3 и покажи релевантные заметки

## Похожие
- [scout-pro](https://affpapa.org/nevibecode/skills/scout-pro.md) — скилл · 244 установки
- [deep-agents-memory](https://affpapa.org/nevibecode/skills/deep-agents-memory.md) — скилл · 20000 установок
- [memory-discipline](https://affpapa.org/nevibecode/skills/memory-discipline.md) — скилл · 4900 установок
- [memory-md-management](https://affpapa.org/nevibecode/skills/memory-md-management.md) — скилл · 3700 установок
- [parallel-memory](https://affpapa.org/nevibecode/skills/parallel-memory.md) — скилл · 2900 установок
- [OMEGA Memory](https://affpapa.org/nevibecode/mcp/omega-memory-omega-memory.md) — MCP-сервер · 2862 установки

Из того же набора: [gmickel/flow-next](https://affpapa.org/nevibecode/by/gmickel/flow-next.md) — 70 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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