<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/calibration/">
  <id>https://docs.spec-kitty.ai/architecture/calibration/</id>
  <title>Calibration Report Template</title>
  <updated>2026-10-08T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/calibration/"/>
  <summary>Template for per-mission-type calibration reports that check, for every mission step, that DRG context resolution returns what the step needs and nothing irrelevant.</summary>
  <content type="html">&lt;span id=&quot;calibration-report-template&quot;&gt;&lt;/span&gt;
&lt;h2 id=&quot;what-this-checks&quot;&gt;What this checks&lt;/h2&gt;
&lt;p&gt;For every step of a mission type, calibration compares the context the step
&lt;strong&gt;needs&lt;/strong&gt; (its required scope) with the context the DRG actually &lt;strong&gt;resolves&lt;/strong&gt; for it.
Two things must hold: everything required is resolved (a gap is a &lt;em&gt;half-1
violation&lt;/em&gt;), and nothing irrelevant is resolved (extra context is a &lt;em&gt;half-2
violation&lt;/em&gt;). In the originating spec this is the “§4.5.1 inequality check” (R-005).&lt;/p&gt;
&lt;p&gt;Each per-mission-type report records that check for every step, and is updated
whenever calibration is re-run.&lt;/p&gt;
&lt;h2 id=&quot;column-shape&quot;&gt;Column Shape&lt;/h2&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Column&lt;/th&gt;&lt;th&gt;Notes&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Step id&lt;/td&gt;&lt;td&gt;The mission step under calibration.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Action id&lt;/td&gt;&lt;td&gt;Resolved action URN (e.g. &lt;code dir=&quot;auto&quot;&gt;action:software-dev/implement&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Profile id&lt;/td&gt;&lt;td&gt;Agent-profile URN assigned to this step.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Resolved DRG artifact URNs&lt;/td&gt;&lt;td&gt;Output of the DRG &lt;code dir=&quot;auto&quot;&gt;resolve_context&lt;/code&gt; call (direct scope + transitive requires/suggests).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Scope edges involved&lt;/td&gt;&lt;td&gt;Direct &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt; edges from the action node that seed the resolution.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Missing context&lt;/td&gt;&lt;td&gt;URNs in &lt;code dir=&quot;auto&quot;&gt;RequiredScope&lt;/code&gt; but absent from &lt;code dir=&quot;auto&quot;&gt;ResolvedScope&lt;/code&gt; — a half-1 violation.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Irrelevant / too-broad context&lt;/td&gt;&lt;td&gt;URNs in &lt;code dir=&quot;auto&quot;&gt;ResolvedScope&lt;/code&gt; that are neither required nor in &lt;code dir=&quot;auto&quot;&gt;known_irrelevant&lt;/code&gt; — a half-2 violation.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Recommended DRG edge changes&lt;/td&gt;&lt;td&gt;Structured &lt;code dir=&quot;auto&quot;&gt;add_edge&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;remove_edge&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;rewire_edge&lt;/code&gt; proposals.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Before/after evidence&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ResolvedScope&lt;/code&gt; snapshot before the recommended fix; expected scope after the fix.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;overlay-files&quot;&gt;Overlay Files&lt;/h2&gt;
&lt;p&gt;Project-local DRG mutations go to:&lt;/p&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;plaintext&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:#d6deeb;--1:#403f53&quot;&gt;.kittify/charter-packs/overlays/calibration-&amp;#x3C;mission&gt;.yaml&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Supported keys: &lt;code dir=&quot;auto&quot;&gt;add_edge&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;remove_edge&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;nodes&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;The runtime DRG resolver reads these overlays via
&lt;code dir=&quot;auto&quot;&gt;specify_cli.calibration.walker._build_graph()&lt;/code&gt; which calls
&lt;code dir=&quot;auto&quot;&gt;charter.offering.drg.loader.merge_layers()&lt;/code&gt; followed by
&lt;code dir=&quot;auto&quot;&gt;_apply_remove_edges()&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;reports&quot;&gt;Reports&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/calibration/software-dev/&quot;&gt;software-dev.md&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/calibration/research/&quot;&gt;research.md&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/calibration/documentation/&quot;&gt;documentation.md&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/calibration/erp-custom/&quot;&gt;erp-custom.md&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
