<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/doctrine-relationships/">
  <id>https://docs.spec-kitty.ai/architecture/doctrine-relationships/</id>
  <title>Doctrine relationships: lineage, delegation, augmentation, and action resolution</title>
  <updated>2026-09-30T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/doctrine-relationships/"/>
  <summary>How Spec Kitty models each DRG relation type — lineage, delegation, augmentation, obligation, scope, and the tension edges — as a typed graph edge, not as artifact fields.</summary>
  <content type="html">&lt;span id=&quot;doctrine-relationships-lineage-delegation-augmentation-and-action-resolution&quot;&gt;&lt;/span&gt;
&lt;p&gt;This page explains how relationships between doctrine artifacts are modelled in
Spec Kitty, and — importantly — &lt;strong&gt;how to author them&lt;/strong&gt;. As of the org Charter Pack
profile-integrity work (FR-001/FR-003/FR-004, NFR-007), every relationship is a
&lt;strong&gt;typed edge in the doctrine reference graph (DRG)&lt;/strong&gt;. Relationships are &lt;em&gt;not&lt;/em&gt;
authored as fields on the artifacts themselves.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;One authoring surface.&lt;/strong&gt; Author relationships as DRG &lt;strong&gt;fragment edges&lt;/strong&gt; in
the project’s &lt;code dir=&quot;auto&quot;&gt;graph.yaml&lt;/code&gt; (project tier), the per-kind &lt;code dir=&quot;auto&quot;&gt;*.graph.yaml&lt;/code&gt;
fragments under &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; (built-in tier), or &lt;code dir=&quot;auto&quot;&gt;drg/fragment.yaml&lt;/code&gt;
(org-pack tier).
The deprecated &lt;code dir=&quot;auto&quot;&gt;enhances:&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;overrides:&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;specializes-from:&lt;/code&gt; &lt;em&gt;artifact
fields&lt;/em&gt; are being retired (they become a hard error). The canonical relation
tokens live on the &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; enum in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/src/charter/offering/drg/models.py&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/models.py&lt;/code&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Every one of the 15 &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; members below has a dedicated section whose
body is copied &lt;strong&gt;verbatim&lt;/strong&gt; from the canonical &lt;code dir=&quot;auto&quot;&gt;RELATION_DESCRIPTIONS&lt;/code&gt;
registry in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/src/charter/offering/drg/models.py&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/models.py&lt;/code&gt;&lt;/a&gt;
— that registry is the single source of truth; these sections mirror it for
human readers, and the two are kept in parity by
&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_relation_doc_parity.py&lt;/code&gt; (FR-006/FR-012/NFR-003/NFR-004),
which now scopes &lt;strong&gt;all 15 relations&lt;/strong&gt;, not a subset.&lt;/p&gt;
&lt;h2 id=&quot;drg-schema-at-a-glance&quot;&gt;DRG schema at a glance&lt;/h2&gt;
&lt;p&gt;The graph itself is two small records — a &lt;strong&gt;node&lt;/strong&gt; and a typed &lt;strong&gt;edge&lt;/strong&gt; — over two
closed vocabularies. The schema diagram below is &lt;strong&gt;generated from the frozen code
models&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/models.py&lt;/code&gt;) and kept honest by the drift guard
(&lt;code dir=&quot;auto&quot;&gt;tests/docs/diagram_drift/&lt;/code&gt;, FR-004): every field and every enum member is
introspected from the live model (&lt;code dir=&quot;auto&quot;&gt;list(NodeKind)&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;list(Relation)&lt;/code&gt;), never
hand-copied, so this picture cannot silently drift from the code.&lt;/p&gt;
&lt;figure class=&quot;dk-diagram&quot; role=&quot;group&quot;&gt;&lt;svg xmlns=&quot;http://www.w3.org/2000/svg&quot; xmlns:xlink=&quot;http://www.w3.org/1999/xlink&quot; version=&quot;1.1&quot; data-diagram-type=&quot;YAML&quot; style=&quot;width:766px;height:987px;&quot; width=&quot;766px&quot; height=&quot;987px&quot; viewBox=&quot;0 0 766 987&quot; zoomAndPan=&quot;magnify&quot; preserveAspectRatio=&quot;none&quot; contentStyleType=&quot;text/css&quot;&gt;&lt;defs&gt;&lt;/defs&gt;&lt;g font-family=&quot;sans-serif&quot; lengthAdjust=&quot;spacing&quot;&gt;&lt;g class=&quot;title&quot;&gt;&lt;text x=&quot;20&quot; y=&quot;32.995&quot; fill=&quot;#000&quot; font-size=&quot;14&quot; textLength=&quot;724.281&quot; font-weight=&quot;700&quot;&gt;Doctrine Reference Graph — DRGNode, DRGEdge, and the NodeKind / Relation vocabularies&lt;/text&gt;&lt;/g&gt;&lt;rect x=&quot;188.804&quot; y=&quot;313.445&quot; width=&quot;109.838&quot; height=&quot;81.188&quot; fill=&quot;var(--dk-diagram-node-fill)&quot; style=&quot;stroke:var(--dk-diagram-node-fill);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;text x=&quot;193.804&quot; y=&quot;328.44&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;74.744&quot; font-weight=&quot;700&quot;&gt;DRGNode&lt;/text&gt;&lt;text x=&quot;280.292&quot; y=&quot;328.44&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;13.351&quot;&gt;   &lt;/text&gt;&lt;line x1=&quot;275.292&quot; y1=&quot;313.445&quot; x2=&quot;275.292&quot; y2=&quot;333.742&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;188.804&quot; y1=&quot;333.742&quot; x2=&quot;298.642&quot; y2=&quot;333.742&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;193.804&quot; y=&quot;348.737&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;72.994&quot; font-weight=&quot;700&quot;&gt;DRGEdge&lt;/text&gt;&lt;text x=&quot;280.292&quot; y=&quot;348.737&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;13.351&quot;&gt;   &lt;/text&gt;&lt;line x1=&quot;275.292&quot; y1=&quot;333.742&quot; x2=&quot;275.292&quot; y2=&quot;354.039&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;188.804&quot; y1=&quot;354.039&quot; x2=&quot;298.642&quot; y2=&quot;354.039&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;193.804&quot; y=&quot;369.034&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;76.487&quot; font-weight=&quot;700&quot;&gt;NodeKind&lt;/text&gt;&lt;text x=&quot;280.292&quot; y=&quot;369.034&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;13.351&quot;&gt;   &lt;/text&gt;&lt;line x1=&quot;275.292&quot; y1=&quot;354.039&quot; x2=&quot;275.292&quot; y2=&quot;374.336&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;188.804&quot; y1=&quot;374.336&quot; x2=&quot;298.642&quot; y2=&quot;374.336&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;193.804&quot; y=&quot;389.331&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;65.598&quot; font-weight=&quot;700&quot;&gt;Relation&lt;/text&gt;&lt;text x=&quot;280.292&quot; y=&quot;389.331&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;13.351&quot;&gt;   &lt;/text&gt;&lt;line x1=&quot;275.292&quot; y1=&quot;374.336&quot; x2=&quot;275.292&quot; y2=&quot;394.633&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;rect x=&quot;188.804&quot; y=&quot;313.445&quot; width=&quot;109.838&quot; height=&quot;81.188&quot; fill=&quot;none&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;rect x=&quot;346.804&quot; y=&quot;47.297&quot; width=&quot;218.099&quot; height=&quot;101.484&quot; fill=&quot;var(--dk-diagram-node-fill)&quot; style=&quot;stroke:var(--dk-diagram-node-fill);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;text x=&quot;351.804&quot; y=&quot;62.292&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;26.838&quot; font-weight=&quot;700&quot;&gt;urn&lt;/text&gt;&lt;text x=&quot;454.144&quot; y=&quot;62.292&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;94.172&quot;&gt;&amp;#x3C;kind&gt;:&amp;#x3C;id&gt;&lt;/text&gt;&lt;line x1=&quot;449.144&quot; y1=&quot;47.297&quot; x2=&quot;449.144&quot; y2=&quot;67.594&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;346.804&quot; y1=&quot;67.594&quot; x2=&quot;564.903&quot; y2=&quot;67.594&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;351.804&quot; y=&quot;82.589&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;34.098&quot; font-weight=&quot;700&quot;&gt;kind&lt;/text&gt;&lt;text x=&quot;454.144&quot; y=&quot;82.589&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;90.829&quot;&gt;&amp;#x3C;NodeKind&gt;&lt;/text&gt;&lt;line x1=&quot;449.144&quot; y1=&quot;67.594&quot; x2=&quot;449.144&quot; y2=&quot;87.891&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;346.804&quot; y1=&quot;87.891&quot; x2=&quot;564.903&quot; y2=&quot;87.891&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;351.804&quot; y=&quot;102.886&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;38.562&quot; font-weight=&quot;700&quot;&gt;label&lt;/text&gt;&lt;text x=&quot;454.144&quot; y=&quot;102.886&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;42&quot;&gt;&amp;#x3C;str&gt;&lt;/text&gt;&lt;line x1=&quot;449.144&quot; y1=&quot;87.891&quot; x2=&quot;449.144&quot; y2=&quot;108.188&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;346.804&quot; y1=&quot;108.188&quot; x2=&quot;564.903&quot; y2=&quot;108.188&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;351.804&quot; y=&quot;123.183&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;92.34&quot; font-weight=&quot;700&quot;&gt;provenance&lt;/text&gt;&lt;text x=&quot;454.144&quot; y=&quot;123.183&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;105.759&quot;&gt;&amp;#x3C;Provenance&gt;&lt;/text&gt;&lt;line x1=&quot;449.144&quot; y1=&quot;108.188&quot; x2=&quot;449.144&quot; y2=&quot;128.484&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;346.804&quot; y1=&quot;128.484&quot; x2=&quot;564.903&quot; y2=&quot;128.484&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;351.804&quot; y=&quot;143.479&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;34.494&quot; font-weight=&quot;700&quot;&gt;tags&lt;/text&gt;&lt;text x=&quot;454.144&quot; y=&quot;143.479&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;73.486&quot;&gt;&amp;#x3C;list[str]&gt;&lt;/text&gt;&lt;line x1=&quot;449.144&quot; y1=&quot;128.484&quot; x2=&quot;449.144&quot; y2=&quot;148.781&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;rect x=&quot;346.804&quot; y=&quot;47.297&quot; width=&quot;218.099&quot; height=&quot;101.484&quot; fill=&quot;none&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;rect x=&quot;335.804&quot; y=&quot;167.039&quot; width=&quot;239.673&quot; height=&quot;121.781&quot; fill=&quot;var(--dk-diagram-node-fill)&quot; style=&quot;stroke:var(--dk-diagram-node-fill);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;text x=&quot;340.804&quot; y=&quot;182.034&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;52.616&quot; font-weight=&quot;700&quot;&gt;source&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;182.034&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;46.963&quot;&gt;&amp;#x3C;urn&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;167.039&quot; x2=&quot;438.144&quot; y2=&quot;187.336&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;335.804&quot; y1=&quot;187.336&quot; x2=&quot;575.477&quot; y2=&quot;187.336&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;340.804&quot; y=&quot;202.331&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;49.253&quot; font-weight=&quot;700&quot;&gt;target&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;202.331&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;46.963&quot;&gt;&amp;#x3C;urn&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;187.336&quot; x2=&quot;438.144&quot; y2=&quot;207.633&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;335.804&quot; y1=&quot;207.633&quot; x2=&quot;575.477&quot; y2=&quot;207.633&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;340.804&quot; y=&quot;222.628&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;61.722&quot; font-weight=&quot;700&quot;&gt;relation&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;222.628&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;81.088&quot;&gt;&amp;#x3C;Relation&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;207.633&quot; x2=&quot;438.144&quot; y2=&quot;227.93&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;335.804&quot; y1=&quot;227.93&quot; x2=&quot;575.477&quot; y2=&quot;227.93&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;340.804&quot; y=&quot;242.925&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;42.362&quot; font-weight=&quot;700&quot;&gt;when&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;242.925&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;127.333&quot;&gt;&amp;#x3C;condition | null&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;227.93&quot; x2=&quot;438.144&quot; y2=&quot;248.227&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;335.804&quot; y1=&quot;248.227&quot; x2=&quot;575.477&quot; y2=&quot;248.227&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;340.804&quot; y=&quot;263.222&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;53.765&quot; font-weight=&quot;700&quot;&gt;reason&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;263.222&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;81.143&quot;&gt;&amp;#x3C;str | null&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;248.227&quot; x2=&quot;438.144&quot; y2=&quot;268.523&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;line x1=&quot;335.804&quot; y1=&quot;268.523&quot; x2=&quot;575.477&quot; y2=&quot;268.523&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;340.804&quot; y=&quot;283.519&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;92.34&quot; font-weight=&quot;700&quot;&gt;provenance&lt;/text&gt;&lt;text x=&quot;443.144&quot; y=&quot;283.519&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;105.759&quot;&gt;&amp;#x3C;Provenance&gt;&lt;/text&gt;&lt;line x1=&quot;438.144&quot; y1=&quot;268.523&quot; x2=&quot;438.144&quot; y2=&quot;288.82&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;rect x=&quot;335.804&quot; y=&quot;167.039&quot; width=&quot;239.673&quot; height=&quot;121.781&quot; fill=&quot;none&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;rect x=&quot;372.804&quot; y=&quot;307.516&quot; width=&quot;165.873&quot; height=&quot;345.047&quot; fill=&quot;var(--dk-diagram-node-fill)&quot; style=&quot;stroke:var(--dk-diagram-node-fill);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;text x=&quot;377.804&quot; y=&quot;322.511&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;61.12&quot;&gt;directive&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;327.813&quot; x2=&quot;538.677&quot; y2=&quot;327.813&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;342.808&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;38.842&quot;&gt;tactic&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;348.109&quot; x2=&quot;538.677&quot; y2=&quot;348.109&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;363.104&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;67.102&quot;&gt;paradigm&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;368.406&quot; x2=&quot;538.677&quot; y2=&quot;368.406&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;383.401&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;72.721&quot;&gt;styleguide&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;388.703&quot; x2=&quot;538.677&quot; y2=&quot;388.703&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;403.698&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;65.659&quot;&gt;toolguide&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;409&quot; x2=&quot;538.677&quot; y2=&quot;409&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;423.995&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;71.647&quot;&gt;procedure&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;429.297&quot; x2=&quot;538.677&quot; y2=&quot;429.297&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;444.292&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;91.971&quot;&gt;agent_profile&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;449.594&quot; x2=&quot;538.677&quot; y2=&quot;449.594&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;464.589&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;155.873&quot;&gt;mission_step_contract&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;469.891&quot; x2=&quot;538.677&quot; y2=&quot;469.891&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;484.886&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;63.198&quot;&gt;template&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;490.188&quot; x2=&quot;538.677&quot; y2=&quot;490.188&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;505.183&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;37.27&quot;&gt;asset&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;510.484&quot; x2=&quot;538.677&quot; y2=&quot;510.484&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;525.479&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;43.094&quot;&gt;action&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;530.781&quot; x2=&quot;538.677&quot; y2=&quot;530.781&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;545.776&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;106.606&quot;&gt;glossary_scope&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;551.078&quot; x2=&quot;538.677&quot; y2=&quot;551.078&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;566.073&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;58.55&quot;&gt;glossary&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;571.375&quot; x2=&quot;538.677&quot; y2=&quot;571.375&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;586.37&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;98.82&quot;&gt;glossary_pack&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;591.672&quot; x2=&quot;538.677&quot; y2=&quot;591.672&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;606.667&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;91.718&quot;&gt;mission_type&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;611.969&quot; x2=&quot;538.677&quot; y2=&quot;611.969&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;626.964&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;85.518&quot;&gt;anti_pattern&lt;/text&gt;&lt;line x1=&quot;372.804&quot; y1=&quot;632.266&quot; x2=&quot;538.677&quot; y2=&quot;632.266&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;377.804&quot; y=&quot;647.261&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;27.07&quot;&gt;skill&lt;/text&gt;&lt;rect x=&quot;372.804&quot; y=&quot;307.516&quot; width=&quot;165.873&quot; height=&quot;345.047&quot; fill=&quot;none&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;rect x=&quot;386.304&quot; y=&quot;670.813&quot; width=&quot;139.486&quot; height=&quot;304.453&quot; fill=&quot;var(--dk-diagram-node-fill)&quot; style=&quot;stroke:var(--dk-diagram-node-fill);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;text x=&quot;391.304&quot; y=&quot;685.808&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;57.682&quot;&gt;requires&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;691.109&quot; x2=&quot;525.791&quot; y2=&quot;691.109&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;706.104&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;62.631&quot;&gt;suggests&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;711.406&quot; x2=&quot;525.791&quot; y2=&quot;711.406&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;726.401&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;50.039&quot;&gt;applies&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;731.703&quot; x2=&quot;525.791&quot; y2=&quot;731.703&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;746.698&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;41.057&quot;&gt;scope&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;752&quot; x2=&quot;525.791&quot; y2=&quot;752&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;766.995&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;77.396&quot;&gt;vocabulary&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;772.297&quot; x2=&quot;525.791&quot; y2=&quot;772.297&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;787.292&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;82.353&quot;&gt;instantiates&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;792.594&quot; x2=&quot;525.791&quot; y2=&quot;792.594&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;807.589&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;59.329&quot;&gt;replaces&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;812.891&quot; x2=&quot;525.791&quot; y2=&quot;812.891&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;827.886&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;89.92&quot;&gt;delegates_to&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;833.188&quot; x2=&quot;525.791&quot; y2=&quot;833.188&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;848.183&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;115.883&quot;&gt;specializes_from&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;853.484&quot; x2=&quot;525.791&quot; y2=&quot;853.484&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;868.479&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;67.416&quot;&gt;enhances&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;873.781&quot; x2=&quot;525.791&quot; y2=&quot;873.781&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;888.776&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;65.659&quot;&gt;overrides&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;894.078&quot; x2=&quot;525.791&quot; y2=&quot;894.078&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;909.073&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;47.968&quot;&gt;refines&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;914.375&quot; x2=&quot;525.791&quot; y2=&quot;914.375&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;929.37&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;108.063&quot;&gt;in_tension_with&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;934.672&quot; x2=&quot;525.791&quot; y2=&quot;934.672&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;949.667&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;129.486&quot;&gt;reconciles_tension&lt;/text&gt;&lt;line x1=&quot;386.304&quot; y1=&quot;954.969&quot; x2=&quot;525.791&quot; y2=&quot;954.969&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1;&quot;&gt;&lt;/line&gt;&lt;text x=&quot;391.304&quot; y=&quot;969.964&quot; fill=&quot;var(--dk-diagram-node-text)&quot; font-size=&quot;14&quot; textLength=&quot;47.353&quot;&gt;rejects&lt;/text&gt;&lt;rect x=&quot;386.304&quot; y=&quot;670.813&quot; width=&quot;139.486&quot; height=&quot;304.453&quot; fill=&quot;none&quot; style=&quot;stroke:var(--dk-diagram-node-border);stroke-width:1.5;&quot; rx=&quot;5&quot; ry=&quot;5&quot;&gt;&lt;/rect&gt;&lt;path d=&quot;M287.304,325.039 L287.304,312.039 C287.304,240.281 289.286,212.678 335.804,158.039 C337.643,155.879 339.579,153.789 341.597,151.766&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;stroke-dasharray:3,3;&quot; fill=&quot;none&quot;&gt;&lt;/path&gt;&lt;path d=&quot;M343.676,153.978 L343.256,150.207 L339.519,149.555 L347.126,146.57 L343.676,153.978&quot; fill=&quot;var(--dk-diagram-edge)&quot;&gt;&lt;/path&gt;&lt;ellipse cx=&quot;287.304&quot; cy=&quot;325.039&quot; rx=&quot;3&quot; ry=&quot;3&quot; fill=&quot;var(--dk-diagram-edge)&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;&quot;&gt;&lt;/ellipse&gt;&lt;path d=&quot;M286.804,344.039 L299.804,344.039 C325.765,344.039 316.258,315.125 335.804,298.039 C337.309,296.724 338.842,295.42 340.4,294.128&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;stroke-dasharray:3,3;&quot; fill=&quot;none&quot;&gt;&lt;/path&gt;&lt;path d=&quot;M342.368,296.579 L342.238,292.653 L338.432,291.678 L346.525,289.209 L342.368,296.579&quot; fill=&quot;var(--dk-diagram-edge)&quot;&gt;&lt;/path&gt;&lt;ellipse cx=&quot;286.804&quot; cy=&quot;344.039&quot; rx=&quot;3&quot; ry=&quot;3&quot; fill=&quot;var(--dk-diagram-edge)&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;&quot;&gt;&lt;/ellipse&gt;&lt;path d=&quot;M286.804,364.039 L299.804,364.039 C323.814,364.039 346.509,373.034 366.761,386.013&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;stroke-dasharray:3,3;&quot; fill=&quot;none&quot;&gt;&lt;/path&gt;&lt;path d=&quot;M365.021,388.609 L368.707,387.318 L368.5,383.418 L373.248,390.361 L365.021,388.609&quot; fill=&quot;var(--dk-diagram-edge)&quot;&gt;&lt;/path&gt;&lt;ellipse cx=&quot;286.804&quot; cy=&quot;364.039&quot; rx=&quot;3&quot; ry=&quot;3&quot; fill=&quot;var(--dk-diagram-edge)&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;&quot;&gt;&lt;/ellipse&gt;&lt;path d=&quot;M287.304,383.039 L287.304,396.039 C287.304,516.21 287.965,551.8 335.804,662.039 C347.507,689.007 364.494,715.703 382.004,739.373&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;stroke-dasharray:3,3;&quot; fill=&quot;none&quot;&gt;&lt;/path&gt;&lt;path d=&quot;M379.496,741.254 L383.416,741.254 L384.513,737.491 L386.708,745.644 L379.496,741.254&quot; fill=&quot;var(--dk-diagram-edge)&quot;&gt;&lt;/path&gt;&lt;ellipse cx=&quot;287.304&quot; cy=&quot;383.039&quot; rx=&quot;3&quot; ry=&quot;3&quot; fill=&quot;var(--dk-diagram-edge)&quot; style=&quot;stroke:var(--dk-diagram-edge);stroke-width:1;&quot;&gt;&lt;/ellipse&gt;&lt;/g&gt;&lt;/svg&gt;&lt;/figure&gt;
&lt;p&gt;A &lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;DRGNode&lt;/code&gt;&lt;/strong&gt; is an addressable artefact (its &lt;code dir=&quot;auto&quot;&gt;urn&lt;/code&gt; is &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;kind&gt;:&amp;#x3C;id&gt;&lt;/code&gt;, where
&lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;kind&gt;&lt;/code&gt; is one of the &lt;code dir=&quot;auto&quot;&gt;NodeKind&lt;/code&gt; members); a &lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;DRGEdge&lt;/code&gt;&lt;/strong&gt; is a directional,
typed relationship whose &lt;code dir=&quot;auto&quot;&gt;relation&lt;/code&gt; is one of the &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; members. Everything
below — lineage, delegation, augmentation, the action-resolution relations, and
the tension vocabulary — is just a &lt;code dir=&quot;auto&quot;&gt;relation&lt;/code&gt; value on an edge.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Prose counts are narrative, not guarded.&lt;/strong&gt; The “15” (relations) and “16”
(node kinds) that appear in this page’s prose are human-facing narration; they
are &lt;strong&gt;diagram-unguarded&lt;/strong&gt;. The drift guard enforces the &lt;em&gt;diagram ↔ model&lt;/em&gt; match
by introspecting &lt;code dir=&quot;auto&quot;&gt;list(Relation)&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;list(NodeKind)&lt;/code&gt; — it does not read the prose
literal. If a member is added or removed, update the diagram (the guard will
fail until you do) and refresh the prose counts by hand.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;the-three-relationship-families&quot;&gt;The three relationship families&lt;/h2&gt;
&lt;p&gt;Lineage, delegation, and augmentation are three &lt;strong&gt;distinct&lt;/strong&gt; concepts and must
never be conflated. The DRG keeps them as separate relation types so traversal
never accidentally crosses from one to another.&lt;/p&gt;
&lt;h3 id=&quot;lineage--specializes_from&quot;&gt;Lineage — &lt;code dir=&quot;auto&quot;&gt;specializes_from&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional, static lineage edge: a profile or artifact derives from a parent, narrowing or extending it. Emitted 4 times in the built-in graph, exclusively &lt;code dir=&quot;auto&quot;&gt;agent_profile&lt;/code&gt; -&gt; &lt;code dir=&quot;auto&quot;&gt;agent_profile&lt;/code&gt; (e.g. &lt;code dir=&quot;auto&quot;&gt;python-pedro&lt;/code&gt; —specializes_from—&gt; &lt;code dir=&quot;auto&quot;&gt;implementer-ivan&lt;/code&gt;). Resolved via &lt;code dir=&quot;auto&quot;&gt;AgentProfileRepository.resolve_profile&lt;/code&gt; graph traversal at composition time, and deliberately distinct from &lt;code dir=&quot;auto&quot;&gt;delegates_to&lt;/code&gt; so inheritance never leaks into runtime handoff traversal.&lt;/p&gt;
&lt;h3 id=&quot;delegation--delegates_to&quot;&gt;Delegation — &lt;code dir=&quot;auto&quot;&gt;delegates_to&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional, runtime handoff edge: one agent profile hands work to another at execution time (e.g. an implementer profile delegating a review to a reviewer profile). Deliberately kept separate from &lt;code dir=&quot;auto&quot;&gt;specializes_from&lt;/code&gt; so a static lineage relationship is never conflated with a live work handoff. Intended-but-dormant: zero edges exist in the built-in graph today — delegation is currently expressed through a profile’s &lt;code dir=&quot;auto&quot;&gt;collaboration.handoff_to&lt;/code&gt; prose field, not a graph edge.&lt;/p&gt;
&lt;h4 id=&quot;augmentation-family-enhancement-override-and-legacy-replacement&quot;&gt;Augmentation family: enhancement, override, and legacy replacement&lt;/h4&gt;
&lt;p&gt;An &lt;em&gt;overlay&lt;/em&gt; relation family, used when a higher layer (an org pack or project
tier) adjusts a built-in artifact. Augmentation edges may be authored against
every augmentation-eligible kind: directives, tactics, styleguides,
toolguides, paradigms, procedures, agent profiles, mission step contracts, and
mission types. Each of the three relations below is a distinct edge-role with
its own dedicated section below — the parity comparator requires one heading
per relation, since a single shared heading cannot content-equal three
distinct registry strings.&lt;/p&gt;
&lt;h3 id=&quot;enhancement--enhances&quot;&gt;Enhancement — &lt;code dir=&quot;auto&quot;&gt;enhances&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional org-pack overlay edge: a pack artifact field-merges additional content into a built-in artifact, preserving the built-in’s action sequence and step I/O rather than replacing them. Zero edges exist in the built-in graph by design — &lt;code dir=&quot;auto&quot;&gt;enhances&lt;/code&gt; only ever originates from an org- or project-tier pack fragment layered on top of a shipped artifact, never between two built-in nodes. Distinct from &lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;, which replaces rather than merges.&lt;/p&gt;
&lt;h3 id=&quot;override--overrides&quot;&gt;Override — &lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional org-pack overlay edge: a pack artifact declares a full replacement of a built-in artifact’s content, rather than a field-merge. Zero edges exist in the built-in graph by design, for the same reason as &lt;code dir=&quot;auto&quot;&gt;enhances&lt;/code&gt; — it only ever originates from an org- or project-tier overlay, never between two built-in nodes. Silently dropping steps or stripping step I/O when applying an &lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt; edge is rejected by the loader.&lt;/p&gt;
&lt;h3 id=&quot;replacement-legacy--replaces&quot;&gt;Replacement (legacy) — &lt;code dir=&quot;auto&quot;&gt;replaces&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional supersession edge: the source artifact fully supersedes the target, which is no longer applicable once the source is active. Retained for backward compatibility with existing hand-authored fragments; zero edges exist in the built-in graph by design — new supersession is expressed by deactivating the superseded artifact directly, or, for pack overlays, via &lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;. Distinct from &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt;, which never implies that either side is deprecated or wrong.&lt;/p&gt;
&lt;h2 id=&quot;action-resolution-relations--requires-suggests-applies-scope-vocabulary-instantiates-refines&quot;&gt;Action-resolution relations — &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;vocabulary&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;instantiates&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;refines&lt;/code&gt;&lt;/h2&gt;
&lt;p&gt;These seven relations govern how &lt;code dir=&quot;auto&quot;&gt;resolve_action_context&lt;/code&gt; and the charter
cascade walk the graph outward from an action’s directly-scoped artifacts, and
how profiles and actions connect to the workflow content and outputs they use
or produce.&lt;/p&gt;
&lt;h3 id=&quot;requirement--requires&quot;&gt;Requirement — &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional, hard-dependency edge: resolving or activating the source artifact pulls in the target as a mandatory prerequisite. &lt;code dir=&quot;auto&quot;&gt;resolve_action_context&lt;/code&gt; walks &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; edges transitively, with no depth limit, from an action’s &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;-resolved artifacts; &lt;code dir=&quot;auto&quot;&gt;charter activate --cascade&lt;/code&gt; follows the same edge to pull in artifacts that must also be active. It is the second-most-emitted relation in the built-in graph (323 edges) and is the mandatory counterpart to &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt;, not a stronger synonym for it.&lt;/p&gt;
&lt;h3 id=&quot;suggestion--suggests&quot;&gt;Suggestion — &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional, soft-recommendation edge: the source artifact points at content that is relevant but not mandatory. &lt;code dir=&quot;auto&quot;&gt;resolve_action_context&lt;/code&gt; walks &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt; edges only up to a bounded hop depth — unlike the unbounded transitive walk used for &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; — and the charter cascade treats a &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt; target as optional, something an operator may accept or skip. It is the most-emitted relation in the built-in graph (450 edges); the boundedness of the walk, not the edge count, is what distinguishes it from &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;application--applies&quot;&gt;Application — &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Names the edge from an agent profile to the concrete procedure or tactic that profile executes as its operating workflow. Zero edges exist in the built-in graph, and authoring one is refused by &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_no_authored_applies_edge.py&lt;/code&gt;: no context resolution, no charter cascade and no reference walk follows &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt;, so an authored one names a relationship nothing traverses. The single shipped example (&lt;code dir=&quot;auto&quot;&gt;agent_profile:doctrine-daphne&lt;/code&gt; —applies—&gt; &lt;code dir=&quot;auto&quot;&gt;procedure:onboard-external-agent-to-pack&lt;/code&gt;) was retyped to &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; because it was that procedure’s only inbound edge and left the profile’s own operating procedure unreachable. The relation itself is not dead — the orphan lint accepts it as an inbound edge on a &lt;code dir=&quot;auto&quot;&gt;directive&lt;/code&gt; node, and an operator-authored project overlay may still carry one — so what is forbidden is authoring one into the shipped tree, not the relation existing. Project-tier synthesis emits no &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt; edge: it links a directive to its how-we-apply tactic with &lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt;, and strips a legacy &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt; edge whose source is a synthesized node. Distinct from &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;, which names the action-to-governance-artifact edge role, not a profile’s own operating procedure — the two are never interchangeable.&lt;/p&gt;
&lt;h3 id=&quot;scope--scope&quot;&gt;Scope — &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Names the edge from a mission-step action node to the directives and tactics that govern performing that action, or — since #3604 — from a mission_type node to the type-wide governance its governance-profile.yaml selects. The action-sourced edges are the entry point walked at depth 1 by &lt;code dir=&quot;auto&quot;&gt;resolve_action_context&lt;/code&gt; before it expands through &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt;; the mission_type-sourced edges are instead the entry point the charter cascade (&lt;code dir=&quot;auto&quot;&gt;REFERENCE_RELATIONS&lt;/code&gt;) walks when activating a mission type. It is the most heavily emitted action-adjacent relation in the built-in graph — 204 edges as measured by a live extraction after #3604 (165 action-sourced, unchanged from before #3604 since this pass is purely additive, plus 39 mission_type-sourced); this count is not enforced by any test against the graph, so treat it as directional, not exact. Distinct from &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt; says an action — or a mission type’s own type-wide selections — is governed by an artifact; &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt; says a profile executes a workflow artifact. Despite both linking guidance content to a governed node, they name different edge-roles and are never interchangeable.&lt;/p&gt;
&lt;p&gt;DELIBERATE ACCEPTED DEBT (#3633): one &lt;code dir=&quot;auto&quot;&gt;Relation.SCOPE&lt;/code&gt; member now carries two distinct source-node grains (action-sourced and mission_type-sourced, above) instead of two separate relations. This is a deliberate decision, not an oversight — splitting the grain into e.g. &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;type_scope&lt;/code&gt; would churn every consumer’s relation vocabulary (query filters, the charter cascade’s &lt;code dir=&quot;auto&quot;&gt;REFERENCE_RELATIONS&lt;/code&gt;, doctrine docs) and force a DRG merge/projection migration for a purely cosmetic grain distinction the graph already encodes structurally (a scope edge’s source-node kind — &lt;code dir=&quot;auto&quot;&gt;action&lt;/code&gt; vs &lt;code dir=&quot;auto&quot;&gt;mission_type&lt;/code&gt; — tells a consumer which grain it is without a second relation name). Do NOT split this relation to “fix” the overload; if a genuine behavioral need for two distinct relations ever arises, that is a new decision to make explicitly, not a refactor of this one.&lt;/p&gt;
&lt;h3 id=&quot;vocabulary--vocabulary&quot;&gt;Vocabulary — &lt;code dir=&quot;auto&quot;&gt;vocabulary&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Names the edge from a resolved doctrine artifact to a &lt;code dir=&quot;auto&quot;&gt;glossary_scope&lt;/code&gt; node, walked at depth 1 by &lt;code dir=&quot;auto&quot;&gt;resolve_action_context&lt;/code&gt; to surface which glossary sections apply to an action’s resolved context. Intended-but-dormant: zero edges exist in the built-in graph today, so no action currently pulls in glossary scope through this relation — the walk is implemented and exercised by tests, but no artifact author has emitted one yet.&lt;/p&gt;
&lt;h3 id=&quot;instantiation--instantiates&quot;&gt;Instantiation — &lt;code dir=&quot;auto&quot;&gt;instantiates&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional edge from a mission-step action node to the template it produces as its concrete output artifact, e.g. &lt;code dir=&quot;auto&quot;&gt;action:documentation/design&lt;/code&gt; —instantiates—&gt; &lt;code dir=&quot;auto&quot;&gt;template:documentation/documentation-plan-template.md&lt;/code&gt;. Emitted 11 times in the built-in graph, exclusively from &lt;code dir=&quot;auto&quot;&gt;action&lt;/code&gt; nodes to &lt;code dir=&quot;auto&quot;&gt;template&lt;/code&gt; nodes. Distinct from &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;, which links an action to governance content it must follow, not content it produces.&lt;/p&gt;
&lt;h3 id=&quot;refinement--refines&quot;&gt;Refinement — &lt;code dir=&quot;auto&quot;&gt;refines&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional edge: an artifact narrows or sharpens the applicability or meaning of its target (a parent or built-in artifact) without replacing it — a first-class, traversable relation, never a synonym for &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;specializes_from&lt;/code&gt;. The built-in graph uses it for fixed-lens specialisations: the five-paradigm-parallel-debugging and paula-patterns-architecture-scout-review tactics refine the adversarial-squad-deployment procedure. Charter cascade follows &lt;code dir=&quot;auto&quot;&gt;refines&lt;/code&gt;; action-context delivery does not. The org-to-DRG bridge previously downgraded authored &lt;code dir=&quot;auto&quot;&gt;refines&lt;/code&gt; edges to &lt;code dir=&quot;auto&quot;&gt;applies&lt;/code&gt; silently; that lossy downgrade has been removed, so &lt;code dir=&quot;auto&quot;&gt;refines&lt;/code&gt; survives end-to-end.&lt;/p&gt;
&lt;h2 id=&quot;tension-vocabulary--in_tension_with-reconciles_tension-rejects&quot;&gt;Tension vocabulary — &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;reconciles_tension&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;rejects&lt;/code&gt;&lt;/h2&gt;
&lt;p&gt;Doctrine disagreement is modelled as three additional typed edges, added by
mission &lt;code dir=&quot;auto&quot;&gt;doctrine-tension-edges-01KY1WPC&lt;/code&gt; (FR-001/002/003) alongside the
lineage/delegation/augmentation and action-resolution families above, and
explicitly &lt;strong&gt;not&lt;/strong&gt; to be confused with them or with each other. As with every
other relation on this page, the description text below is copied
&lt;strong&gt;verbatim&lt;/strong&gt; from the canonical &lt;code dir=&quot;auto&quot;&gt;RELATION_DESCRIPTIONS&lt;/code&gt; registry and is kept
in parity by &lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_relation_doc_parity.py&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;tension--in_tension_with&quot;&gt;Tension — &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Marks two co-valid, co-activatable artefacts that compete on the same decision. The relation is symmetric and non-transitive: it is stored as a single canonical edge (lexicographically-smaller URN as source) and is queryable from either endpoint. It does not imply that either side is deprecated, superseded, or wrong — both remain valid rules until an operator deactivates one side or activates a reconciler.&lt;/p&gt;
&lt;h3 id=&quot;reconciliation--reconciles_tension&quot;&gt;Reconciliation — &lt;code dir=&quot;auto&quot;&gt;reconciles_tension&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Links an active reconciliation artefact to one side of a declared tension pair. A tension pair is treated as resolved only when an active artefact carries this edge to BOTH sides of the pair — an edge to just one side leaves the pair half-reconciled and still flagged. It is authored explicitly and is never inferred from an &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt; edge.&lt;/p&gt;
&lt;h3 id=&quot;rejection--rejects&quot;&gt;Rejection — &lt;code dir=&quot;auto&quot;&gt;rejects&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;A directional edge from a good artefact to a marked anti-pattern or smell node (&lt;code dir=&quot;auto&quot;&gt;NodeKind.ANTI_PATTERN&lt;/code&gt;), expressing rejection of a named bad practice. It is distinct from &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt; — the target is not a competing equal, it is a bad practice — and from &lt;code dir=&quot;auto&quot;&gt;replaces&lt;/code&gt;/supersession, since the target was never a valid rule to begin with.&lt;/p&gt;
&lt;h2 id=&quot;authoring-examples&quot;&gt;Authoring examples&lt;/h2&gt;
&lt;p&gt;Worked YAML examples for the relations above, re-homed here so the per-relation
sections directly above stay content-equal to the registry (a code example
embedded inside a parity-enforced section body would break verbatim equality).&lt;/p&gt;
&lt;h3 id=&quot;lineage-edge&quot;&gt;Lineage edge&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# packs/built-in/&amp;#x3C;kind&gt;.graph.yaml (built-in tier) — lineage authored as an edge&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;edges&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:python-pedro&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:implementer-ivan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specializes_from&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;reason&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Python Pedro is a language-specialist implementer derived from Implementer Ivan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;augmentation-edges&quot;&gt;Augmentation edges&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# drg/fragment.yaml (org-pack tier) — augmentation authored as edges&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;edges&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;directive:org-directive&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;directive:org-directive&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;enhances&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;reason&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Directive overlay enhances a built-in directive&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;mission_type:org-mission-type&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;mission_type:org-mission-type&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;overrides&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;reason&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Mission-type overlay replaces a built-in mission type&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;canonical-authoring-example&quot;&gt;Canonical authoring example&lt;/h3&gt;
&lt;p&gt;Two profiles, one lineage edge:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame has-title not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;graph.yaml&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;nodes&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;urn&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:implementer-ivan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;kind&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;label&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Implementer Ivan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;urn&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:python-pedro&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;kind&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;label&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Python Pedro&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;edges&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:python-pedro&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent_profile:implementer-ivan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specializes_from&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Org packs use the same model in &lt;code dir=&quot;auto&quot;&gt;drg/fragment.yaml&lt;/code&gt;, addressing nodes by their
short &lt;code dir=&quot;auto&quot;&gt;id&lt;/code&gt; + plural &lt;code dir=&quot;auto&quot;&gt;kind&lt;/code&gt;; the merge bridges those to canonical &lt;code dir=&quot;auto&quot;&gt;kind:id&lt;/code&gt; URNs.&lt;/p&gt;
&lt;h2 id=&quot;why-edges-not-fields&quot;&gt;Why edges, not fields&lt;/h2&gt;
&lt;p&gt;Authoring relationships as artifact fields made the relationship invisible to
the graph until each artifact was individually parsed, and split the same
concept across several field spellings (&lt;code dir=&quot;auto&quot;&gt;specializes-from&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;enhances&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;). Modelling every relationship as a DRG edge gives a single,
queryable, layer-aware authority:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;One source of truth.&lt;/strong&gt; The merged DRG is the only place relationships live;
there is no field-vs-edge ambiguity.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Zero-loss migration (NFR-007).&lt;/strong&gt; Every previously field-authored
relationship maps to exactly one merged edge. The migration test
(&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_relationship_migration.py&lt;/code&gt;) discovers the field-authored
set from the built-in artifacts and proves each one has a corresponding edge —
it never trusts a hardcoded count.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Fail-closed semantics (FR-003).&lt;/strong&gt; An edge whose &lt;code dir=&quot;auto&quot;&gt;relation&lt;/code&gt; token is not a
recognised member of the &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; enum is rejected loudly at load time
rather than being silently dropped.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;living-documentation&quot;&gt;Living documentation&lt;/h2&gt;
&lt;p&gt;Per &lt;code dir=&quot;auto&quot;&gt;DIRECTIVE_037&lt;/code&gt; (living-documentation sync), this page is kept in step with
the &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; enum and the migration tests. When a relation type is added,
removed, or its semantics change, update:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;the &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; enum docstring in &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/models.py&lt;/code&gt;,&lt;/li&gt;
&lt;li&gt;the &lt;code dir=&quot;auto&quot;&gt;RELATION_DESCRIPTIONS&lt;/code&gt; entry for that relation,&lt;/li&gt;
&lt;li&gt;this explanation page, and&lt;/li&gt;
&lt;li&gt;the relationship-migration tests and fixtures
(&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_relationship_migration.py&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/fixtures/relationship_packs/&lt;/code&gt;).&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Every one of the 15 &lt;code dir=&quot;auto&quot;&gt;Relation&lt;/code&gt; members has its own dedicated &lt;code dir=&quot;auto&quot;&gt;### …&lt;/code&gt; section
above, and each section must stay byte-identical (whitespace aside) to
&lt;code dir=&quot;auto&quot;&gt;RELATION_DESCRIPTIONS&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/models.py&lt;/code&gt; —
&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_relation_doc_parity.py&lt;/code&gt; enforces this for all 15 and
fails red, naming the relation, on any drift. There is no remaining subset of
relations excluded from this parity check: the doc-parity restructure
(mission &lt;code dir=&quot;auto&quot;&gt;drg-relation-parity-activation-gate-01KY48PD&lt;/code&gt;) is the follow-up that
closed the gap left by the original 3-relation scope.&lt;/p&gt;
&lt;h2 id=&quot;drg-edges-are-the-canonical-relationship-authority&quot;&gt;DRG edges are the canonical relationship authority&lt;/h2&gt;
&lt;p&gt;The artifact schemas under &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt; and the &lt;code dir=&quot;auto&quot;&gt;assets/&lt;/code&gt; layout predate
the DRG canonical system. Inline &lt;code dir=&quot;auto&quot;&gt;references: [{type, id}]&lt;/code&gt; blocks in artifact YAML are
&lt;strong&gt;pre-DRG residue&lt;/strong&gt; to be migrated to DRG edges — not a parallel authority (ADR
&lt;a href=&quot;/adr/3.x/2026-07-26-1-drg-edges-are-the-canonical-relationship-authority/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;2026-07-26-1-drg-edges-are-the-canonical-relationship-authority&lt;/code&gt;&lt;/a&gt;).
The per-kind &lt;code dir=&quot;auto&quot;&gt;*.graph.yaml&lt;/code&gt; fragments are &lt;code dir=&quot;auto&quot;&gt;generated_by: drg-migration-v1&lt;/code&gt; — the
migration extractor &lt;em&gt;derives&lt;/em&gt; edges from the inline blocks, so the canonical graph is
largely a build output of the surface it replaces.&lt;/p&gt;
&lt;p&gt;Consequences for authors:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;New artefact relationships are authored as edges, never inline references.&lt;/strong&gt; A new
artefact should land with zero inline &lt;code dir=&quot;auto&quot;&gt;references:&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;A kind that cannot be named in a &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;kind&gt;_reference.type&lt;/code&gt; enum
(&lt;code dir=&quot;auto&quot;&gt;directive&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;paradigm&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;procedure&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;tactic&lt;/code&gt;) is &lt;strong&gt;correct behaviour, not a
bug&lt;/strong&gt; — never widen those enums to admit a kind. The recurring “asset support is not
end-to-end” finding is this trap; fix the tooling to serve intent rather than
relabelling the artefact.&lt;/li&gt;
&lt;li&gt;Relation vocabulary is defined once, in &lt;code dir=&quot;auto&quot;&gt;charter.offering.drg.models.Relation&lt;/code&gt; — read
it there rather than re-deriving the set.&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
