<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/kanban-workflow/">
  <id>https://docs.spec-kitty.ai/architecture/kanban-workflow/</id>
  <title>Kanban Workflow Explained</title>
  <updated>2026-10-07T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/kanban-workflow/"/>
  <summary>How Spec Kitty tracks work-package progress: the nine lanes, the 27 allowed transitions and their guards, the append-only event log, and who moves work between them.</summary>
  <content type="html">&lt;span id=&quot;kanban-workflow-explained&quot;&gt;&lt;/span&gt;
&lt;p&gt;Spec Kitty uses a kanban-style workflow to track work package progress. This document explains how lanes work, why we track status this way, and what happens when work moves between lanes.&lt;/p&gt;
&lt;h2 id=&quot;the-nine-lanes&quot;&gt;The Nine Lanes&lt;/h2&gt;
&lt;p&gt;Work packages move through nine lanes during their lifecycle. Seven lanes form the main progression, and two lanes handle exceptional states:&lt;/p&gt;
&lt;h3 id=&quot;main-progression&quot;&gt;Main progression&lt;/h3&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;plaintext&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;planned -&gt; claimed -&gt; in_progress -&gt; for_review -&gt; in_review -&gt; approved -&gt; done&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;exceptional-states&quot;&gt;Exceptional states&lt;/h3&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;plaintext&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;blocked    (reachable from planned, claimed, in_progress, for_review, in_review, approved)&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;canceled   (reachable from planned, claimed, in_progress, for_review, in_review, approved, blocked)&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;lane-definitions&quot;&gt;Lane definitions&lt;/h3&gt;
&lt;h4 id=&quot;planned&quot;&gt;planned&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: work package is defined and ready to start.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt; creates WPs in &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; lane&lt;/li&gt;
&lt;li&gt;Returned from review with feedback (&lt;code dir=&quot;auto&quot;&gt;for_review -&gt; planned&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approved -&gt; planned&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Voluntarily un-claimed (&lt;code dir=&quot;auto&quot;&gt;in_progress -&gt; planned&lt;/code&gt;, with reason required)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP waits for an agent to claim it&lt;/li&gt;
&lt;li&gt;Dependencies are satisfied (or WP is independent)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;claimed&quot;&gt;claimed&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: An agent has claimed this work package but has not yet started a workspace.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agent claims WP with &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks move-task WP01 --to doing --assignee claude&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Guard: requires actor identity&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP is reserved for the claiming agent&lt;/li&gt;
&lt;li&gt;No workspace exists yet&lt;/li&gt;
&lt;li&gt;Next step: create a workspace and transition to &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;in_progress&quot;&gt;in_progress&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: An agent is actively implementing this work package in a workspace.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;From &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; when a workspace is created (&lt;code dir=&quot;auto&quot;&gt;claimed -&gt; in_progress&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Automatically when running &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent action implement WP01 --agent &amp;#x3C;name&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Returned from review/approval for rework (&lt;code dir=&quot;auto&quot;&gt;for_review -&gt; in_progress&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approved -&gt; in_progress&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Unblocked (&lt;code dir=&quot;auto&quot;&gt;blocked -&gt; in_progress&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Guard: &lt;code dir=&quot;auto&quot;&gt;claimed -&gt; in_progress&lt;/code&gt; requires workspace context&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agent works in the WP’s worktree&lt;/li&gt;
&lt;li&gt;Makes commits to the lane branch backing the current workspace&lt;/li&gt;
&lt;li&gt;Only ONE agent should have a WP in &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; at a time&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Alias&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;doing&lt;/code&gt; is accepted as input and resolved to &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; at input boundaries. The alias is never persisted in events or frontmatter.&lt;/p&gt;
&lt;h4 id=&quot;for_review&quot;&gt;for_review&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: Implementation is complete, waiting for review.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agent moves WP with &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks move-task WP01 --to for_review&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Guard: requires completed subtasks and implementation evidence (or &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP waits in the review queue&lt;/li&gt;
&lt;li&gt;A reviewer claims it by transitioning &lt;code dir=&quot;auto&quot;&gt;for_review -&gt; in_review&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Can also be blocked (&lt;code dir=&quot;auto&quot;&gt;-&gt; blocked&lt;/code&gt;) or canceled (&lt;code dir=&quot;auto&quot;&gt;-&gt; canceled&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;in_review&quot;&gt;in_review&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: A reviewer is actively examining this work package.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Reviewer claims WP from review queue: &lt;code dir=&quot;auto&quot;&gt;for_review -&gt; in_review&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Guard: requires actor identity (conflict detection prevents two reviewers claiming the same WP)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Reviewer examines the implementation against spec and acceptance criteria&lt;/li&gt;
&lt;li&gt;All outbound transitions require a &lt;code dir=&quot;auto&quot;&gt;ReviewResult&lt;/code&gt; in the transition context&lt;/li&gt;
&lt;li&gt;Either approves (&lt;code dir=&quot;auto&quot;&gt;-&gt; approved&lt;/code&gt;) or requests changes (&lt;code dir=&quot;auto&quot;&gt;-&gt; in_progress&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;-&gt; planned&lt;/code&gt; with feedback)&lt;/li&gt;
&lt;li&gt;Can also be blocked (&lt;code dir=&quot;auto&quot;&gt;-&gt; blocked&lt;/code&gt;) or canceled (&lt;code dir=&quot;auto&quot;&gt;-&gt; canceled&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;approved&quot;&gt;approved&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: work package has passed review and is merge-pending.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Reviewer approves: &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks move-task WP01 --to approved --approval-ref PR#42&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Can come from &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt; or directly from &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; (skipping explicit review)&lt;/li&gt;
&lt;li&gt;Guard: requires reviewer approval evidence (reviewer identity + approval reference)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP is approved and ready for acceptance and merge&lt;/li&gt;
&lt;li&gt;Can still be sent back for rework if issues arise (&lt;code dir=&quot;auto&quot;&gt;-&gt; in_progress&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;-&gt; planned&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;done&quot;&gt;done&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: work package has been merged/integrated into the mission target branch.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;From &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; after merge/integration, or via forced override with audit evidence&lt;/li&gt;
&lt;li&gt;Guard: requires merge/integration evidence or an explicit force reason&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Lane branch content has already landed&lt;/li&gt;
&lt;li&gt;No further changes expected&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; unblocks dependent WPs immediately&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; is recorded by merge bookkeeping after approved work lands&lt;/li&gt;
&lt;li&gt;Once 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;, run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.accept&lt;/code&gt; to validate
the entire mission before merge&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;blocked&quot;&gt;blocked&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: work package cannot proceed due to an external dependency or issue.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Any non-terminal lane can transition to &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt; (planned, claimed, in_progress, for_review, in_review, approved)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP is parked until the blocker is resolved&lt;/li&gt;
&lt;li&gt;Can transition to &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; when unblocked&lt;/li&gt;
&lt;li&gt;Can be canceled if the blocker is permanent&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;canceled&quot;&gt;canceled&lt;/h4&gt;
&lt;p&gt;&lt;strong&gt;Meaning&lt;/strong&gt;: work package has been abandoned and will not be completed.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;How it gets here&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Any non-done lane can transition to &lt;code dir=&quot;auto&quot;&gt;canceled&lt;/code&gt; (planned, claimed, in_progress, for_review, in_review, approved, blocked)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What happens&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;WP is removed from active work&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;canceled&lt;/code&gt; is a terminal lane (force required to leave)&lt;/li&gt;
&lt;li&gt;Does not count toward feature completion&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;allowed-transitions-27-pairs&quot;&gt;Allowed Transitions (27 pairs)&lt;/h2&gt;
&lt;p&gt;The state machine enforces exactly 27 legal transitions. Any transition not in this list is rejected unless &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt; is used (which requires actor + reason for audit).&lt;/p&gt;
&lt;h3 id=&quot;forward-progression-8&quot;&gt;Forward progression (8)&lt;/h3&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;From&lt;/th&gt;&lt;th&gt;To&lt;/th&gt;&lt;th&gt;Guard&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;claimed&lt;/td&gt;&lt;td&gt;Actor identity required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;claimed&lt;/td&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;Workspace context required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;for_review&lt;/td&gt;&lt;td&gt;Subtasks complete + evidence (or force)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;for_review&lt;/td&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;Actor identity required (conflict detection)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;ReviewResult required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;done&lt;/td&gt;&lt;td&gt;Legacy direct-completion path; prefer in_review -&gt; approved, then merge records done&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;Reviewer approval evidence&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;done&lt;/td&gt;&lt;td&gt;Merge/integration evidence&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;rework--rollback-5&quot;&gt;Rework / rollback (5)&lt;/h3&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;From&lt;/th&gt;&lt;th&gt;To&lt;/th&gt;&lt;th&gt;Guard&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;ReviewResult required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;ReviewResult required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;Review reference required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;Review reference required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;Reason required&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;blocking-7&quot;&gt;Blocking (7)&lt;/h3&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;From&lt;/th&gt;&lt;th&gt;To&lt;/th&gt;&lt;th&gt;Guard&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;claimed&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;for_review&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;ReviewResult required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;cancellation-7&quot;&gt;Cancellation (7)&lt;/h3&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;From&lt;/th&gt;&lt;th&gt;To&lt;/th&gt;&lt;th&gt;Guard&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;planned&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;claimed&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_progress&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;for_review&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;in_review&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;ReviewResult required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;approved&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;blocked&lt;/td&gt;&lt;td&gt;canceled&lt;/td&gt;&lt;td&gt;(none)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;force-overrides&quot;&gt;Force overrides&lt;/h3&gt;
&lt;p&gt;Any transition not in the 27 allowed pairs can still be performed with &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt;, which requires both &lt;code dir=&quot;auto&quot;&gt;actor&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;reason&lt;/code&gt;. Force also bypasses guard conditions on allowed transitions. This is designed for administrative recovery, not normal workflow.&lt;/p&gt;
&lt;h3 id=&quot;terminal-lanes&quot;&gt;Terminal lanes&lt;/h3&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;canceled&lt;/code&gt; are terminal. Transitioning out of a terminal lane requires &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt; with actor + reason.&lt;/p&gt;
&lt;h2 id=&quot;how-work-moves-between-lanes&quot;&gt;How Work Moves Between Lanes&lt;/h2&gt;
&lt;h3 id=&quot;normal-flow-planned---claimed---in_progress---for_review---in_review---approved---done&quot;&gt;Normal Flow: planned -&gt; claimed -&gt; in_progress -&gt; for_review -&gt; in_review -&gt; approved -&gt; done&lt;/h3&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;plaintext&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;1. WP created by /spec-kitty.tasks&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;lane: planned&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:#d6deeb;--1:#403f53&quot;&gt;2. Agent claims WP&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;spec-kitty agent tasks move-task WP01 --to doing --assignee claude&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;lane: claimed (resolved from &quot;doing&quot; alias at input, but actual transition is planned -&gt; claimed)&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:#d6deeb;--1:#403f53&quot;&gt;3. Agent creates workspace&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;spec-kitty agent action implement WP01 --agent &amp;#x3C;name&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;lane: in_progress&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:#d6deeb;--1:#403f53&quot;&gt;4. Agent completes implementation&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;spec-kitty agent tasks move-task WP01 --to for_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;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;lane: for_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:#d6deeb;--1:#403f53&quot;&gt;5. Reviewer claims WP for 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;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;spec-kitty agent tasks move-task WP01 --to in_review --assignee reviewer&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;lane: in_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:#d6deeb;--1:#403f53&quot;&gt;6. Reviewer approves&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;spec-kitty agent tasks move-task WP01 --to approved --approval-ref PR#42&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;lane: approved&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:#d6deeb;--1:#403f53&quot;&gt;7. Continue until every WP is approved or done&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;(Then /spec-kitty.accept validates the mission before merge)&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;review-feedback-in_review---planned-with-feedback&quot;&gt;Review Feedback: in_review -&gt; planned (with feedback)&lt;/h3&gt;
&lt;p&gt;When review finds issues:&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;plaintext&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;1. WP in for_review, reviewer claims 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 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;spec-kitty agent tasks move-task WP01 --to in_review --assignee reviewer&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;lane: in_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:#d6deeb;--1:#403f53&quot;&gt;2. Reviewer finds problems&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;/spec-kitty.review WP01&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;Writes feedback file and runs move-task with --review-feedback-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 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;Feedback persisted to git common-dir as feedback://&amp;#x3C;feature&gt;/&amp;#x3C;wp&gt;/&amp;#x3C;artifact&gt;.md&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;lane: planned (reset)&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;review_status: has_feedback&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;review_feedback: feedback://&amp;#x3C;feature&gt;/&amp;#x3C;wp&gt;/&amp;#x3C;artifact&gt;.md&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:#d6deeb;--1:#403f53&quot;&gt;3. Agent re-claims WP&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;Reads review_feedback pointer from frontmatter&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;Addresses issues&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;lane: claimed -&gt; in_progress -&gt; for_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:#d6deeb;--1:#403f53&quot;&gt;4. Reviewer re-reviews (claims again: for_review -&gt; in_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;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;If good: lane: in_review -&gt; approved&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;If issues remain: repeat&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;blocking-and-unblocking&quot;&gt;Blocking and Unblocking&lt;/h3&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;plaintext&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;1. WP hits an external blocker&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;spec-kitty agent tasks move-task WP01 --to blocked --note &quot;Waiting for API key&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 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;lane: blocked&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:#d6deeb;--1:#403f53&quot;&gt;2. Blocker resolved&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;spec-kitty agent tasks move-task WP01 --to in_progress&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;lane: in_progress (resumes work)&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;event-log-canonical-status-tracking&quot;&gt;Event Log (Canonical Status Tracking)&lt;/h2&gt;
&lt;p&gt;Lane transitions are tracked in an append-only event log stored at &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;feature&gt;/status.events.jsonl&lt;/code&gt;. Each line is a JSON object representing one &lt;code dir=&quot;auto&quot;&gt;StatusEvent&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;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;actor&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;claude&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;at&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;2026-02-08T12:00:00+00:00&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;event_id&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;01HXYZ...&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;evidence&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;execution_mode&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;worktree&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;feature_slug&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;034-feature&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;force&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;from_lane&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;planned&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;reason&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;review_ref&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;to_lane&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;claimed&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:#7FDBCA;--1:#096E72&quot;&gt;&quot;wp_id&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;WP01&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;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;statusevent-fields&quot;&gt;StatusEvent fields&lt;/h3&gt;






































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Type&lt;/th&gt;&lt;th&gt;Description&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;event_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;ULID (globally unique, time-sortable)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;feature_slug&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Feature identifier (e.g., “034-feature-name”)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;wp_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;work package ID (e.g., “WP01”)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from_lane&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Lane before transition (canonical name)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;to_lane&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Lane after transition (canonical name)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;at&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;ISO 8601 UTC timestamp&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;actor&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Who made the transition (agent name or “system”)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;force&lt;/code&gt;&lt;/td&gt;&lt;td&gt;boolean&lt;/td&gt;&lt;td&gt;Whether force override was used&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;execution_mode&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;“worktree” or “direct_repo”&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;reason&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string/null&lt;/td&gt;&lt;td&gt;Reason for forced or rollback transitions&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;review_ref&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string/null&lt;/td&gt;&lt;td&gt;Review feedback reference&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;evidence&lt;/code&gt;&lt;/td&gt;&lt;td&gt;object/null&lt;/td&gt;&lt;td&gt;DoneEvidence payload (for done transitions)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;why-an-event-log&quot;&gt;Why an event log?&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Immutability&lt;/strong&gt;: Events are append-only. No event is ever modified or deleted.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Deterministic replay&lt;/strong&gt;: The &lt;code dir=&quot;auto&quot;&gt;reduce()&lt;/code&gt; function replays all events to produce a &lt;code dir=&quot;auto&quot;&gt;StatusSnapshot&lt;/code&gt; (materialized as &lt;code dir=&quot;auto&quot;&gt;status.json&lt;/code&gt;). Same events always produce the same snapshot.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Debugging&lt;/strong&gt;: If something goes wrong, you can trace the full history of transitions.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Metrics&lt;/strong&gt;: Calculate time-in-lane, cycle time, throughput from the event stream.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Audit trail&lt;/strong&gt;: Know who did what, when, and why.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Coordination&lt;/strong&gt;: Multiple agents can see what others are doing.&lt;/p&gt;
&lt;h3 id=&quot;materialization&quot;&gt;Materialization&lt;/h3&gt;
&lt;p&gt;The current state of all WPs is derived from the event log by the deterministic reducer:&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;status&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;materialize&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 produces &lt;code dir=&quot;auto&quot;&gt;status.json&lt;/code&gt; (the &lt;code dir=&quot;auto&quot;&gt;StatusSnapshot&lt;/code&gt;), which contains the current lane, actor, and timestamp for every WP.&lt;/p&gt;
&lt;h2 id=&quot;lane-status-in-frontmatter&quot;&gt;Lane Status in Frontmatter&lt;/h2&gt;
&lt;p&gt;Lane status is also reflected in each work package’s YAML frontmatter for backward compatibility:&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:#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;work_package_id&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;WP01&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:#7FDBCA;--1:#111111&quot;&gt;title&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;Database Schema&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:#7FDBCA;--1:#111111&quot;&gt;lane&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;in_progress&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:#7FDBCA;--1:#111111&quot;&gt;assignee&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;claude&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:#7FDBCA;--1:#111111&quot;&gt;agent&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;claude&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:#7FDBCA;--1:#111111&quot;&gt;shell_pid&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;12345&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:#7FDBCA;--1:#111111&quot;&gt;review_status&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;&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:#7FDBCA;--1:#111111&quot;&gt;review_feedback&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;&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;h3 id=&quot;key-fields&quot;&gt;Key Fields&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Purpose&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;lane&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Current status (canonical lane name)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;assignee&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Who is working on this WP&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;agent&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Which AI agent claimed this&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Process ID of the agent (for tracking)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;review_status&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Empty or &lt;code dir=&quot;auto&quot;&gt;has_feedback&lt;/code&gt; if returned from review&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;review_feedback&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Pointer to persisted feedback artifact (&lt;code dir=&quot;auto&quot;&gt;feedback://...&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;not-directories-just-a-field&quot;&gt;Not Directories, Just a Field&lt;/h3&gt;
&lt;p&gt;In many kanban systems, you move cards between columns (directories). In Spec Kitty, the WP file stays in the same place — only the &lt;code dir=&quot;auto&quot;&gt;lane:&lt;/code&gt; field changes.&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;plaintext&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;kitty-specs/012-feature/tasks/&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;WP01-database.md      # lane: done&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;WP02-api.md           # lane: for_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;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;WP03-frontend.md      # lane: in_progress&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;WP04-tests.md         # lane: planned&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 design keeps all WP files in one location for easier discovery.&lt;/p&gt;
&lt;h2 id=&quot;kanban-board-display&quot;&gt;Kanban Board Display&lt;/h2&gt;
&lt;h3 id=&quot;cli-board-spec-kitty-agent-tasks-status&quot;&gt;CLI board (&lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt;)&lt;/h3&gt;
&lt;p&gt;The CLI status command displays a &lt;strong&gt;5-column&lt;/strong&gt; kanban board:&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;plaintext&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;Feature: 012-user-authentication&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;Kanban Board&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;Planned       Doing         For Review    In Review     Approved      Done&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;WP04-tests    WP03-front..  WP02-api      WP06-auth     WP05-docs     WP01-database&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;(stale: 15m)&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 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;1 WPs         1 WPs         1 WPs         1 WPs         1 WPs         1 WPs&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;Progress: 1/6 (16.7%)&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 display maps the 9 internal lanes to 6 board columns:&lt;/p&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Display Column&lt;/th&gt;&lt;th&gt;Internal Lane(s)&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Planned&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Doing&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; is active ownership; &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; is active implementation)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;For Review&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;In Review&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt; (active review in progress)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Approved&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Done&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;done&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;blocked&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;canceled&lt;/code&gt; WPs are not shown in the main board columns. They appear in separate sections below the board when present.&lt;/p&gt;
&lt;h3 id=&quot;python-api-board-agent_utilsstatuspy&quot;&gt;Python API board (&lt;code dir=&quot;auto&quot;&gt;agent_utils/status.py&lt;/code&gt;)&lt;/h3&gt;
&lt;p&gt;The Python API (&lt;code dir=&quot;auto&quot;&gt;show_kanban_status()&lt;/code&gt;) displays all 9 lanes as separate columns, giving full visibility into every state.&lt;/p&gt;
&lt;h2 id=&quot;who-moves-work&quot;&gt;Who Moves Work?&lt;/h2&gt;
&lt;h3 id=&quot;agents-move-work-forward&quot;&gt;Agents Move Work Forward&lt;/h3&gt;
&lt;p&gt;Agents are responsible for:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;planned -&gt; claimed&lt;/code&gt; (or &lt;code dir=&quot;auto&quot;&gt;doing&lt;/code&gt; alias) - Claiming a WP to work on&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;claimed -&gt; in_progress&lt;/code&gt; - Starting work in a workspace&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;in_progress -&gt; for_review&lt;/code&gt; - Signaling completion&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Commands:&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;# Claim a WP&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;tasks&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;move-task&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;WP01&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;--to&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;doing&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;--assignee&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;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;# Mark complete&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;tasks&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;move-task&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;WP01&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;--to&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;for_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;--note&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;Implementation complete&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;h3 id=&quot;reviewers-make-acceptreject-decisions&quot;&gt;Reviewers Make Accept/Reject Decisions&lt;/h3&gt;
&lt;p&gt;Reviewers are responsible for:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;for_review -&gt; in_review&lt;/code&gt; - Claiming a WP for active review&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;in_review -&gt; approved&lt;/code&gt; - Approving work (requires ReviewResult)&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;in_review -&gt; planned&lt;/code&gt; - Requesting changes with feedback (requires ReviewResult)&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;in_review -&gt; in_progress&lt;/code&gt; - Requesting minor changes, keeps workspace (requires ReviewResult)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Merge is responsible for &lt;code dir=&quot;auto&quot;&gt;approved -&gt; done&lt;/code&gt; after integration.&lt;/p&gt;
&lt;p&gt;Commands:&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;# Claim a WP for review (for_review -&gt; in_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;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;tasks&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;move-task&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;WP01&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;--to&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;in_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;--assignee&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;reviewer&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;# Review a WP (opens review workflow)&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.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;WP01&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;# Approve (in_review -&gt; approved)&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;tasks&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;move-task&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;WP01&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;--to&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;approved&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;--approval-ref&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#42&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;# Request changes with feedback file (in_review -&gt; planned)&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;tasks&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;move-task&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;WP01&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;--to&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;planned&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;--review-feedback-file&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;feedback.md&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;# Once ALL WPs are approved or done, validate the mission before merge&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.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;rework-after-a-rejection-is-not-an-override&quot;&gt;Rework After a Rejection Is Not an Override&lt;/h3&gt;
&lt;p&gt;An ordinary review loop (reject → rework → resubmit → approve) needs no &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt;.
Each actor passes its own &lt;code dir=&quot;auto&quot;&gt;--agent&lt;/code&gt; identity:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Implementer:&lt;/strong&gt; the WP’s latest implementer can resume a rejected WP and resubmit it to
&lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;. This holds even while the agent slot still names the reviewer. The latest
implementer is the most recent actor to move the WP into &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;,
excluding two kinds of move: a reviewer’s rework verdict that carries review feedback,
and one made under a generic identity such as &lt;code dir=&quot;auto&quot;&gt;user&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reviewer:&lt;/strong&gt; any named agent whose tool differs from the latest implementer’s can
review straight from &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;: claim it into &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;, approve it, or reject it
back to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; with feedback. A generic identity never counts as a reviewer.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt; verdicts:&lt;/strong&gt; only the agent holding the review claim can issue them.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These moves are recorded as ordinary transitions, so the review history lists each
cycle as rejected or approved and never as &lt;code dir=&quot;auto&quot;&gt;rejected → overridden&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;The ownership check compares agent &lt;em&gt;tools&lt;/em&gt;, not full identities. It prevents a
different agent from moving your WP by accident, but it does not prove that review
was independent.&lt;/p&gt;
&lt;p&gt;An &lt;strong&gt;arbiter override&lt;/strong&gt; is recorded only when someone deliberately overrules a
rejection. That means forcing a rejected WP from &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; straight to &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; or
&lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, with a note. The override counts after a rejection from either &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;
or &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;users-and-external-orchestrators-can-override&quot;&gt;Users and External Orchestrators Can Override&lt;/h3&gt;
&lt;p&gt;Users can override lane transitions when needed:&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;# Force move (e.g., to un-block stuck work or leave a terminal lane)&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;tasks&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;move-task&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;WP01&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;--to&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;planned&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:#82AAFF;--1:#3B61B0&quot;&gt;--note&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;Reopening after hotfix&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;A work package leaves &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; only through a recorded review verdict or an operator force with a note. The rule lives in the transition pipeline, so it holds on every surface: &lt;code dir=&quot;auto&quot;&gt;move-task --force --note&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;agent status emit --force --reason&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;orchestrator-api transition --force --note&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;agent action implement --force --note&lt;/code&gt;. Without the note the move is refused before anything is written. See ADR &lt;a href=&quot;/adr/4.x/2026-10-07-3-review-lane-exit-requires-verdict-or-forced-note/&quot;&gt;2026-10-07-3&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;External orchestrators should request equivalent transitions through &lt;code dir=&quot;auto&quot;&gt;spec-kitty orchestrator-api transition ...&lt;/code&gt;, including review-handoff evidence such as &lt;code dir=&quot;auto&quot;&gt;--subtasks-complete&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--implementation-evidence-present&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--review-ref&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;--evidence-json&lt;/code&gt;, so host validation and audit history stay consistent.&lt;/p&gt;
&lt;h2 id=&quot;rules-and-constraints&quot;&gt;Rules and Constraints&lt;/h2&gt;
&lt;h3 id=&quot;one-agent-per-wp-in-progress&quot;&gt;One Agent Per WP in Progress&lt;/h3&gt;
&lt;p&gt;When a WP is in &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Only the assigned agent should work on it&lt;/li&gt;
&lt;li&gt;Other agents should work on different WPs&lt;/li&gt;
&lt;li&gt;This prevents conflicts and wasted work&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;dependencies-must-be-satisfied&quot;&gt;Dependencies Must Be Satisfied&lt;/h3&gt;
&lt;p&gt;Before moving a WP to &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;All dependencies must be in &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; lane (or at least &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;If WP02 depends on WP01, WP01 should be complete first&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The implement command enforces this:&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;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;&amp;#x3C;name&gt;&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;# Ensures WP01 code is available&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;review-before-done&quot;&gt;Review Before Done&lt;/h3&gt;
&lt;p&gt;WPs cannot skip directly from &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Must pass through &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; first&lt;/li&gt;
&lt;li&gt;Review approval records &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt;; merge/integration records &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;This ensures all work is validated before it lands&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;subtask-validation&quot;&gt;Subtask Validation&lt;/h3&gt;
&lt;p&gt;Before moving to &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;All subtasks in the WP must be marked &lt;code dir=&quot;auto&quot;&gt;[x]&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;The system blocks moves if subtasks are unchecked (unless &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt; is used)&lt;/li&gt;
&lt;li&gt;Ensures nothing is forgotten&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;common-patterns&quot;&gt;Common Patterns&lt;/h2&gt;
&lt;h3 id=&quot;linear-workflow&quot;&gt;Linear Workflow&lt;/h3&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;plaintext&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;WP01 -&gt; WP02 -&gt; WP03 -&gt; WP04&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Each WP moves through lanes sequentially. One agent handles everything.&lt;/p&gt;
&lt;h3 id=&quot;parallel-workflow&quot;&gt;Parallel Workflow&lt;/h3&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;plaintext&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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;        &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;WP01 (done)&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;/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;WP02 (in_progress)  WP03 (in_progress)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Multiple WPs in &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; simultaneously. Different agents work in parallel.&lt;/p&gt;
&lt;h3 id=&quot;review-feedback-loop&quot;&gt;Review Feedback Loop&lt;/h3&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;plaintext&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;planned -&gt; claimed -&gt; in_progress -&gt; for_review -&gt; in_review -&gt; planned -&gt; claimed -&gt; in_progress -&gt; for_review -&gt; in_review -&gt; approved -&gt; done&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;/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;(feedback)                                                  (approved)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Work returned from review goes back to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; with feedback.&lt;/p&gt;
&lt;h3 id=&quot;blocking-pattern&quot;&gt;Blocking Pattern&lt;/h3&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;plaintext&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;planned -&gt; claimed -&gt; in_progress -&gt; blocked -&gt; in_progress -&gt; for_review -&gt; approved -&gt; done&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;/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;(blocker)    (unblocked)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Work paused due to external dependency, then resumed.&lt;/p&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See Also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/spec-driven-development/&quot;&gt;Spec-Driven Development&lt;/a&gt; - The methodology that creates work packages&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Lanes&lt;/a&gt; - How parallel development works&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/ai-agent-architecture/&quot;&gt;AI Agent Architecture&lt;/a&gt; - How agents claim and process work&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;This document explains how lanes work. For practical steps on moving work, see the how-to guides.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;try-it&quot;&gt;Try It&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/claude-code-integration/&quot;&gt;Claude Code Integration&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;how-to-guides&quot;&gt;How-To Guides&lt;/h2&gt;
&lt;ul&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;/ul&gt;</content>
</entry>
