forgeplan tag

Прикрепите один или несколько тегов к артефакту. Теги являются основным сквозным механизмом обнаружения - они позволяют группировать артефакты по теме, слою, источнику или флагу статуса без создания отношения родитель/потомок.

Теги дополняют, а не заменяют граф артефактов. Используйте связи (forgeplan link) для выражения цепочки решений. Используйте теги для разделения рабочего пространства по ортогональным осям, таким как «всё, что связано с аутентификацией», «всё, помеченное тегом legacy», или «все артефакты с source=quint-code».

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

forgeplan tag <ID> <TAGS>...

Аргументы

  <ID>       ID артефакта (например, PRD-001)
  <TAGS>...  Теги для добавления (например, source=code layer=auth legacy)

Опции

  -h, --help     Вывести справку
  -V, --version  Вывести версию

Что делает команда

Загружает frontmatter артефакта.
Канонизирует каждый тег (приводит к нижнему регистру, удаляет пробелы по краям, удаляет дубликаты - см. исправление PROB-026 в v0.18).
Объединяет новые теги с существующим списком tags:.
Перезаписывает frontmatter и повторно индексирует артефакт в LanceDB.

Примеры

Теги из одного слова:

forgeplan tag PRD-001 security auth

Теги ключ-значение (полезны для структурированных фильтров):

forgeplan tag PRD-018 source=openspec layer=storage

Несколько стилей одновременно:

forgeplan tag EVID-012 benchmark performance source=dogfood

Канонизация тегов (v0.18)

Начиная с исправления PROB-026 в v0.18.0, теги канонизируются при записи:

Приводятся к нижнему регистру: Security → security.
Обрезаются от окружающих пробелов.
Удаляются дубликаты: forgeplan tag PRD-001 auth auth Auth добавляет auth один раз.
Сохраняются = и - для форм ключ-значение и форм с дефисами.

Рабочие пространства, созданные до v0.18, могут содержать теги с разным регистром. Запустите forgeplan reindex для повторной канонизации каждого артефакта за один проход.

Обнаруживаемость: где используются теги

Теги используются в нескольких последующих командах:

Команда	Как используются теги
`forgeplan discover`	Группирует артефакты по тегам, показывает частоту тегов
`forgeplan search --tag <t>`	Фильтрует результаты BM25 по пересечению тегов
`forgeplan list --tag <t>`	Выводит список артефактов, соответствующих тегу
`forgeplan health`	Показывает нетегированные активные артефакты

Хорошо тегированное рабочее пространство делает discover осмысленным. Нетегированное рабочее пространство делает discover шумным.

Соглашения по тегированию (рекомендуемые)

CLI не навязывает таксономию, но следующие шаблоны хорошо работают:

Теги тем (простые слова): auth, security, performance, docs.
Теги источников (key=value): source=quint-code, source=bmad, source=dogfood - отслеживают, откуда пришло решение или доказательство.
Теги слоёв: layer=cli, layer=core, layer=mcp.
Флаги статуса: legacy, experimental, blocked, wip.

Выберите небольшой, продуманный словарь и придерживайтесь его. Распространение тегов затрудняет обнаружение.

Сопоставление уровней источников и CL (v0.17.0, PRD-035)

Теги вида source_tier=T1, source_tier=T2 или source_tier=T3 имеют особое значение в Trust Calculus Forgeplan. Они напрямую сопоставляются с уровнем конгруэнтности (Congruence Level), который влияет на оценку R_eff:

Значение тега	Уровень конгруэнтности	Штраф CL	Значение
`source_tier=T1`	CL3	0.0	Тот же контекст - наивысший уровень доверия
`source_tier=T2`	CL2	0.1	Похожий контекст - небольшой штраф
`source_tier=T3`	CL1	0.4	Другой контекст - значительный штраф

Приоритет безопасности (`min(tier_cl, explicit_cl)`)

Если артефакт имеет как тег source_tier, так и явный congruence_level в своём теле Structured Fields, Forgeplan выбирает меньшее (более консервативное) из двух значений:

final_cl = min(tier_cl, explicit_cl)

Это предотвращает атаки повышения CL через манипуляции с тегами. Например:

Артефакт-доказательство помечен тегом source_tier=T1 (что подразумевает CL3).
Но тело содержит congruence_level: 0 (явный CL0).
Итоговый CL = min(CL3, CL0) = CL0 - явное поле с низким уровнем доверия имеет приоритет.

Правило «консервативно по умолчанию» означает, что тег никогда не может повысить доверие сверх того, что заявлено в структурированных полях. Теги могут только снижать CL, но никогда не повышать его.

Вариант использования: внедрение в существующую систему (brownfield onboarding)

При приёме артефактов из внешнего источника через протокол обнаружения (forgeplan discover) теги уровней позволяют пакетно классифицировать уровни доверия:

# Документы внешнего поставщика - низкий уровень доверия
forgeplan tag PRD-050 source_tier=T3 source=vendor-api

# Внутренний PoC от соседней команды - умеренный уровень доверия
forgeplan tag PRD-051 source_tier=T2 source=team-alpha

# Наш собственный производственный бенчмарк - наивысший уровень доверия
forgeplan tag EVID-060 source_tier=T1 source=dogfood

См. Методология доказательств - Приоритет SourceTier для получения информации о том, как это взаимодействует с оценкой R_eff после обновления.

Примечания

Теги хранятся во frontmatter как список YAML. Прямое редактирование markdown работает, но после этого необходимо повторно запустить forgeplan scan-import.
Для удаления тегов используйте forgeplan untag.
Позиционный аргумент <TAGS>... является вариативным - передавайте столько тегов, сколько хотите, за один вызов.

См. также

Обзор CLI
forgeplan untag - удалить теги
forgeplan discover - просмотр по тегам
forgeplan search - фильтрация поиска по тегам
Руководство по методологии