---
type: "Operations"
title: "Recovery guides"
description: "Recovery procedures for Spec Kitty operational states, such as a coord/lane split-brain or a refusal after an upgrade mid-Mission."
status: "stable"
generated:
  by: "process:dockitty-export"
  at: "2026-10-04T00:00:00Z"
---

# Recovery guides

Task-oriented recovery procedures for getting an installation or session back to a healthy
state after a failure or interruption.

## In this section

- [Refusal after an upgrade mid-Mission](/operations/upgrade-with-live-lanes-recovery.md) — recover when `consolidate`, review or implement refuses on `.kittify/metadata.yaml` after `spec-kitty upgrade` ran while a Mission had live lanes.

### Coord/lane split-brain recovery

Six recovery entries for the coordination-branch / lane-worktree split-brain states a
coord-topology mission can land in. Each leads with the shipped `spec-kitty doctor …
--fix` where one genuinely exists; the rest are manual, operator-approved procedures,
citing the [coord-branch bookkeeping root-cause
analysis](https://github.com/spec-kitty/spec-kitty/blob/main/docs/archive/plans/engineering-notes/coord-splitbrain-rootcause.md) for the underlying
"why."

- [Coordination branch created off main (add/add)](/operations/coord-off-main-addadd.md)
- [`--start-branch` coordination divergence](/operations/start-branch-coord-divergence.md)
- [Stale lane seed after re-finalizing tasks](/operations/stale-lane-seed.md)
- [Coordination branch declared but worktree missing](/operations/coord-worktree-missing.md)
- [Cutover flip fails from a linked worktree](/operations/cutover-flip-linked-worktree.md)
- [Coordination branch stranded after a base rebase](/operations/coord-branch-base-strand.md)

## See also

- [How-to guides](/guides/index.md) — including crash and interrupted-merge recovery.
- [Recovery & Troubleshooting](/guides/how-to/recovery/index.md) — the agent-facing
  sibling home: implementation-crash and interrupted-merge how-tos. This page covers
  operational coord/lane recovery (operator-grant, `doctor --fix`); that page covers
  agent-facing crash/merge recovery. Cross-linked, not merged, because the two serve
  different audiences and different failure classes.
- [Documentation home](/index.md)

## Related

- [Spec Kitty 3.2 Documentation](/index.md)
- [Recovery & Troubleshooting](/guides/how-to/recovery/index.md)
- [Recovery: consolidate, review or implement refuses after an upgrade mid-Mission](/operations/upgrade-with-live-lanes-recovery.md)
