<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/how-to/missions/generate-tasks/">
  <id>https://docs.spec-kitty.ai/guides/how-to/missions/generate-tasks/</id>
  <title>How to Generate Work Packages</title>
  <updated>2026-06-06T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/how-to/missions/generate-tasks/"/>
  <summary>How to generate work packages with Spec Kitty 3.2: Use this guide to turn a plan into work packages with /spec-kitty.tasks.</summary>
  <content type="html">&lt;span id=&quot;how-to-generate-work-packages&quot;&gt;&lt;/span&gt;
&lt;p&gt;Use this guide to turn a plan into work packages with &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt; translates implementation concerns (IC-## entries) from &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;
into executable work packages. One concern may become multiple WPs; multiple small
concerns may merge into a single WP. Each generated WP should cite the implementation
concern(s) it addresses via &lt;code dir=&quot;auto&quot;&gt;plan_concern_refs&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;wps.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;feature&gt;/plan.md&lt;/code&gt; exists&lt;/li&gt;
&lt;li&gt;All &lt;code dir=&quot;auto&quot;&gt;[NEEDS CLARIFICATION]&lt;/code&gt; items are resolved&lt;/li&gt;
&lt;li&gt;You are in the repository root checkout&lt;/li&gt;
&lt;li&gt;Task artifacts are committed to the mission’s target branch&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;the-command&quot;&gt;The Command&lt;/h2&gt;
&lt;p&gt;In your agent:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.tasks&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;what-gets-created&quot;&gt;What Gets Created&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;feature&gt;/tasks.md&lt;/code&gt; (overview checklist)&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;feature&gt;/tasks/WP01-*.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;WP02-*.md&lt;/code&gt;, … (prompt files)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Work packages live in a &lt;strong&gt;flat&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;tasks/&lt;/code&gt; directory. Lane status is stored in each prompt file frontmatter via &lt;code dir=&quot;auto&quot;&gt;lane: &quot;planned&quot;&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;understanding-work-packages&quot;&gt;Understanding Work Packages&lt;/h2&gt;
&lt;p&gt;Each WP file contains:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A single goal for the agent&lt;/li&gt;
&lt;li&gt;Subtasks and dependencies&lt;/li&gt;
&lt;li&gt;The exact completion command to move the WP to review&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;finalizing-tasks&quot;&gt;Finalizing Tasks&lt;/h2&gt;
&lt;p&gt;After reviewing the generated WPs, finalize the task set.&lt;/p&gt;
&lt;p&gt;In your terminal:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;mission&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;finalize-tasks&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;example-output&quot;&gt;Example Output&lt;/h2&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.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;kitty-specs/012-feature/tasks/WP01-auth-backend.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;kitty-specs/012-feature/tasks/WP02-auth-ui.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;kitty-specs/012-feature/tasks/WP03-tests.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Missing plan&lt;/strong&gt;: Run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.plan&lt;/code&gt; first.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Tasks look incomplete&lt;/strong&gt;: Resolve clarifications in &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt; and rerun &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Wrong directory&lt;/strong&gt;: Run from the repository root checkout.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Wrong target branch&lt;/strong&gt;: Re-check &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent mission branch-context --json&lt;/code&gt; before regenerating tasks.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;command-reference&quot;&gt;Command Reference&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/api/slash-commands/&quot;&gt;Slash Commands&lt;/a&gt; - All &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.*&lt;/code&gt; commands&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/agent-subcommands/&quot;&gt;Agent Subcommands&lt;/a&gt; - &lt;code dir=&quot;auto&quot;&gt;finalize-tasks&lt;/code&gt; and more&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/file-structure/&quot;&gt;File Structure&lt;/a&gt; - Where tasks are stored&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See Also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/create-plan/&quot;&gt;Create a Plan&lt;/a&gt; - Required before task generation&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/keep-main-clean/&quot;&gt;Keep Main Clean&lt;/a&gt; - Choose a target branch without changing planning location&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/implement-work-package/&quot;&gt;Implement a work package&lt;/a&gt; - Next step after tasks&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/handle-dependencies/&quot;&gt;Handle Dependencies&lt;/a&gt; - Managing WP dependencies&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;background&quot;&gt;Background&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/kanban-workflow/&quot;&gt;Kanban Workflow&lt;/a&gt; - Lane transitions explained&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Workspace Model&lt;/a&gt; - Why modern features use lane worktrees&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt; - Complete workflow walkthrough&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
