<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/migrations/charter-pack-cutover/">
  <id>https://docs.spec-kitty.ai/migrations/charter-pack-cutover/</id>
  <title>Migration: Charter Pack Cutover</title>
  <updated>2026-10-21T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/migrations/charter-pack-cutover/"/>
  <summary>Runbook for the charter pack cutover (#3732): run spec-kitty upgrade once, handle LEGACY_CHARTER_STATE and lanes in flight, update packs, and rewrite saved scripts.</summary>
  <content type="html">&lt;span id=&quot;migration-charter-pack-cutover&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Issue&lt;/strong&gt;: &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/3732&quot;&gt;#3732&lt;/a&gt;
&lt;strong&gt;Ships in&lt;/strong&gt;: spec-kitty-cli 4.0.0rc6
&lt;strong&gt;Audience&lt;/strong&gt;: operators who run &lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; in a project, authors of org Charter Packs, and anyone with saved scripts or CI jobs that call &lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;what-changed&quot;&gt;What changed&lt;/h2&gt;
&lt;p&gt;Spec Kitty now uses one name for each idea (&lt;a href=&quot;/adr/4.x/2026-10-06-2-charter-offering-active-charter-and-activation-presets/&quot;&gt;ADR 2026-10-06-1&lt;/a&gt;).
A &lt;strong&gt;Charter Pack&lt;/strong&gt; is a bundle of charter components that a project can draw from; the packs plus the project’s own layer form the &lt;strong&gt;charter offering&lt;/strong&gt;.
An &lt;strong&gt;activation preset&lt;/strong&gt; is a named set of activations that a pack ships, applied with &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate --preset &amp;#x3C;name&gt;&lt;/code&gt;.
The &lt;strong&gt;active charter&lt;/strong&gt; is what your project has activated (&lt;code dir=&quot;auto&quot;&gt;activated_&amp;#x3C;kind&gt;&lt;/code&gt; keys, &lt;code dir=&quot;auto&quot;&gt;activated_kinds&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_type_activations&lt;/code&gt;).
The older “doctrine” names are removed, not deprecated: the &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine&lt;/code&gt; command group, the &lt;code dir=&quot;auto&quot;&gt;doctrine.*&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;organisation_packs&lt;/code&gt; config keys, the &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt; directory, the &lt;code dir=&quot;auto&quot;&gt;spk-doctrine-*&lt;/code&gt; skills and their older &lt;code dir=&quot;auto&quot;&gt;spec-kitty-*&lt;/code&gt; twins.
There are no aliases. An old command fails as an unknown command (exit 2), and an old project layout stops every command until you run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; once.
The glossary entries are in &lt;a href=&quot;/context/charter/&quot;&gt;docs/context/charter.md&lt;/a&gt;; the full list of renamed names is in &lt;a href=&quot;#saved-scripts&quot;&gt;Saved scripts&lt;/a&gt; below.&lt;/p&gt;
&lt;h2 id=&quot;operators&quot;&gt;Operators&lt;/h2&gt;
&lt;h3 id=&quot;upgrade-a-project&quot;&gt;Upgrade a project&lt;/h3&gt;
&lt;p&gt;Run these from the repository root checkout, on the branch you integrate into:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--dry-run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;     &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# preview: every line starts with &quot;Would ...&quot;&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;               &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# apply&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:#82AAFF;--1:#3B61B0&quot;&gt;git&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;status&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                       &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# review the moves and rewrites&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:#82AAFF;--1:#3B61B0&quot;&gt;git&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;add&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-A&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &amp;#x26;&amp;#x26; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&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;commit&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-m&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;chore: spec-kitty charter pack cutover&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The cutover migration runs before every other pending migration, so the later migrations read the new layout.
It is a plain filesystem move plus key rewrites: uncommitted edits under &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt; are carried over to &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt; as they are.
Commit the result so teammates and lanes receive it.
A second &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; changes nothing.
If a teammate pulls an older branch that brings the old layout back, &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; selects the cutover again and migrates it again.&lt;/p&gt;
&lt;h3 id=&quot;read-the-upgrade-summary&quot;&gt;Read the upgrade summary&lt;/h3&gt;
&lt;p&gt;The summary groups every line of the cutover. &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade --json&lt;/code&gt; carries the same lists under &lt;code dir=&quot;auto&quot;&gt;migration_reports.charter_pack_cutover&lt;/code&gt;.&lt;/p&gt;



























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Report key&lt;/th&gt;&lt;th&gt;Summary prefix&lt;/th&gt;&lt;th&gt;What it means&lt;/th&gt;&lt;th&gt;What you do&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;moved&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Moved&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A file moved from &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;.&lt;/td&gt;&lt;td&gt;Commit it.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;rewritten&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Rewrote&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A config key or path reference was renamed (file and key named).&lt;/td&gt;&lt;td&gt;Commit it.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;reset&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Reset&lt;/code&gt;&lt;/td&gt;&lt;td&gt;An activation key was removed because it was a stale copy of an old default list, the old 8-kind gate, the old &lt;code dir=&quot;auto&quot;&gt;minimal&lt;/code&gt; kind gate, or an &lt;code dir=&quot;auto&quot;&gt;[]&lt;/code&gt; written by an earlier upgrade. The kind is now unrestricted (or limited to what your org packs require).&lt;/td&gt;&lt;td&gt;Check the restore hint (below) if you meant to keep it.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;kept_for_review&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Kept for review&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A customized list, or an entry the migration could not convert, was left as it is.&lt;/td&gt;&lt;td&gt;Read the line and edit the file by hand if needed.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;matches_minimal&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Matches preset minimal, kept&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A list equals the released &lt;code dir=&quot;auto&quot;&gt;minimal&lt;/code&gt; preset; it stays.&lt;/td&gt;&lt;td&gt;Nothing, or apply a preset (see &lt;a href=&quot;#choosing-a-starting-point&quot;&gt;Choosing a starting point&lt;/a&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;skills_removed&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Removed skill&lt;/code&gt;&lt;/td&gt;&lt;td&gt;An installed copy of a removed skill was deleted.&lt;/td&gt;&lt;td&gt;Nothing; the new skill is installed.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;skills_kept&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;Kept edited skill copy&lt;/code&gt;&lt;/td&gt;&lt;td&gt;You edited an installed copy of a removed skill. It is kept, dropped from &lt;code dir=&quot;auto&quot;&gt;.kittify/skills-manifest.json&lt;/code&gt; and is now yours: later upgrades leave it alone.&lt;/td&gt;&lt;td&gt;Delete it when you no longer need it.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;errors&lt;/code&gt;&lt;/td&gt;&lt;td&gt;error lines&lt;/td&gt;&lt;td&gt;The run refused (a path collision or a locked file). Nothing in the refused step was written.&lt;/td&gt;&lt;td&gt;Fix the named path and run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; again.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;keys-that-were-reset&quot;&gt;Keys that were reset&lt;/h3&gt;
&lt;p&gt;Reset lines are there because older releases wrote lists that silently hid every newer built-in artifact. After the reset the key is absent, which means “all built-ins of this kind are in force” (or, where an org pack requires artifacts, only those).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A deliberate &lt;code dir=&quot;auto&quot;&gt;[]&lt;/code&gt; was reset.&lt;/strong&gt; A per-kind &lt;code dir=&quot;auto&quot;&gt;activated_&amp;#x3C;kind&gt;: []&lt;/code&gt; cannot be told apart from the empty lists an earlier upgrade wrote, so the cutover removes it and prints a hint naming the file and the key, for example: &lt;code dir=&quot;auto&quot;&gt;To switch the kind off again, set activated_tactics: [] in .kittify/config.yaml.&lt;/code&gt; Put the &lt;code dir=&quot;auto&quot;&gt;[]&lt;/code&gt; back if you meant it. The reset runs only on the first application, so a later &lt;code dir=&quot;auto&quot;&gt;[]&lt;/code&gt; you write stays.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The &lt;code dir=&quot;auto&quot;&gt;minimal&lt;/code&gt; kind gate is gone.&lt;/strong&gt; Projects that applied the old &lt;code dir=&quot;auto&quot;&gt;minimal&lt;/code&gt; preset carried &lt;code dir=&quot;auto&quot;&gt;activated_kinds: [directives, tactics]&lt;/code&gt;, which switched every other kind off. The new &lt;code dir=&quot;auto&quot;&gt;minimal&lt;/code&gt; preset has no kind gate, so the cutover removes it and says so. To gate kinds again, set &lt;code dir=&quot;auto&quot;&gt;activated_kinds&lt;/code&gt; yourself.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A list that matches an old default list&lt;/strong&gt; was reset; a list you customized was kept and reported for review.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;refusals-during-the-upgrade&quot;&gt;Refusals during the upgrade&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Collision.&lt;/strong&gt; When &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt; both hold the same path with different content, the upgrade refuses and lists every colliding path. Nothing is written. Keep the copy you want under &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;, delete the other, and run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; again.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Locked file (Windows).&lt;/strong&gt; A file held open by an editor or another process stops the move and is named. Close it and run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; again; the run finishes the remaining moves.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;the-activation-ledger-move-400rc8&quot;&gt;The activation ledger move (4.0.0rc8)&lt;/h3&gt;
&lt;p&gt;From 4.0.0rc8 the activation keys (&lt;code dir=&quot;auto&quot;&gt;activated_&amp;#x3C;kind&gt;&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;activated_kinds&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_type_activations&lt;/code&gt;) live in one file, the activation ledger &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/activation.yaml&lt;/code&gt;, beside the &lt;code dir=&quot;auto&quot;&gt;deactivated_&amp;#x3C;kind&gt;&lt;/code&gt; exclusions that &lt;code dir=&quot;auto&quot;&gt;charter deactivate&lt;/code&gt; records (&lt;a href=&quot;/adr/4.x/2026-10-19-1-activation-ledger-persists-deactivation/&quot;&gt;ADR 2026-10-19-1&lt;/a&gt;).
&lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; moves them in its &lt;code dir=&quot;auto&quot;&gt;4.0.0rc8_activation_ledger&lt;/code&gt; step; &lt;code dir=&quot;auto&quot;&gt;spec-kitty migrate activation-ledger&lt;/code&gt; runs only that step:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;migrate&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;activation-ledger&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--dry-run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# lists each move: key, from-file -&gt; to-file&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;migrate&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;activation-ledger&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;             &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# moves them and re-stamps the synthesis manifest&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:#82AAFF;--1:#3B61B0&quot;&gt;git&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;add&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;.kittify/charter/&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;.kittify/config.yaml&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &amp;#x26;&amp;#x26; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&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;commit&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-m&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;chore: move activation keys to the activation ledger&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Until you move them&lt;/strong&gt;, every command still reads the old keys as before, &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor charter-packs&lt;/code&gt; warns &lt;code dir=&quot;auto&quot;&gt;ACTIVATION_UNMIGRATED&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;charter deactivate&lt;/code&gt; refuses (exit 1, nothing written), naming &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Two copies disagree.&lt;/strong&gt; When the &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; your &lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt; pointer names and a leftover copy in &lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt; hold different values for a key, or only the copy holds it, the move names the key and both files, exits 1 and writes nothing. Keep the value you want in the pointed &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;, delete the copy from &lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt;, and run the command again.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A hand-written &lt;code dir=&quot;auto&quot;&gt;deactivated_&amp;#x3C;kind&gt;&lt;/code&gt; key&lt;/strong&gt; in &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt; was never applied; the move refuses it the same way (&lt;code dir=&quot;auto&quot;&gt;LEGACY_DENY_KEY&lt;/code&gt; in doctor). Delete the key, run the move, then record the exclusion with &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter deactivate &amp;#x3C;kind&gt; &amp;#x3C;id&gt;&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Interrupted run.&lt;/strong&gt; The move writes the activation ledger first, then strips &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;, then &lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt;. Run the same command again: it strips the keys that equal the activation ledger and finishes. A second run reports nothing to do.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The Migration Ledger record.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;migrate activation-ledger&lt;/code&gt; records the step as applied only when &lt;code dir=&quot;auto&quot;&gt;.kittify/migration-ledger.jsonl&lt;/code&gt; already exists (&lt;code dir=&quot;auto&quot;&gt;ledger_record: written&lt;/code&gt;); otherwise it records nothing (&lt;code dir=&quot;auto&quot;&gt;not_recorded&lt;/code&gt;), and a later &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; selects the step, finds nothing to move and skips it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Do not downgrade.&lt;/strong&gt; An older CLI does not read the activation ledger: it treats every kind as unrestricted and ignores every deactivation. Activation keys it, or a branch from before the move, writes back into &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt; are ignored with a warning and reported as &lt;code dir=&quot;auto&quot;&gt;LEGACY_KEYS_PRESENT&lt;/code&gt;; after merging such a branch, run &lt;code dir=&quot;auto&quot;&gt;spec-kitty migrate activation-ledger&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;legacy_charter_state-the-project-is-not-migrated-yet&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;LEGACY_CHARTER_STATE&lt;/code&gt;: the project is not migrated yet&lt;/h3&gt;
&lt;p&gt;Every command refuses a project (or the checkout you are in) that still has the old layout, with exit 1:&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;text&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;Error (LEGACY_CHARTER_STATE): This project uses the retired doctrine layout (&amp;#x3C;first finding&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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Run `spec-kitty upgrade` to migrate it.&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:#d6deeb;--1:#403f53&quot;&gt;See docs/migrations/charter-pack-cutover.md.&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;In a lane worktree the message adds: upgrade the repository root and merge the target into this lane (do not rebase).&lt;/p&gt;
&lt;p&gt;With &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt;, the refusal is one JSON object on stdout instead, with the same exit code 1: &lt;code dir=&quot;auto&quot;&gt;{&quot;ok&quot;: false, &quot;error&quot;: {&quot;code&quot;: &quot;LEGACY_CHARTER_STATE&quot;, &quot;message&quot;: &quot;...&quot;}}&lt;/code&gt;. The message is the text above without the &lt;code dir=&quot;auto&quot;&gt;Error (LEGACY_CHARTER_STATE):&lt;/code&gt; prefix.&lt;/p&gt;
&lt;p&gt;These still run on an unmigrated project, so you can always reach the fix: &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--version&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--help&lt;/code&gt;, the git merge drivers (&lt;code dir=&quot;auto&quot;&gt;spec-kitty merge-driver-*&lt;/code&gt;) and the hook entry points (&lt;code dir=&quot;auto&quot;&gt;spec-kitty live-work hook&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;session-start&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;session-stop&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;commit-guard-hook&lt;/code&gt;).
The findings are: the &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt; directory, a &lt;code dir=&quot;auto&quot;&gt;governance.yaml&lt;/code&gt; with the old selection key, or one of the old keys in &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;doctrine.org&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;organisation_packs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;governance.doctrine&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tracker.doctrine&lt;/code&gt;).&lt;/p&gt;
&lt;h3 id=&quot;config-that-the-upgrade-does-not-rewrite&quot;&gt;Config that the upgrade does not rewrite&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;charter_packs.org.local_path&lt;/code&gt; (single-pack form).&lt;/strong&gt; Only the named list form is read. Move the fields into one entry of &lt;code dir=&quot;auto&quot;&gt;charter_packs.org.packs[]&lt;/code&gt; with a &lt;code dir=&quot;auto&quot;&gt;name&lt;/code&gt; (not &lt;code dir=&quot;auto&quot;&gt;default&lt;/code&gt;, which is the preset name):&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;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;charter_packs&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;org&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;packs&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;name&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;acme&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;local_path&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;../acme-charter-pack&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The old &lt;code dir=&quot;auto&quot;&gt;doctrine.org&lt;/code&gt; single-pack form is rewritten for you: the entry is named after the &lt;code dir=&quot;auto&quot;&gt;local_path&lt;/code&gt; directory (or &lt;code dir=&quot;auto&quot;&gt;org&lt;/code&gt;).&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;organisation_packs&lt;/code&gt; entries that are not local paths&lt;/strong&gt; are kept and reported for review. Declare them under &lt;code dir=&quot;auto&quot;&gt;charter_packs.org.packs[]&lt;/code&gt; with their source fields.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Org packs outside the project that use the nested layout&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;pack&gt;/doctrine/&amp;#x3C;kind&gt;/&amp;#x3C;layer&gt;/&lt;/code&gt; are no longer read; nor is a repository-root &lt;code dir=&quot;auto&quot;&gt;doctrine/&lt;/code&gt; directory used as the project layer. The upgrade cannot convert files it does not own. &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor charter-packs&lt;/code&gt; names each one; the pack maintainer moves the artifacts to the flat layout &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;pack&gt;/&amp;#x3C;kind&gt;/&lt;/code&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Agent prompts that still say &lt;code dir=&quot;auto&quot;&gt;/ad-hoc-profile-load&lt;/code&gt;.&lt;/strong&gt; Projects that took the 3.2.0rc35 profile hand-off migration have that text in &lt;code dir=&quot;auto&quot;&gt;.kittify/missions/software-dev/command-templates/implement.md&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;review.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.kittify/overrides/missions/software-dev/templates/task-prompt-template.md&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;.agents/skills/spec-kitty-implement/SKILL.md&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;spec-kitty-review/SKILL.md&lt;/code&gt;. The migration does not run twice, so replace the old skill name yourself: &lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;grep&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-rln&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;ad-hoc-profile-load&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&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;.kittify&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;.agents&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:#919F9F;--1:#5F636F&quot;&gt;# in each file: /ad-hoc-profile-load -&gt; /spk-charter-profile-load&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;missions-in-flight&quot;&gt;Missions in flight&lt;/h2&gt;
&lt;p&gt;The upgrade skips lane and coordination worktrees. A lane created before the upgrade still carries the old layout, so commands run inside it refuse with &lt;code dir=&quot;auto&quot;&gt;LEGACY_CHARTER_STATE&lt;/code&gt;. Pick one of these:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Upgrade, then merge into each lane.&lt;/strong&gt; Upgrade and commit in the repository root checkout (above). Then, in each lane worktree, &lt;strong&gt;merge&lt;/strong&gt; the upgraded target branch:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#C5E478;--1:#3B61B0&quot;&gt;cd&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;.worktrees/&amp;#x3C;mission-slug&gt;-lane-&amp;#x3C;id&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 style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&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;merge&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;&amp;#x3C;target-branch&gt;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Do not rebase the lane.&lt;/strong&gt; A rebase rewrites the lane commits, so the lane no longer contains the commit recorded when its work package was approved, and &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt; refuses with &lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_NOT_ON_LANE&lt;/code&gt;. A merge keeps the approved commits.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Finish first.&lt;/strong&gt; Consolidate the Mission with the release you started it on, then upgrade.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;choosing-a-starting-point&quot;&gt;Choosing a starting point&lt;/h2&gt;
&lt;p&gt;A preset replaces the activation keys it governs. It refuses to overwrite a key you customized unless you pass &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt;, and prints the per-key difference.&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;pack&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;list&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                         &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# packs and the presets each ships&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;activate&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--preset&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;default&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;         &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# every built-in artifact, plus the built-in mission types&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;activate&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--preset&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;minimal&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;         &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# a small curated baseline&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;activate&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--preset&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;minimal&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--force&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# overwrite customized keys&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;activate&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--pack&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;acme&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--preset&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;team-default&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# a preset of an org pack&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;pack&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;path&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;built-in&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--preset&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;minimal&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;          &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# print the preset file&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;A fresh &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; already behaves like the &lt;code dir=&quot;auto&quot;&gt;default&lt;/code&gt; preset. The applied preset name is not stored: the result is ordinary activation keys you can edit.&lt;/p&gt;
&lt;h2 id=&quot;pack-authors&quot;&gt;Pack authors&lt;/h2&gt;
&lt;p&gt;Update each org Charter Pack you maintain:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;pack.yaml&lt;/code&gt;&lt;/strong&gt;: delete &lt;code dir=&quot;auto&quot;&gt;accompanies_doctrine_pack&lt;/code&gt;. A pack that still has it is rejected with &lt;code dir=&quot;auto&quot;&gt;RETIRED_PACK_FIELD&lt;/code&gt;; presets now ship inside the pack.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;org-charter.yaml&lt;/code&gt;&lt;/strong&gt;: in every &lt;code dir=&quot;auto&quot;&gt;activations&lt;/code&gt; entry, rename &lt;code dir=&quot;auto&quot;&gt;doctrine_pack_id&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;charter_pack_id&lt;/code&gt; (the old field is rejected with &lt;code dir=&quot;auto&quot;&gt;RETIRED_PACK_FIELD&lt;/code&gt;, whatever the schema version), and set &lt;code dir=&quot;auto&quot;&gt;schema_version: 2&lt;/code&gt;. Version 1 files still load; &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter org init&lt;/code&gt; writes version 2.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Presets&lt;/strong&gt; (optional): add &lt;code dir=&quot;auto&quot;&gt;presets/&amp;#x3C;name&gt;.yaml&lt;/code&gt;. The file name is the preset name (lowercase letters, digits and hyphens).&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;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;name&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;team-default&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;description&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;The Acme baseline.&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;mission_type_activations&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;software-dev&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;activated_directives&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;ACME-001&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 style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# activated_&amp;#x3C;kind&gt; for directives, tactics, styleguides, toolguides, paradigms,&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:#919F9F;--1:#5F636F&quot;&gt;# procedures, agent_profiles, mission_step_contracts, anti_patterns.&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:#919F9F;--1:#5F636F&quot;&gt;# Absent key: unrestricted. []: none of that kind.&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:#919F9F;--1:#5F636F&quot;&gt;# activated_kinds: optional kind gate; it must include every kind you list ids for.&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;No context-scoped entries. Every id must resolve in the built-in pack, the org pack chain or the project layer. &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter org init&lt;/code&gt; scaffolds &lt;code dir=&quot;auto&quot;&gt;presets/starter.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Validate and regenerate&lt;/strong&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;pack&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;validate&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;./my-pack&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# also validates presets/&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;org&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;validate&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;./my-pack&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;pack&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;regenerate-graph&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# built-in pack maintainers&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Flatten nested layouts&lt;/strong&gt;: move &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;pack&gt;/doctrine/&amp;#x3C;kind&gt;/&amp;#x3C;layer&gt;/&lt;/code&gt; artifacts to &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;pack&gt;/&amp;#x3C;kind&gt;/&lt;/code&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Replace retired command and skill names&lt;/strong&gt; in your procedures, READMEs and skills (see the tables below).&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;saved-scripts&quot;&gt;Saved scripts&lt;/h2&gt;
&lt;p&gt;Every old spelling exits 2 as an unknown command. Replace it with the new one.&lt;/p&gt;
&lt;h3 id=&quot;commands&quot;&gt;Commands&lt;/h3&gt;











































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&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;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack apply &amp;#x3C;name&gt; [--force]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate [--pack &amp;#x3C;pack&gt;] --preset &amp;#x3C;name&gt; [--force]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--pack&lt;/code&gt; defaults to &lt;code dir=&quot;auto&quot;&gt;built-in&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack list&lt;/code&gt; (preset rows)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack list [--json]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;One row per pack with its presets.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack path &amp;#x3C;preset&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack path &amp;#x3C;pack&gt; [--preset &amp;#x3C;preset&gt;]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack consistency-check&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter consistency-check&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt; key &lt;code dir=&quot;auto&quot;&gt;missing_from_doctrine&lt;/code&gt; is now &lt;code dir=&quot;auto&quot;&gt;missing_from_offering&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine pack validate &amp;#x3C;dir&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack validate &amp;#x3C;dir&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine pack assemble …&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack assemble …&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine regenerate-graph [--check]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack regenerate-graph [--check]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine asset list&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;asset path &amp;#x3C;id&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack asset list&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;asset path &amp;#x3C;id&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine fetch&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;new&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;validate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;org init&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;org validate&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter fetch&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;new&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;validate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;org init&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;org validate&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctrine mission-type list&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter mission-type list --include-inactive&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor doctrine [--json]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor charter-packs [--json]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;JSON keys unchanged.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty tracker bind --doctrine-mode &amp;#x3C;m&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty tracker bind --ownership-mode &amp;#x3C;m&gt;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The &lt;code dir=&quot;auto&quot;&gt;doctrine_mode&lt;/code&gt; JSON key is gone; read &lt;code dir=&quot;auto&quot;&gt;ownership_mode&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor tool-surfaces --kind doctrine-skill&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor tool-surfaces --kind charter-skill&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Kind value &lt;code dir=&quot;auto&quot;&gt;charter_skill&lt;/code&gt;; surface ids contain &lt;code dir=&quot;auto&quot;&gt;.charter_skill.&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack list --json&lt;/code&gt; now prints &lt;code dir=&quot;auto&quot;&gt;{&quot;packs&quot;: [{&quot;name&quot;, &quot;tier&quot;, &quot;root&quot;, &quot;presets&quot;: [{&quot;name&quot;, &quot;description&quot;, &quot;path&quot;}]}]}&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;skills&quot;&gt;Skills&lt;/h3&gt;





































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-charter&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-charter-doctrine&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-constitution-doctrine&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-charter-governance&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-glossary&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-glossary-context&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-charter-glossary&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-profile-load&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ad-hoc-profile-load&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-charter-profile-load&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-spdd-reasons&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-spdd-reasons&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-charter-spdd-reasons&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-bulk-edit&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-bulk-edit-classification&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-practice-bulk-edit&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-semantic-compression&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-practice-semantic-compression&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-doctrine-show-me&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spk-practice-show-me&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The upgrade removes the old copies from the project skill roots, and the global skill sync removes them from the user-global roots.&lt;/p&gt;
&lt;h3 id=&quot;config-keys-and-paths&quot;&gt;Config keys and paths&lt;/h3&gt;





































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;doctrine.org.packs[]&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;doctrine.org.{local_path,subdir,source_type,url,ref}&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;organisation_packs[]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter_packs.org.packs[]&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;governance.doctrine.*&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;); top-level &lt;code dir=&quot;auto&quot;&gt;doctrine:&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;governance.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;governance.charter.*&lt;/code&gt;; top-level &lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tracker.doctrine&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tracker.ownership&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;top-level &lt;code dir=&quot;auto&quot;&gt;doctrine:&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/interview/answers.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;doctrine_pack_id&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;activations&lt;/code&gt; entries&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter_pack_id&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/replaceable-builtins.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/replaceable-builtins.yaml&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;error-codes&quot;&gt;Error codes&lt;/h3&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&lt;/th&gt;&lt;th&gt;Raised when&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CHARTER_PACK_CONFIG_INVALID&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ACTIVE_CHARTER_CONFIG_INVALID&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The active charter config has an invalid shape (also a &lt;code dir=&quot;auto&quot;&gt;governance.doctrine&lt;/code&gt; key left in &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;LEGACY_CHARTER_STATE&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The project still has the old layout.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DefaultCharterPackMissingError&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DEFAULT_PRESET_MISSING&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The built-in &lt;code dir=&quot;auto&quot;&gt;default&lt;/code&gt; preset is missing during &lt;code dir=&quot;auto&quot;&gt;init&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; or upgrade provisioning.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;PACK_NOT_FOUND&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PRESET_NOT_FOUND&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter activate --preset&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;charter pack path&lt;/code&gt; names an unknown pack or preset.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;PRESET_ID_UNRESOLVED&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PRESET_INVALID&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A preset names an id that resolves nowhere, or the preset file is malformed.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;PRESET_WOULD_OVERWRITE&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A preset would change a customized key and &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt; was not given.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;RESYNTHESIS_FAILED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter activate --preset … --json&lt;/code&gt; wrote the preset but the follow-up recompile failed; run &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter synthesize&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;generic “extra field” error&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;RETIRED_PACK_FIELD&lt;/code&gt;&lt;/td&gt;&lt;td&gt;A pack file still has &lt;code dir=&quot;auto&quot;&gt;accompanies_doctrine_pack&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;doctrine_pack_id&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Text mode prints coded errors as &lt;code dir=&quot;auto&quot;&gt;Error (&amp;#x3C;CODE&gt;): &amp;#x3C;message&gt;&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt; mode prints a JSON error object and exits 1.&lt;/p&gt;
&lt;h3 id=&quot;python-callers&quot;&gt;Python callers&lt;/h3&gt;
&lt;p&gt;These Python names changed, with no re-export alias. Update imports if you use Spec Kitty as a library.&lt;/p&gt;

































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CharterPackManager&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ActiveCharterManager&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CharterPackConfigError&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ActiveCharterConfigError&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DefaultCharterPackMissingError&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DefaultPresetMissingError&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DoctrineService&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CharterOfferingService&lt;/code&gt; (offering) or &lt;code dir=&quot;auto&quot;&gt;ActiveCharterService&lt;/code&gt; (activation-aware)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DoctrineCatalog&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;load_doctrine_catalog&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;OfferingCatalog&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;load_offering_catalog&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DoctrineSelectionConfig&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;GovernanceCharterConfig&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;resolve_doctrine_root&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;resolve_offering_root&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;build_activation_aware_doctrine_service&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;build_active_charter_service&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;keyword &lt;code dir=&quot;auto&quot;&gt;doctrine_service=&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;compile_charter&lt;/code&gt; and related functions&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter_service=&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;BaseDoctrineRepository&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;BaseArtifactRepository&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;DoctrineLayerCollisionWarning&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;DoctrineArtifactLoadError&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;DoctrineResolutionCycleError&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ArtifactLayerCollisionWarning&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ArtifactLoadError&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ArtifactResolutionCycleError&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;OrgDoctrineSource&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;OrgCharterPackSource&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli.doctrine&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter.offering.packs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter.activation&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;specify_cli.charter_packs&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;doctrine_service_builder&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;action_doctrine_bundle&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kernel.doctrine_root&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;specify_cli.doctrine_synthesizer&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;active_charter_service_builder&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;action_governance_bundle&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kernel.charter_pack_paths&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;specify_cli.charter_pack_synthesizer&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Removed outright: the &lt;code dir=&quot;auto&quot;&gt;charter.activation.default_pack&lt;/code&gt; module, &lt;code dir=&quot;auto&quot;&gt;BUILTIN_PACKS&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;MissingDoctrinePackError&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;LegacyDoctrineRootWarning&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;LegacyTrackerOwnershipKeyWarning&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;apply_legacy_governance_selection_key_compat&lt;/code&gt;.&lt;/p&gt;</content>
</entry>
