<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/tutorials/claude-code-workflow/">
  <id>https://docs.spec-kitty.ai/guides/tutorials/claude-code-workflow/</id>
  <title>Claude Code Workflow</title>
  <updated>2026-10-10T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/tutorials/claude-code-workflow/"/>
  <summary>End-to-end guide for running Spec Kitty with the Claude Code CLI and lane-based status tracking.</summary>
  <content type="html">&lt;span id=&quot;claude-code-workflow&quot;&gt;&lt;/span&gt;
&lt;p&gt;Anthropic’s &lt;strong&gt;Claude Code&lt;/strong&gt; pairs naturally with Spec Kitty’s guardrails. This guide explains how to integrate the Claude CLI, wire the prompts, and keep &lt;strong&gt;Claude automation&lt;/strong&gt; in lockstep with Spec Kitty’s lane-based status.&lt;/p&gt;
&lt;h2 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Claude Code CLI installed (&lt;code dir=&quot;auto&quot;&gt;claude --version&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Spec Kitty project initialized with the &lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt; agent selected.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt; directory generated by &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Claude Code workflow - Mission Kitty splash&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Stylized splash — the phase flowchart is decorative. CLI setup, prompt launch, and merge steps are in the sections below.&lt;/em&gt;&lt;/p&gt;
&lt;aside aria-label=&quot;Tip&quot; class=&quot;starlight-aside starlight-aside--tip&quot;&gt;&lt;p class=&quot;starlight-aside__title&quot; aria-hidden=&quot;true&quot;&gt;&lt;svg viewBox=&quot;0 0 24 24&quot; width=&quot;16&quot; height=&quot;16&quot; fill=&quot;currentColor&quot; class=&quot;starlight-aside__icon&quot;&gt;&lt;path fill-rule=&quot;evenodd&quot; d=&quot;M1.44 8.855v-.001l3.527-3.516c.34-.344.802-.541 1.285-.548h6.649l.947-.947c3.07-3.07 6.207-3.072 7.62-2.868a1.821 1.821 0 0 1 1.557 1.557c.204 1.413.203 4.55-2.868 7.62l-.946.946v6.649a1.845 1.845 0 0 1-.549 1.286l-3.516 3.528a1.844 1.844 0 0 1-3.11-.944l-.858-4.275-4.52-4.52-2.31-.463-1.964-.394A1.847 1.847 0 0 1 .98 10.693a1.843 1.843 0 0 1 .46-1.838Zm5.379 2.017-3.873-.776L6.32 6.733h4.638l-4.14 4.14Zm8.403-5.655c2.459-2.46 4.856-2.463 5.89-2.33.134 1.035.13 3.432-2.329 5.891l-6.71 6.71-3.561-3.56 6.71-6.711Zm-1.318 15.837-.776-3.873 4.14-4.14v4.639l-3.364 3.374Z&quot; clip-rule=&quot;evenodd&quot;&gt;&lt;/path&gt;&lt;path d=&quot;M9.318 18.345a.972.972 0 0 0-1.86-.561c-.482 1.435-1.687 2.204-2.934 2.619a8.22 8.22 0 0 1-1.23.302c.062-.365.157-.79.303-1.229.415-1.247 1.184-2.452 2.62-2.935a.971.971 0 1 0-.62-1.842c-.12.04-.236.084-.35.13-2.02.828-3.012 2.588-3.493 4.033a10.383 10.383 0 0 0-.51 2.845l-.001.016v.063c0 .536.434.972.97.972H2.24a7.21 7.21 0 0 0 .878-.065c.527-.063 1.248-.19 2.02-.447 1.445-.48 3.205-1.472 4.033-3.494a5.828 5.828 0 0 0 .147-.407Z&quot;&gt;&lt;/path&gt;&lt;/svg&gt;Tip&lt;/p&gt;&lt;div class=&quot;starlight-aside__content&quot;&gt;&lt;p&gt;For the opinionated slash-command tutorial (&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt; through implement), see &lt;a href=&quot;/guides/tutorials/claude-code-integration/&quot;&gt;Claude Code + Spec Kitty Integration&lt;/a&gt;.&lt;/p&gt;&lt;/div&gt;&lt;/aside&gt;
&lt;h2 id=&quot;workflow-overview&quot;&gt;Workflow Overview&lt;/h2&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Phase&lt;/th&gt;&lt;th&gt;Claude Code Usage&lt;/th&gt;&lt;th&gt;Spec Kitty Command&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Discovery&lt;/td&gt;&lt;td&gt;Prompt Claude to interview stakeholders&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Research&lt;/td&gt;&lt;td&gt;Summarize evidence and data model findings&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.research&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Planning&lt;/td&gt;&lt;td&gt;Generate architecture briefs via Claude&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.plan&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Tasks&lt;/td&gt;&lt;td&gt;Produce work packages and prompts that Claude can execute&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Analysis&lt;/td&gt;&lt;td&gt;Ask Claude to sanity-check cross-artifact consistency before coding&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.analyze&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Implementation&lt;/td&gt;&lt;td&gt;Run Claude on specific prompt files&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.implement&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Review &amp;#x26; Merge&lt;/td&gt;&lt;td&gt;Review, accept readiness, then land the branch&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.accept&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.merge&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;setup-checklist&quot;&gt;Setup Checklist&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Select Claude during project creation:&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;init&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-project&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;--ai&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;claude&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 copies Claude-specific commands into &lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt; and registers &lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt; as an active agent in &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;running-claude-against-prompts&quot;&gt;Running Claude Against Prompts&lt;/h2&gt;
&lt;p&gt;Prompt files live under &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;mission-slug&gt;/tasks/WPxx-slug.md&lt;/code&gt; (flat directory, no lane subdirectories). Lane state is tracked in the append-only &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt; event log, not in file frontmatter — see &lt;a href=&quot;/architecture/status-model/&quot;&gt;Status Model&lt;/a&gt;. Each file contains:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Mission-aligned context.&lt;/li&gt;
&lt;li&gt;Checklist of subtasks.&lt;/li&gt;
&lt;li&gt;Activity log for audit.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Launch Claude against a prompt:&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/001-systematic-recognizer-enhancement-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;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;action&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;implement&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;WP02&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;--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;claude&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;That prints the WP02 prompt and moves it to &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;. Now start Claude Code in that workspace and, in the interactive chat, run the matching slash command:&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.implement&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 a non-interactive or scripted run, &lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt; accepts a prompt directly via &lt;code dir=&quot;auto&quot;&gt;-p&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;--print&lt;/code&gt; (confirmed in &lt;code dir=&quot;auto&quot;&gt;claude --help&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;claude&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;-p&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;$(&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;cat&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;kitty-specs/001-systematic-recognizer-enhancement/tasks/WP02-synthetic-benchmark.md&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&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;p&gt;Claude will use the template metadata to understand scope, file boundaries, and Definition of Done.&lt;/p&gt;
&lt;h2 id=&quot;status-integration&quot;&gt;Status Integration&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Lane transitions triggered by action commands (&lt;code dir=&quot;auto&quot;&gt;spec-kitty agent action implement/review&lt;/code&gt;) surface immediately in &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt;. The full lane model is: &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; (alias: &lt;code dir=&quot;auto&quot;&gt;doing&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;canceled&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; means review passed and merge pending, while &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; means merged/integrated.&lt;/li&gt;
&lt;li&gt;Each lane move records &lt;code dir=&quot;auto&quot;&gt;agent&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt; as event metadata in &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;—Claude can add a summary note with &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks add-history WP02 --note &quot;...&quot;&lt;/code&gt;, which is also recorded in the event log.&lt;/li&gt;
&lt;li&gt;When Claude finishes a work package, use the workflow command to move it to &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt; so the status log and reviewers stay in sync:
&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;action&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:#ECC48D;--1:#3B61B0&quot;&gt;WP02&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;recommended-automation&quot;&gt;Recommended Automation&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Claude session bootstrapper:&lt;/strong&gt; Script that reads &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; for the friendly mission name and injects it into Claude’s context.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Claude completion validator:&lt;/strong&gt; Automatically checks that Claude’s output modifies only the allowed files referenced in the prompt.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Claude status notifier:&lt;/strong&gt; Sends Claude’s status updates to a team Slack channel whenever a work package changes lanes.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Checklist watcher:&lt;/strong&gt; Parse &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;mission-slug&gt;/checklists/&lt;/code&gt; and block Claude from moving prompts to &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; when acceptance criteria are unchecked.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;troubleshooting-claude-sessions&quot;&gt;Troubleshooting Claude Sessions&lt;/h2&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Problem&lt;/th&gt;&lt;th&gt;Cause&lt;/th&gt;&lt;th&gt;Fix&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Claude asks for missing context&lt;/td&gt;&lt;td&gt;Prompt not in &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; lane yet&lt;/td&gt;&lt;td&gt;Move prompt to &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; (or &lt;code dir=&quot;auto&quot;&gt;doing&lt;/code&gt; alias) via action commands so metadata is injected&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Claude edits unexpected files&lt;/td&gt;&lt;td&gt;Prompt instructions unclear&lt;/td&gt;&lt;td&gt;Refine &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt; and regenerate prompt&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Status shows stale lane&lt;/td&gt;&lt;td&gt;Prompt moved manually&lt;/td&gt;&lt;td&gt;Always use &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent action&lt;/code&gt; commands for lane transitions&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Claude session interrupted&lt;/td&gt;&lt;td&gt;CLI lost connection&lt;/td&gt;&lt;td&gt;Resume by re-running Claude against the same prompt file; &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt; tracks prior progress&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;merge-and-cleanup&quot;&gt;Merge and Cleanup&lt;/h2&gt;
&lt;p&gt;Once Claude (and any partner agents) finish the mission:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Ensure 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; and all review feedback is resolved.&lt;/li&gt;
&lt;li&gt;Run the guided merge:&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 class=&quot;indent&quot;&gt; &lt;/span&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;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;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;merge&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;--remove-worktree&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Run it from any checkout where the mission can be resolved; the CLI automatically performs the Git steps from the main checkout so execution workspaces stay in sync.
The command documents merge steps, updates activity logs, and optionally removes the execution worktrees to keep the repository tidy.
3. Run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty-mission-review&lt;/code&gt;, then review the retrospective captured at
the runtime terminus: &lt;code dir=&quot;auto&quot;&gt;spec-kitty retrospect summary&lt;/code&gt; (cross-mission view)
and &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent retrospect synthesize --mission &amp;#x3C;slug&gt;&lt;/code&gt; (dry-run by
default; add &lt;code dir=&quot;auto&quot;&gt;--apply&lt;/code&gt; to mutate).&lt;/p&gt;
&lt;h2 id=&quot;beyond-claude&quot;&gt;Beyond Claude&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Mix Claude with Cursor or Gemini by generating commands for multiple agents during &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Keep the multi-agent playbook handy: &lt;a href=&quot;/guides/tutorials/multi-agent-workflow/&quot;&gt;Multi-Agent Parallel Development&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Check progress at any time with &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt; (see &lt;a href=&quot;/guides/how-to/monitoring/&quot;&gt;Status &amp;#x26; History&lt;/a&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;related-how-to-guides&quot;&gt;Related How-To Guides&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/install-spec-kitty/&quot;&gt;Install Spec Kitty&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/non-interactive-init/&quot;&gt;Non-Interactive Init&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;reference&quot;&gt;Reference&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/api/cli-commands/&quot;&gt;CLI Commands&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/slash-commands/&quot;&gt;Slash Commands&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/agent-subcommands/&quot;&gt;Agent Subcommands&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;learn-more&quot;&gt;Learn More&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; — the full specify-to-merge lifecycle narrative&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/missions-overview/&quot;&gt;Understanding Spec Kitty Missions&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/doctrine-kinds/&quot;&gt;Doctrine documentation&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
