forgeplan link

Создает типизированную, направленную связь от одного артефакта к другому. Связи - это то, как Forgeplan строит граф решений; они обеспечивают работу проверок состояния, подсчета R_eff, графа зависимостей Mermaid, топологической сортировки для планирования спринтов и обнаружения слепых пятен.

Каждый значимый артефакт должен иметь хотя бы одну входящую или исходящую связь. Сироты (артефакты без связей) - это главный сигнал, выявляемый forgeplan health.

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

forgeplan link [OPTIONS] <SOURCE> <TARGET>

Аргументы

  <SOURCE>  ID исходного артефакта
  <TARGET>  ID целевого артефакта

Опции

      --relation <RELATION>  Тип связи: informs, based_on, supersedes, contradicts, refines [по умолчанию: informs]
  -h, --help                 Вывести справку
  -V, --version              Вывести версию

Допустимые связи (v0.18)

Forgeplan использует закрытый словарь. Принимаются только эти пять типов связей - любое другое значение будет отклонено валидатором.

Связь	Направление читается как…	Когда использовать
informs	источник информирует цель	Доказательство, подтверждающее PRD; Note, используемый в ADR. Наиболее распространенный.
based_on	источник основан на цели	RFC, построенный на основе более раннего PRD; PRD, полученный из ProblemCard.
supersedes	источник замещает цель	Новый ADR заменяет старый. Устанавливается автоматически командой forgeplan supersede.
contradicts	источник противоречит цели	Доказательство, опровергающее решение; RFC, отвергающий более ранний подход.
refines	источник уточняет цель	Spec, который уточняет PRD; ADR, который сужает пространство проектирования RFC.

Примеры

Канонический поток доказательств - свяжите новый EvidencePack с PRD, который он поддерживает:

forgeplan new evidence "Benchmark: BM25 vs TF-IDF on Russian corpus"
# ... заполните verdict, congruence_level, evidence_type ...
forgeplan link EVID-001 PRD-039 --relation informs
forgeplan score PRD-039   # R_eff теперь должен быть > 0

Выведите RFC из PRD:

forgeplan link RFC-006 PRD-025 --relation based_on

Зафиксируйте противоречие (Доказательство, которое опровергает):

forgeplan link EVID-017 ADR-004 --relation contradicts

Уточните PRD с помощью Spec:

forgeplan link SPEC-003 PRD-018 --relation refines

Распространенные ошибки: несуществующие связи

Старые документы и результаты LLM иногда предлагают типы связей, которые не являются допустимыми в v0.18. Вот таблица соответствий:

Вы могли бы ввести…	Используйте вместо	Почему
solves	based_on (PRD → ProblemCard)	Решение основано на проблеме, которую оно решает
extends	refines или based_on	refines для сужения области; based_on для наследования
blocks	based_on для заблокированного артефакта	Зависимости выражаются тем, на чем построен дочерний элемент
depends_on	based_on	Та же семантика
implements	refines	Spec/RFC уточняет намерение PRD
references	informs	Мягкая связь по умолчанию

Если сомневаетесь, выберите informs - это нейтральная связь «этот артефакт имеет отношение к тому».

Направление имеет значение

Связи являются направленными. forgeplan link PRD-001 EVID-001 --relation informs означает PRD-001 информирует EVID-001, что почти никогда не является желаемым результатом. Стандартный шаблон всегда доказательство → решение:

forgeplan link EVID-001 PRD-001 --relation informs   # правильно

Если вы установили связь в неправильном направлении, исправьте это с помощью forgeplan unlink, а затем создайте новую link.

Самостоятельные ссылки заблокированы

Начиная с PROB-019, forgeplan link PRD-001 PRD-001 отклоняется. Это предотвращает опечатки, которые в противном случае создали бы самореферентные узлы в графе и запутали бы топологическую сортировку.

Что происходит после связывания

• Связь сохраняется в таблице links в LanceDB.
• forgeplan score пересчитывает R_eff для цели - связи informs от доказательств с verdict: supports повышают оценку.
• forgeplan graph включает ребро в вывод Mermaid.
• forgeplan blocked и forgeplan order повторно запускают топологическую сортировку по рёбрам based_on / refines.

См. также

• Обзор CLI
• forgeplan unlink - удалить связь
• forgeplan score - оценить R_eff после связывания доказательств
• forgeplan graph - визуализировать граф связей
• forgeplan health - найти сирот (артефакты без связей) и недостающие доказательства
• Руководство по методологии