forgeplan new

Создаёт новую заготовку артефакта из шаблона в .forgeplan/<kind>s/. Это первый шаг фазы Shape: вы получаете скелет с YAML-преамбулой и отмеченными секциями MUST, затем заполняете их перед запуском validate. Используйте это для любой задачи уровня Standard+ - Forgeplan блокирует активацию артефактов с пустыми секциями MUST, поэтому оставление заготовки означает, что работа никогда не будет выпущена.

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

• Начало фазы Shape для любой задачи уровня Standard+: создайте PRD / RFC / ADR до написания кода, чтобы зафиксировать обоснование.
• Запись тактической Note без необходимости использования LLM - new note "...".
• Явный контроль шаблона - когда вам нужен точный макет заготовки, а не тело, сгенерированное LLM (используйте forgeplan generate для пути с LLM).

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

• Тактическое исправление одного файла без проектных решений - полностью пропустите артефакт, просто сделайте коммит с чётким сообщением.
• Решение было принято в ходе живого разговора, и вы хотите только его зафиксировать - используйте forgeplan capture.
• У вас уже есть сохранённая память, которую вы хотите превратить в артефакт - используйте forgeplan promote.

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

forgeplan new [OPTIONS] <KIND> <TITLE>

Аргументы

  <KIND>   Тип артефакта: prd, epic, spec, rfc, adr, problem, solution, evidence, note, refresh
  <TITLE>  Заголовок артефакта

Опции

      --allow-duplicate  Пропустить запрос на обнаружение дубликатов и всё равно создать [псевдонимы: --force]
  -h, --help             Вывести справку
  -V, --version          Вывести версию

Forgeplan выполняет проверку на сходство с существующими артефактами и предупреждает, если заголовок выглядит как дубликат. Передайте --allow-duplicate / --force, чтобы обойти это, если вы намеренно хотите создать параллельный артефакт (например, второй PRD, исследующий ту же область с другого ракурса).

Примеры

Пример 1: Создание PRD для новой функции

forgeplan new prd "OAuth2 login"

Создаёт .forgeplan/prds/prd-NNN-oauth2-login.md с шаблоном PRD. Немедленно откройте его и заполните разделы Problem, Goals, Non-Goals, Target Users, Related и Functional Requirements - затем запустите forgeplan validate PRD-NNN, чтобы убедиться в отсутствии ошибок MUST, прежде чем продолжить.

Пример 2: Запись сигнала о проблеме

forgeplan new problem "Slow search on 10k+ artifacts"

Создаёт ProblemCard с разделами Signal / Context / Goals / Anti-Goodhart indicators. ProblemCard не требуют дизайна - заполните Signal и Context, затем свяжите с любым Evidence, который у вас уже есть. Проблемы не требуют гейта валидации для активации, поэтому вы можете активировать их, как только карточка станет связной.

Пример 3: Прикрепление бенчмарка в качестве доказательства

forgeplan new evidence "Benchmark auth handler under 500 concurrent users"
forgeplan link EVID-NNN PRD-012 --relation informs
forgeplan score PRD-012

Тела Evidence ДОЛЖНЫ содержать структурированные поля (verdict, congruence_level, evidence_type) - без них парсер R_eff возвращается к CL0 и снижает оценку. Свяжите с артефактом, который подтверждает Evidence, затем переоцените, чтобы увидеть изменение R_eff.

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

Эта команда является частью полного жизненного цикла артефакта - см. руководство для сквозного процесса. new только создаёт заготовку: работа не считается завершённой, пока не будут заполнены секции MUST и validate не пройдёт успешно. Наполовину заполненные заготовки накапливаются как слепые пятна в forgeplan health и блокируют активацию позже.

См. также

• forgeplan generate - позвольте LLM создать черновик тела артефакта вместо ручного заполнения
• forgeplan validate - запускает правила MUST/SHOULD; требуется перед activate
• forgeplan route - определяет глубину + конвейер перед созданием артефакта
• forgeplan health - выявляет заготовки и слепые пятна после создания
• Методология: модель артефакта