forgeplan recall

Ищите в хранилище воспоминаний - специальных наблюдениях, уроках и фрагментах контекста, сохранённых с помощью forgeplan remember. Это легковесный инструмент Forgeplan для личных заметок, отдельный от артефактов. Используйте recall, когда вы помните, что «мы что-то узнали о X», но нет официального PRD или Note.

Когда использовать

• «Мы договорились не использовать крейт X - почему?»
• Восстановить контекст в начале сессии («recall ‘sprint 13’»)
• Извлечь предыдущие уроки перед ретроспективой или анализом после инцидента
• Подпитать ИИ-агента ситуативной памятью

Когда не использовать

• Вам нужны артефакты (PRD, RFC, ADR) → используйте forgeplan search
• Вам нужны решения → используйте forgeplan journal

Использование

forgeplan recall [OPTIONS] [QUERY]

Аргументы

  [QUERY]  Поисковый запрос (совпадение подстроки в заголовке/теле)

Опции

  -c, --category <CATEGORY>  Фильтр по категории
  -n, --limit <LIMIT>        Максимальное количество результатов (по умолчанию: 10) [по умолчанию: 10]
      --json                 Вывод в формате JSON для машинной обработки
  -h, --help                 Вывести справку
  -V, --version              Вывести версию

Примеры

Извлечь всё, что соответствует фразе:

forgeplan recall "branch workflow"

Все воспоминания в категории:

forgeplan recall --category build

Вывести всё в формате JSON:

forgeplan recall --json --limit 1000 > memories.json

Интерпретация вывода

Каждый результат отображается в виде короткой карточки:

[2026-04-05]  build    Do not delete feature branches after merge
   PRs to dev are merge-commit, squash loses late commits. Keep the
   branch until the PR is closed for at least a week.

Столбцы: дата, категория, заголовок, затем отрывок из тела. --json возвращает полную запись, включая любые теги и источник (вручную или автоматически сохранённый).

В отличие от search, recall выполняет чистое совпадение подстроки с фильтрацией по категориям - быстро и предсказуемо, без BM25 или семантического ранжирования.

Как это вписывается

Forgeplan разделяет артефакты (решения с жизненным циклом) и воспоминания (специальные заметки без жизненного цикла):

artifacts   →  list, get, search, graph
memories    →  remember, recall

Если воспоминание упоминается несколько раз, повысьте его до артефакта Note и свяжите его - именно тогда оно получает жизненный цикл и доказательство.

См. также

• forgeplan search - поиск артефактов
• forgeplan journal - хронология решений
• forgeplan new note - повысить воспоминание до Note