<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/tutorials/multi-agent-workflow/">
  <id>https://docs.spec-kitty.ai/guides/tutorials/multi-agent-workflow/</id>
  <title>Multi-Agent Parallel Development</title>
  <updated>2026-08-11T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/tutorials/multi-agent-workflow/"/>
  <summary>Tutorial for Multi-Agent Parallel Development in Spec Kitty 3.2: Learn how to coordinate multiple AI agents working on different work packages simultaneously.</summary>
  <content type="html">&lt;span id=&quot;multi-agent-parallel-development&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Divio type&lt;/strong&gt;: Tutorial&lt;/p&gt;
&lt;p&gt;Learn how to coordinate multiple AI agents working on different work packages simultaneously.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Time&lt;/strong&gt;: ~1 hour
&lt;strong&gt;Prerequisites&lt;/strong&gt;: Completed &lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Multi-agent parallel development - Mission Kitty splash&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Stylized splash — the glowing parallel lanes are decorative. Worktrees, WP dependencies, and the hands-on steps are in the text below.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;why-parallel-development&quot;&gt;Why Parallel Development?&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Shorter delivery time by splitting work packages&lt;/li&gt;
&lt;li&gt;Clear isolation with dedicated execution worktrees&lt;/li&gt;
&lt;li&gt;Reduced merge conflicts&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;understanding-work-package-dependencies&quot;&gt;Understanding work package dependencies&lt;/h2&gt;
&lt;p&gt;Common dependency patterns:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Linear&lt;/strong&gt;: WP02 depends on WP01&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Fan-out&lt;/strong&gt;: WP01 unblocks multiple packages&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Diamond&lt;/strong&gt;: WP02 and WP03 depend on WP01, then WP04 depends on both&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Dependencies are declared in each WP frontmatter.&lt;/p&gt;
&lt;h2 id=&quot;hands-on-two-agents-two-wps&quot;&gt;Hands-On: Two Agents, Two WPs&lt;/h2&gt;
&lt;h3 id=&quot;setup&quot;&gt;Setup&lt;/h3&gt;
&lt;p&gt;Generate work packages for your feature.&lt;/p&gt;
&lt;p&gt;In your agent:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.tasks&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Confirm two independent packages are &lt;code dir=&quot;auto&quot;&gt;lane: &quot;planned&quot;&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;terminal-1-agent-a-on-wp01&quot;&gt;Terminal 1: Agent A on WP01&lt;/h3&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;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 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;&amp;#x3C;workspace&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;path&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;printed&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;by&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;the&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;command&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:#919F9F;--1:#5F636F&quot;&gt;# Agent A works here&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;terminal-2-agent-b-on-wp02&quot;&gt;Terminal 2: Agent B on WP02&lt;/h3&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;/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:#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;&amp;#x3C;workspace&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;path&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;printed&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;by&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;the&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;command&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:#919F9F;--1:#5F636F&quot;&gt;# Agent B works here simultaneously&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 agent updates only their own worktree. Do not edit another agent’s worktree.&lt;/p&gt;
&lt;h2 id=&quot;handling-dependencies-through-execution-lanes&quot;&gt;Handling Dependencies Through Execution Lanes&lt;/h2&gt;
&lt;p&gt;If WP02 depends on WP01, create WP02 from the WP01 base:&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;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;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Expected output (abridged):&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;OK Created workspace: .worktrees/###-feature-lane-b&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;git-worktrees-briefly&quot;&gt;Git Worktrees, Briefly&lt;/h2&gt;
&lt;p&gt;Each execution lane is a Git worktree on its own branch. Sequential WPs may reuse the same lane workspace, while independent WPs run in parallel in separate lane worktrees. For details, see &lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Workspace Model&lt;/a&gt; and &lt;a href=&quot;/architecture/git-worktrees/&quot;&gt;Git Worktrees&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;tips-for-coordinating-agents&quot;&gt;Tips for Coordinating Agents&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Run &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks list-tasks&lt;/code&gt; to see current lanes.&lt;/li&gt;
&lt;li&gt;Use &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks add-history WP## --note &quot;...&quot;&lt;/code&gt; to share progress.&lt;/li&gt;
&lt;li&gt;Avoid overlapping file edits across WPs.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;“lanes.json is required”&lt;/strong&gt;: Run task finalization before implementation.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Worktree already exists&lt;/strong&gt;: Run &lt;code dir=&quot;auto&quot;&gt;git worktree list&lt;/code&gt; and reuse the existing folder.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent edits the wrong WP&lt;/strong&gt;: Stop and switch to the workspace path printed for the correct WP before continuing.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;whats-next&quot;&gt;What’s Next?&lt;/h2&gt;
&lt;p&gt;You’ve completed the core tutorials. Explore how-to guides for specific tasks or explanations for deeper understanding.&lt;/p&gt;
&lt;h3 id=&quot;related-how-to-guides&quot;&gt;Related How-To Guides&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/collaboration/parallel-development/&quot;&gt;Parallel Development&lt;/a&gt; - Run multiple agents simultaneously&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/handle-dependencies/&quot;&gt;Handle Dependencies&lt;/a&gt; - Manage WP dependencies&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/implement-work-package/&quot;&gt;Implement a work package&lt;/a&gt; - Detailed implementation steps&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;reference-documentation&quot;&gt;Reference Documentation&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/api/agent-subcommands/&quot;&gt;Agent Subcommands&lt;/a&gt; - Agent workflow commands&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/cli-commands/&quot;&gt;CLI Commands&lt;/a&gt; - Full command reference&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/file-structure/&quot;&gt;File Structure&lt;/a&gt; - Worktree layout&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;learn-more&quot;&gt;Learn More&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/multi-agent-orchestration/&quot;&gt;Multi-Agent Orchestration&lt;/a&gt; - Coordination patterns&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/collaboration/run-external-orchestrator/&quot;&gt;Run External Orchestrator&lt;/a&gt; - Automate WP execution with the external provider&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Workspace Model&lt;/a&gt; - Isolation strategy&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/git-worktrees/&quot;&gt;Git Worktrees&lt;/a&gt; - How worktrees work&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
