<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/operations/recovery-index/">
  <id>https://docs.spec-kitty.ai/operations/recovery-index/</id>
  <title>Recovery guides</title>
  <updated>2026-10-04T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/operations/recovery-index/"/>
  <summary>Recovery procedures for Spec Kitty operational states, such as a coord/lane split-brain or a refusal after an upgrade mid-Mission.</summary>
  <content type="html">&lt;span id=&quot;recovery-guides&quot;&gt;&lt;/span&gt;
&lt;p&gt;Task-oriented recovery procedures for getting an installation or session back to a healthy
state after a failure or interruption.&lt;/p&gt;
&lt;h2 id=&quot;in-this-section&quot;&gt;In this section&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/operations/upgrade-with-live-lanes-recovery/&quot;&gt;Refusal after an upgrade mid-Mission&lt;/a&gt; — recover when &lt;code dir=&quot;auto&quot;&gt;consolidate&lt;/code&gt;, review or implement refuses on &lt;code dir=&quot;auto&quot;&gt;.kittify/metadata.yaml&lt;/code&gt; after &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; ran while a Mission had live lanes.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;coordlane-split-brain-recovery&quot;&gt;Coord/lane split-brain recovery&lt;/h3&gt;
&lt;p&gt;Six recovery entries for the coordination-branch / lane-worktree split-brain states a
coord-topology mission can land in. Each leads with the shipped &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor … --fix&lt;/code&gt; where one genuinely exists; the rest are manual, operator-approved procedures,
citing the &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/docs/archive/plans/engineering-notes/coord-splitbrain-rootcause.md&quot;&gt;coord-branch bookkeeping root-cause
analysis&lt;/a&gt; for the underlying
“why.”&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/operations/coord-off-main-addadd/&quot;&gt;Coordination branch created off main (add/add)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/operations/start-branch-coord-divergence/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;--start-branch&lt;/code&gt; coordination divergence&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/operations/stale-lane-seed/&quot;&gt;Stale lane seed after re-finalizing tasks&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/operations/coord-worktree-missing/&quot;&gt;Coordination branch declared but worktree missing&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/operations/cutover-flip-linked-worktree/&quot;&gt;Cutover flip fails from a linked worktree&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/operations/coord-branch-base-strand/&quot;&gt;Coordination branch stranded after a base rebase&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/&quot;&gt;How-to guides&lt;/a&gt; — including crash and interrupted-merge recovery.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/recovery/&quot;&gt;Recovery &amp;#x26; Troubleshooting&lt;/a&gt; — the agent-facing
sibling home: implementation-crash and interrupted-merge how-tos. This page covers
operational coord/lane recovery (operator-grant, &lt;code dir=&quot;auto&quot;&gt;doctor --fix&lt;/code&gt;); that page covers
agent-facing crash/merge recovery. Cross-linked, not merged, because the two serve
different audiences and different failure classes.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/&quot;&gt;Documentation home&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
