<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/how-to/missions/accept-and-merge/">
  <id>https://docs.spec-kitty.ai/guides/how-to/missions/accept-and-merge/</id>
  <title>How to Accept and Consolidate a Mission</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/guides/how-to/missions/accept-and-merge/"/>
  <summary>How to accept and consolidate a mission with Spec Kitty 3.2: Use this guide to validate mission readiness and consolidate into the mission&apos;s target branch.</summary>
  <content type="html">&lt;span id=&quot;how-to-accept-and-consolidate-a-mission&quot;&gt;&lt;/span&gt;
&lt;p&gt;Use this guide to validate mission readiness and consolidate into the mission’s target branch.&lt;/p&gt;
&lt;h2 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;All WPs are &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, with review feedback resolved&lt;/li&gt;
&lt;li&gt;You are in a checkout where the mission can be resolved (repository root checkout or execution workspace)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;accept-the-mission&quot;&gt;Accept the Mission&lt;/h2&gt;
&lt;p&gt;Run acceptance after the implement-review loop approves every WP and before
consolidation. This is a readiness nudge for humans and LLMs; consolidation still performs its
own gates and remains the mission-close operation.&lt;/p&gt;
&lt;p&gt;In your agent:&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;/spec-kitty.accept&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Or in your terminal:&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;accept&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;what-accept-checks&quot;&gt;What Accept Checks&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;All WPs are &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Required metadata and activity logs are present&lt;/li&gt;
&lt;li&gt;No unresolved &lt;code dir=&quot;auto&quot;&gt;[NEEDS CLARIFICATION]&lt;/code&gt; markers remain&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;To run a read-only checklist (in your terminal):&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;accept&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;--mode&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;checklist&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;what-accept-tells-you-next&quot;&gt;What Accept Tells You Next&lt;/h3&gt;
&lt;p&gt;The next steps &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; prints follow the Mission’s topology, because the way a
Mission lands is not the same everywhere:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Lane and single-branch Missions&lt;/strong&gt; end with &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --mission &amp;#x3C;handle&gt;&lt;/code&gt;. The one exception is a pull-request-mode &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; run on the
integration branch itself, where there is no separate Mission branch to
consolidate: it says to push and open a pull request if needed. A
&lt;code dir=&quot;auto&quot;&gt;--mode local&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; on the integration branch says no merge is needed.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Coordination-topology Missions&lt;/strong&gt; are landed by &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt;. Their
coordination branch is internal, so &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; names that command and does not
suggest pushing the branch and opening a pull request.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;A coordination-topology Mission’s &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; therefore never asks for a pull
request. When a Mission’s issue matrix is refused at &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, the message names
the validation diagnostics; the &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent issue-verdict&lt;/code&gt; remedy appears
only when a verdict is actually missing, still &lt;code dir=&quot;auto&quot;&gt;in-mission&lt;/code&gt;, or an &lt;code dir=&quot;auto&quot;&gt;unknown&lt;/code&gt;
placeholder.&lt;/p&gt;
&lt;h3 id=&quot;when-a-mission-defines-no-contracts&quot;&gt;When a Mission Defines No Contracts&lt;/h3&gt;
&lt;p&gt;The software-dev Mission type requires a &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; directory, and strict
&lt;code dir=&quot;auto&quot;&gt;spec-kitty accept&lt;/code&gt; blocks without it. A Mission that defines no interfaces, such as a
test remediation or a refactor, can say so in its &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; instead of creating an
empty directory or running &lt;code dir=&quot;auto&quot;&gt;accept --lenient&lt;/code&gt;:&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;json&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;{&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:#096E72&quot;&gt;&quot;contracts&quot;&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:#C789D6;--1:#7C5686&quot;&gt;none&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;/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:#096E72&quot;&gt;&quot;contracts_rationale&quot;&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:#C789D6;--1:#7C5686&quot;&gt;Test-drift remediation; this Mission defines no interfaces.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&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:#D6DEEB;--1:#403F53&quot;&gt;}&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;Exact value.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;contracts&lt;/code&gt; must be the string &lt;code dir=&quot;auto&quot;&gt;&quot;none&quot;&lt;/code&gt;. Any other value, including
&lt;code dir=&quot;auto&quot;&gt;null&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;false&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;&quot;None&quot;&lt;/code&gt;, is not a waiver.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Rationale required.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;contracts_rationale&lt;/code&gt; must be a non-empty string.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Malformed declarations keep the requirement.&lt;/strong&gt; Accept still blocks and prints a
warning that says what is wrong with the declaration.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Only &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; is waived.&lt;/strong&gt; Other path conventions, such as &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;docs/&lt;/code&gt;, stay in force.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Accept shows the waiver.&lt;/strong&gt; A valid waiver prints its rationale in the accept warnings,
so reviewers can see why the requirement was skipped.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Nothing writes these fields for you yet: add them by hand to the Mission’s &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;, or let
the plan step do it. For the reasoning, see the
&lt;a href=&quot;/adr/4.x/2026-10-04-1-mission-contracts-waiver-in-meta-json/&quot;&gt;ADR&lt;/a&gt;.&lt;/p&gt;
&lt;h3 id=&quot;when-the-project-layout-differs&quot;&gt;When the Project Layout Differs&lt;/h3&gt;
&lt;p&gt;The other path conventions, such as &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;docs/&lt;/code&gt;, stay in force for the
Mission type. A project whose real layout differs has honest project-level levers. The strict
failure text leads with the per-type remap for the failing Mission type, then names both
waivers and &lt;code dir=&quot;auto&quot;&gt;accept --lenient&lt;/code&gt;, then the last-resort copy; &lt;code dir=&quot;auto&quot;&gt;mkdir -p&lt;/code&gt; is offered only for real
deliverables such as &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt;, never for these directories: an empty &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt; would pass the
check without making it true (#7512). The levers in full:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Remap for one Mission type&lt;/strong&gt; (#7748). Key a section by the Mission type in
&lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt;. Only Missions of that type see the remap; the other types keep their
own conventions. A content repository with &lt;code dir=&quot;auto&quot;&gt;packs/&lt;/code&gt; and no &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt; can write:&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;project&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;path_conventions&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;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 class=&quot;indent&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;workspace&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;packs/&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;# where this repository&apos;s work actually lives&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;tests&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;packs/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Documentation, plan and research Missions still check &lt;code dir=&quot;auto&quot;&gt;docs/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;docs/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;research/&lt;/code&gt;.
The section id must be a Mission type the project knows (built-in, org or project), and
every value must be a repository-relative directory; anything else stops &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; with a
configuration error.&lt;/p&gt;
&lt;p&gt;That error stops &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; for every Mission in the project, not only the type the section
names. If a section names a Mission type that no longer exists (for example a type removed
from an org pack), delete or rename that section in &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt;; the error names
the unknown id and lists the known types. If the error says the mission-type roster could
not be read, run &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor charter-packs&lt;/code&gt; to find the broken pack, fix or
re-sync it, or remove the per-type sections until it is fixed (plain values need no roster).&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Remap for every Mission type.&lt;/strong&gt; A plain string value applies to every type that
declares the key:&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;project&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;path_conventions&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;workspace&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;internal/&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;# where the source actually lives&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;tests&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;internal/&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;# where the tests actually live&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Per key, a type’s section wins over the plain value, which wins over the Mission type’s
default. YAML holds a key once, so &lt;code dir=&quot;auto&quot;&gt;documentation:&lt;/code&gt; is either a plain value or the
documentation type’s section, not both: to give documentation Missions their own paths
next to a plain &lt;code dir=&quot;auto&quot;&gt;documentation:&lt;/code&gt; value for the other types, set &lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt; inside each
type’s section instead.&lt;/p&gt;
&lt;p&gt;Both forms are remap-only: they move a required directory, never add or drop one, and
&lt;code dir=&quot;auto&quot;&gt;deliverables&lt;/code&gt; (artifact-routed) is not in their vocabulary. See the
&lt;a href=&quot;/adr/3.x/2026-08-28-1-project-path-convention-override-precedes-doctrine/&quot;&gt;ADR&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Waive only the path check&lt;/strong&gt; (#7566). When a layout mismatch is genuine and you do not
want to remap it, waive the layout-path check while every other accept check stays strict.
A missing Mission artifact such as &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; is not waived; declare &lt;code dir=&quot;auto&quot;&gt;&quot;contracts&quot;: &quot;none&quot;&lt;/code&gt;
for that instead:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;for one run: &lt;code dir=&quot;auto&quot;&gt;spec-kitty accept --waive-path-conventions --waive-reason &quot;&amp;#x3C;why&gt;&quot;&lt;/code&gt;. The
reason is required and is recorded on the acceptance history entry in &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;.
&lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt; has no per-run flag.&lt;/li&gt;
&lt;li&gt;for every run of one Mission: add &lt;code dir=&quot;auto&quot;&gt;&quot;path_conventions&quot;: &quot;waived&quot;&lt;/code&gt; and a non-empty
&lt;code dir=&quot;auto&quot;&gt;&quot;path_conventions_rationale&quot;&lt;/code&gt; to the Mission’s &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;. Every accept path honors
it, &lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt; included, and accept prints the rationale. A malformed
declaration waives nothing and says what is wrong with it.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Last resort: drop a key.&lt;/strong&gt; Copying the packaged &lt;code dir=&quot;auto&quot;&gt;mission.yaml&lt;/code&gt; to
&lt;code dir=&quot;auto&quot;&gt;.kittify/overrides/missions/&amp;#x3C;mission-type&gt;/mission.yaml&lt;/code&gt; and deleting the key’s line drops
it, but the copy freezes that Mission type’s definition at the CLI version you copied it
from, so later changes to the packaged Mission type no longer reach you.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Prefer all of these over &lt;code dir=&quot;auto&quot;&gt;accept --lenient&lt;/code&gt;: lenient mode also skips the per-work-package
&lt;code dir=&quot;auto&quot;&gt;agent&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;assignee&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt; metadata checks, so it gives up more than the path
check.&lt;/p&gt;
&lt;h3 id=&quot;negative-invariants-that-assert-the-consolidated-post-state&quot;&gt;Negative Invariants That Assert the Consolidated Post-State&lt;/h3&gt;
&lt;p&gt;The accept gate &lt;strong&gt;re-runs each acceptance negative-invariant &lt;code dir=&quot;auto&quot;&gt;verification_command&lt;/code&gt;
live&lt;/strong&gt; against the working tree at accept time — it does not trust a stored
&lt;code dir=&quot;auto&quot;&gt;result&lt;/code&gt; or a hand-set &lt;code dir=&quot;auto&quot;&gt;overall_verdict&lt;/code&gt;. Two consequences follow:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Hand-editing a verdict does not stick.&lt;/strong&gt; Setting &lt;code dir=&quot;auto&quot;&gt;overall_verdict&lt;/code&gt; (or a
negative invariant’s &lt;code dir=&quot;auto&quot;&gt;result&lt;/code&gt;) by hand in &lt;code dir=&quot;auto&quot;&gt;acceptance-matrix.json&lt;/code&gt; is
overwritten the moment accept runs; the invariant’s &lt;code dir=&quot;auto&quot;&gt;verification_command&lt;/code&gt; is
the single source of truth, and it must actually pass in the checkout accept
runs from.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Consolidated-post-state invariants must be verified after consolidation.&lt;/strong&gt; If an invariant
asserts a state that only exists &lt;strong&gt;once the mission is consolidated&lt;/strong&gt; — for example,
“&lt;code dir=&quot;auto&quot;&gt;shell: bash&lt;/code&gt; is present in &lt;code dir=&quot;auto&quot;&gt;ci-quality.yml&lt;/code&gt;” when that line is added by the
consolidation — it cannot pass while the mission still lives on its lane branch. For
such missions, run &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt; (into &lt;strong&gt;local&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;) &lt;strong&gt;before&lt;/strong&gt;
&lt;code dir=&quot;auto&quot;&gt;spec-kitty accept&lt;/code&gt;, so the working tree accept inspects already carries the
consolidated post-state:&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;consolidate&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;# land into LOCAL main first&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;accept&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;# now the post-state invariants can verify live&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;This inverts the usual accept-then-consolidate order and is only needed for missions
whose negative invariants assert the post-consolidation result. Missions whose
invariants describe the lane’s own diff verify fine in the normal order.&lt;/p&gt;
&lt;p&gt;If you prefer not to re-order, scope the invariant to a path that exists on the
lane branch (see &lt;code dir=&quot;auto&quot;&gt;NegativeInvariant.scope&lt;/code&gt;) or express it as a &lt;code dir=&quot;auto&quot;&gt;custom_command&lt;/code&gt;
that is meaningful pre-consolidation.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;deferred-criteria&quot;&gt;Deferred Criteria&lt;/h3&gt;
&lt;p&gt;When the Mission agrees to postpone one acceptance criterion, record it as
&lt;code dir=&quot;auto&quot;&gt;deferred&lt;/code&gt; instead of leaving it &lt;code dir=&quot;auto&quot;&gt;pending&lt;/code&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;agent&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;acceptance-verdict&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;--mission&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;slug&gt;&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;--criterion&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;FR-004&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&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:#82AAFF;--1:#3B61B0&quot;&gt;--result&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;deferred&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;--reason&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;needs the read service&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:#82AAFF;--1:#3B61B0&quot;&gt;--follow-up&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;#7400&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;&lt;code dir=&quot;auto&quot;&gt;--reason&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;--follow-up&lt;/code&gt; (an issue number, URL or ruling id) are both
required; a deferral without them is refused. A justified deferral does not
block &lt;code dir=&quot;auto&quot;&gt;overall_verdict&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;pass&lt;/code&gt; plus &lt;code dir=&quot;auto&quot;&gt;deferred&lt;/code&gt; reads &lt;code dir=&quot;auto&quot;&gt;pass&lt;/code&gt;), but it is never
silent: &lt;code dir=&quot;auto&quot;&gt;spec-kitty accept&lt;/code&gt; lists each one under “Deferred criteria” in the
console and as a &lt;code dir=&quot;auto&quot;&gt;criteria_deferred&lt;/code&gt; entry in &lt;code dir=&quot;auto&quot;&gt;skipped_checks&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt;.
&lt;code dir=&quot;auto&quot;&gt;--description&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;--notes&lt;/code&gt; replace a criterion’s scaffolded text in the same
command.&lt;/p&gt;
&lt;h3 id=&quot;deferred-invariants-and-the-post-consolidation-gate&quot;&gt;Deferred Invariants and the Post-Consolidation Gate&lt;/h3&gt;
&lt;p&gt;A scoped &lt;code dir=&quot;auto&quot;&gt;grep_absence&lt;/code&gt; invariant whose subject does not exist yet — because it
is added only by consolidating the mission’s lane branches — cannot be honestly
judged at &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; time. Rather than report a false “still present” or a false
“pass”, accept records that invariant’s result as &lt;code dir=&quot;auto&quot;&gt;deferred_to_consolidation&lt;/code&gt;
and the mission’s &lt;code dir=&quot;auto&quot;&gt;overall_verdict&lt;/code&gt; as &lt;code dir=&quot;auto&quot;&gt;pass_pending_consolidation&lt;/code&gt;: acceptance
is &lt;strong&gt;not blocked&lt;/strong&gt;, but the mission cannot reach &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; while the deferral is
outstanding.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;What this means for you as the operator:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;The mission loop does not verify a deferred invariant.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;spec-kitty accept&lt;/code&gt;
is the acceptance matrix’s only pre-consolidation reader, and it is the gate
that &lt;em&gt;creates&lt;/em&gt; the deferral — it cannot also be the thing that resolves it.
When &lt;code dir=&quot;auto&quot;&gt;spec-kitty accept&lt;/code&gt; assigns &lt;code dir=&quot;auto&quot;&gt;deferred_to_consolidation&lt;/code&gt; it discloses this
immediately, in the same run, as a &lt;code dir=&quot;auto&quot;&gt;negative_invariants_deferred&lt;/code&gt; entry under
“Skipped checks” — look for it in the console output or the JSON summary.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;What verifies it instead&lt;/strong&gt; is the &lt;strong&gt;post-consolidation verification op&lt;/strong&gt; —
dispatched after &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt; (lane consolidation) completes, against
the consolidated mission tree. It re-judges every &lt;code dir=&quot;auto&quot;&gt;deferred_to_consolidation&lt;/code&gt;
invariant on that tree and records a terminal result
(&lt;code dir=&quot;auto&quot;&gt;confirmed_absent&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;still_present&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;verification_error&lt;/code&gt;) stamped with the
&lt;code dir=&quot;auto&quot;&gt;CONSOLIDATED&lt;/code&gt; surface. A violation fails &lt;strong&gt;that verification op&lt;/strong&gt;, not the
already-completed consolidation — see
&lt;a href=&quot;/context/orchestration/#topology-surface&quot;&gt;post-consolidation / &lt;code dir=&quot;auto&quot;&gt;CONSOLIDATED&lt;/code&gt;&lt;/a&gt;
in the terminology glossary for how this surface relates to &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt;’s three overloaded “merge” senses.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;What your repository needs&lt;/strong&gt;: a CI check on the pull request that fails when
any &lt;code dir=&quot;auto&quot;&gt;kitty-specs/*/acceptance-matrix.json&lt;/code&gt; still carries an unresolved
&lt;code dir=&quot;auto&quot;&gt;deferred_to_consolidation&lt;/code&gt; invariant. This project’s own gate is
&lt;code dir=&quot;auto&quot;&gt;scripts/ci/check_dangling_deferrals.py&lt;/code&gt;, wired into &lt;code dir=&quot;auto&quot;&gt;ci-quality.yml&lt;/code&gt;’s
&lt;code dir=&quot;auto&quot;&gt;deferral-consistency-check&lt;/code&gt; job. &lt;strong&gt;A repository without an equivalent check
never verifies the deferral&lt;/strong&gt; — the disclosure above exists precisely so that
gap is visible rather than silently assumed away (ADR
&lt;a href=&quot;/adr/3.x/2026-07-23-2-post-consolidation-deferral-and-external-enforcement/&quot;&gt;2026-07-23-2&lt;/a&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;consolidate-into-the-target-branch&quot;&gt;Consolidate into the target branch&lt;/h2&gt;
&lt;p&gt;In your agent:&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;/spec-kitty.merge --push&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Or in your terminal:&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;consolidate&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;--push&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;By default, &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt; lands in the mission’s recorded target branch. Use &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --target &amp;#x3C;branch&gt;&lt;/code&gt; only when you intentionally need to override that destination.&lt;/p&gt;
&lt;p&gt;For detailed consolidation options including dry-run, strategies, and cleanup flags, see &lt;a href=&quot;/guides/how-to/missions/merge-mission/&quot;&gt;Merge a Mission&lt;/a&gt;.&lt;/p&gt;
&lt;h3 id=&quot;when-local-main-is-not-publishable&quot;&gt;When Local &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; Is Not Publishable&lt;/h3&gt;
&lt;p&gt;Autonomous local runs can leave &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; ahead of or diverged from &lt;code dir=&quot;auto&quot;&gt;origin/main&lt;/code&gt;
with planning, status, review, and orchestration commits. If consolidation refuses with
&lt;code dir=&quot;auto&quot;&gt;TARGET_BRANCH_NOT_SYNCHRONIZED&lt;/code&gt;, do not reset, rebase, force-push, or push
local &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; only to satisfy the pre-flight.&lt;/p&gt;
&lt;p&gt;Open a focused PR from the mission result instead:&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;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;push&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;-u&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;origin&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;kitty/mission-&amp;#x3C;mission-slug&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;gh&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;pr&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;create&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;--base&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;main&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;--head&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;kitty/mission-&amp;#x3C;mission-slug&gt;&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;--fill&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Or create a dedicated PR branch from the mission 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:#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;switch&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;-c&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;kitty/pr/&amp;#x3C;mission-slug&gt;-to-main&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;kitty/mission-&amp;#x3C;mission-slug&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;push&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;-u&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;origin&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;kitty/pr/&amp;#x3C;mission-slug&gt;-to-main&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;gh&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;pr&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;create&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;--base&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;main&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;--head&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;kitty/pr/&amp;#x3C;mission-slug&gt;-to-main&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;--fill&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Prefer squash-merge when the autonomous run accumulated many orchestration
commits. For the full end-to-end path, see
&lt;a href=&quot;/guides/how-to/collaboration/run-an-autonomous-mission/&quot;&gt;Run an Autonomous Mission&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;after-consolidation&quot;&gt;After Consolidation&lt;/h2&gt;
&lt;p&gt;Complete the following three steps before declaring the mission done.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. Mission review&lt;/strong&gt; — run the post-consolidation mission review to confirm spec→code fidelity and FR
coverage:&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:#919F9F;--1:#5F636F&quot;&gt;# In your agent:&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-mission-review&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;/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;# Or directly:&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;agent&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&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;review&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;--mission&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;handle&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;2. Author or verify the retrospective&lt;/strong&gt; — under default policy the record was already written
during consolidation. Verify with:&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;cat&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/missions/&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;jq&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;-r&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_id&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;kitty-specs/&amp;#x3C;slug&gt;/meta.json&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;/retrospective.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;If the file is absent (for example, an older mission predating 3.2.0), author it now:&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;retrospect&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;create&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;--mission&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;handle&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;Reserve the noun “capture” for the event-log fact &lt;code dir=&quot;auto&quot;&gt;RetrospectiveCaptured&lt;/code&gt;, not for the
operator verb.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. Surface findings&lt;/strong&gt; — aggregate across recent missions or inspect proposals for this one:&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:#919F9F;--1:#5F636F&quot;&gt;# Cross-mission view (read-only aggregation)&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;retrospect&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;summary&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;/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;# Preview proposals in this mission&apos;s retrospective.yaml (dry-run by 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:#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;agent&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;retrospect&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;synthesize&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;--mission&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;handle&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;/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;# Apply a proposal (requires explicit --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;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;agent&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;retrospect&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;synthesize&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;--mission&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;handle&gt;&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;--apply&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;proposal-id&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;For full details on each command, see
&lt;a href=&quot;/guides/how-to/governance/use-retrospective-learning/&quot;&gt;How to Use Retrospective Learning&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;consolidation-strategies&quot;&gt;Consolidation Strategies&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default (merge commit)&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Squash&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --strategy squash&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Note: Rebase is not supported for multi-workspace missions. Use &lt;code dir=&quot;auto&quot;&gt;merge&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;squash&lt;/code&gt; instead.&lt;/p&gt;
&lt;h2 id=&quot;cleanup&quot;&gt;Cleanup&lt;/h2&gt;
&lt;p&gt;By default, consolidation removes resolved execution worktrees and deletes the mission branch. Use these flags to keep them (in your terminal):&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;consolidate&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;--keep-worktree&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;--keep-branch&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;abandon-a-mission-manual-cleanup&quot;&gt;Abandon a Mission (Manual Cleanup)&lt;/h2&gt;
&lt;p&gt;If you decide to drop a mission without consolidating, remove its execution worktrees and branches manually.
These steps are safe and reversible until you delete the branch and commit the cleanup.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;List worktrees to find all workspaces for the mission:&lt;/li&gt;
&lt;/ol&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;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;worktree&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;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ol start=&quot;2&quot;&gt;
&lt;li&gt;Remove each execution worktree for the mission:&lt;/li&gt;
&lt;/ol&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;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;worktree&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;remove&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-a&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;worktree&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;remove&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-b&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;If a worktree has uncommitted changes you want to discard, use &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&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;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;worktree&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;remove&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:#ECC48D;--1:#3B61B0&quot;&gt;.worktrees/&amp;#x3C;mission-slug&gt;-lane-a&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ol start=&quot;3&quot;&gt;
&lt;li&gt;Delete the mission branches:&lt;/li&gt;
&lt;/ol&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;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;branch&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;-D&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;mission-slug&gt;-lane-a&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;branch&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;-D&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;mission-slug&gt;-lane-b&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ol start=&quot;4&quot;&gt;
&lt;li&gt;Remove the planning artifacts from the repository root checkout (spec/plan/tasks), then commit:&lt;/li&gt;
&lt;/ol&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;rm&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;-rf&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;kitty-specs/&amp;#x3C;mission-slug&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;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;kitty-specs/&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;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;Remove abandoned mission &amp;#x3C;mission-slug&gt;&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;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Accept reports blockers&lt;/strong&gt;: Resolve the listed issues, then rerun &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.accept&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consolidation fails&lt;/strong&gt;: Ensure your current checkout is clean and the mission resolves correctly.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consolidation reports &lt;code dir=&quot;auto&quot;&gt;TARGET_BRANCH_NOT_SYNCHRONIZED&lt;/code&gt;&lt;/strong&gt;: Use the focused-PR path when local &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; contains autonomous-run history that should not be published directly.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consolidation is heading to the wrong branch&lt;/strong&gt;: Inspect the mission’s recorded target branch before retrying, and use &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --target &amp;#x3C;branch&gt;&lt;/code&gt; only if you intend to override it.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For detailed troubleshooting including pre-flight failures, conflict resolution, and consolidation recovery, see &lt;a href=&quot;/guides/how-to/recovery/troubleshoot-merge/&quot;&gt;Troubleshoot Merge Issues&lt;/a&gt;.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;command-reference&quot;&gt;Command Reference&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/api/slash-commands/&quot;&gt;Slash Commands&lt;/a&gt; - All &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.*&lt;/code&gt; commands&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/cli-commands/&quot;&gt;CLI Commands&lt;/a&gt; - Full CLI reference&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/how-to/missions/merge-mission/&quot;&gt;Merge a Mission&lt;/a&gt; - Detailed merge workflow&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/collaboration/run-an-autonomous-mission/&quot;&gt;Run an Autonomous Mission&lt;/a&gt; - End-to-end autonomous run and focused-PR fallback&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/keep-main-clean/&quot;&gt;Keep Main Clean&lt;/a&gt; - Choose a target branch without changing planning location&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/recovery/troubleshoot-merge/&quot;&gt;Troubleshoot Merge Issues&lt;/a&gt; - Recovery and conflict resolution&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/review-work-package/&quot;&gt;Review a work package&lt;/a&gt; - Required before accept&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/install-and-upgrade/&quot;&gt;Upgrade to 0.11.0&lt;/a&gt; - Breaking changes in v0.11.0&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;background&quot;&gt;Background&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Lanes&lt;/a&gt; - Worktree cleanup&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/git-worktrees/&quot;&gt;Git Worktrees&lt;/a&gt; - How worktrees work&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt; - Complete workflow walkthrough&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
