Перейти к содержимому
F●RGEPLAN

forgeplan capture

Записывает решение, принятое в ходе беседы, в артефакт Note (микро-решение с автоматическим истечением срока действия через 90 дней). capture предназначен для тех моментов, когда вы и ваш коллега (или вы и ИИ-агент) только что договорились о чём-то незначительном, и вы не хотите сталкиваться с трудностями полного цикла new → fill MUST sections → validate, но при этом не хотите, чтобы решение испарилось.

Для постоянных архитектурных решений используйте forgeplan new adr - capture предназначен только для Note.

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

Заголовок раздела «Когда использовать»
  • Короткое обсуждение привело к выбору («мы будем использовать BGE-M3 вместо all-MiniLM»); вы хотите зафиксировать это до того, как контекст будет утерян.
  • Корректировка курса в середине спринта: небольшое архитектурное решение, которое не заслуживает полноценного RFC, но должно быть отслеживаемым позже.
  • Вы хотите преобразовать вывод сессии рассуждений ИИ в артефакт, не покидая терминала.

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

Заголовок раздела «Когда НЕ использовать»
  • Решение требует Problem / Goals / FRs - вместо этого используйте forgeplan new prd.
  • Тема охватывает несколько файлов и заинтересованных сторон - используйте RFC с этапами реализации.
  • Решение является долговечным и архитектурным - используйте forgeplan new adr для постоянного журнала решений.

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

Заголовок раздела «Использование»
forgeplan capture [OPTIONS] <DECISION>

Аргументы

Заголовок раздела «Аргументы»
  <DECISION>  Формулировка решения (однострочник в кавычках)

Опции

Заголовок раздела «Опции»
      --context <CONTEXT>  Дополнительный контекст (необязательно)
  -h, --help               Вывести справку
  -V, --version            Вывести версию

capture всегда создает Note - самый дешевый вариант сохранения. Если решение окажется критически важным, создайте отдельный ADR с помощью forgeplan new adr и свяжите исходный Note.

Примеры

Заголовок раздела «Примеры»

Пример 1: Быстрая заметка из разговора в спринте

Заголовок раздела «Пример 1: Быстрая заметка из разговора в спринте»
Окно терминала
forgeplan capture "skip retry for 4xx from embedding API; retry only 5xx" \
  --context "discussed in sprint 13 sync - 4xx means malformed input, retry is wasted"

Создает NOTE-NNN с решением в качестве заголовка и контекстом в теле. Срок действия Note автоматически истекает через 90 дней - это подходит для обратимых, ограниченных по области применения решений.

Пример 2: Минимальная заметка без дополнительного контекста

Заголовок раздела «Пример 2: Минимальная заметка без дополнительного контекста»
Окно терминала
forgeplan capture "log R_eff to stderr on every validate run"

Самый быстрый путь от «мы решили» до «это отслеживается». Никаких запросов шаблона, никаких обязательных разделов - полезно, когда контекст уже очевиден из недавних коммитов.

Пример 3: Зафиксировать, затем повысить до ADR, когда это важно

Заголовок раздела «Пример 3: Зафиксировать, затем повысить до ADR, когда это важно»
Окно терминала
forgeplan capture "use LanceDB as derived index, markdown as source of truth" \
  --context "ADR-003 principle: files are authoritative, lance/ is gitignored"
# Later, if the decision proves load-bearing:
forgeplan new adr "LanceDB as derived index"
forgeplan link NOTE-NNN ADR-005 --relation informs

Начните с Note для минимизации трений; создавайте ADR только тогда, когда решение явно заслуживает постоянного журнала решений.

Как это вписывается в рабочий процесс

Заголовок раздела «Как это вписывается в рабочий процесс»

Эта команда является частью полного жизненного цикла артефакта - см. руководство для сквозного процесса.

См. также

Заголовок раздела «См. также»