forgeplan remember

Зафиксируйте краткую запись памяти - факт, соглашение, процедуру, наблюдение или ограничение - в журнал решений Forgeplan. Записи памяти - это легковесные, локальные заметки, которые вы можете позже найти с помощью recall или преобразовать в полноценный артефакт (Note, Problem, ADR) с помощью promote.

Представьте это как рабочую память для проекта: то, что вы не хотите потерять, но что ещё не готово стать PRD или ADR.

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

forgeplan remember [OPTIONS] [TEXT]

Аргументы

  [TEXT]  Текст для запоминания (опустите для --list или --forget)

Опции

  -c, --category <CATEGORY>  Тип записи памяти: fact | convention | procedure | observation | constraint
      --list                 Перечислить все записи памяти
      --forget <FORGET>      Забыть (удалить) запись памяти по ID
  -h, --help                 Вывести справку
  -V, --version              Вывести версию

Пять типов

Каждая запись памяти имеет один тип, который определяет, как вы её ищете и как promote позже преобразует её в полноценный артефакт.

Тип	Когда использовать	Преобразуется в
`fact`	Фундаментальная истина о проекте (“мы используем BGE-M3 для эмбеддингов”)	Note
`convention`	Соглашение команды (“PR всегда сливаются в dev, а не в main”)	Note / RFC
`procedure`	Повторяемая инструкция (“всегда `git pull` перед созданием новой ветки”)	Note
`observation`	Что-то, что вы заметили, но ещё не объяснили	ProblemCard
`constraint`	Жёсткое ограничение или требование (“бинарный файл должен быть менее 50 МБ”)	ADR / RFC

Примеры

Запишите процедуру во время спринта:

forgeplan remember \
  "always pull dev before creating feature branch" \
  --kind procedure

Запишите наблюдение, которое может потребовать исследования:

forgeplan remember \
  "watch daemon drops events on nfs mounts" \
  --kind observation

Запишите командное соглашение:

forgeplan remember \
  "release branches merge with merge-commit, not squash" \
  --kind convention

Перечислите всё, что вы зафиксировали:

forgeplan remember --list

Забудьте запись памяти по её ID:

forgeplan remember --forget MEM-012

Типичный рабочий процесс

заметить что-либо → remember → recall позже → promote в артефакт

Во время работы - заметьте факт, соглашение или неожиданность. Зафиксируйте это немедленно с помощью remember, чтобы контекст не был потерян.
Позже - forgeplan recall "keyword" выводит соответствующие записи памяти, когда вы начинаете связанную работу.
Когда запись созреет - forgeplan promote MEM-XXX преобразует запись памяти в полноценный Note, ProblemCard или ADR, сохраняя исходную фиксацию в качестве доказательства.

Это легковесный конец спектра артефактов Forgeplan: вам не нужно валидировать, оценивать или активировать запись памяти - просто зафиксируйте её и двигайтесь дальше.

Хранение

Записи памяти хранятся в .forgeplan/memory/ как файлы markdown (отслеживаемые Git) и индексируются в LanceDB, как и любой другой артефакт. На них распространяются те же правила “источника истины”: редактируйте через CLI или редактируйте markdown и запустите reindex.

См. также

Обзор CLI
forgeplan recall - поиск и извлечение записей памяти
forgeplan promote - преобразование записи памяти в артефакт
forgeplan journal - полный журнал решений с R_eff
forgeplan new note - сразу создать Note, если запись памяти уже созрела