<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/tutorials/missions-overview/">
  <id>https://docs.spec-kitty.ai/guides/tutorials/missions-overview/</id>
  <title>Understanding Spec Kitty Missions</title>
  <updated>2026-08-09T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/tutorials/missions-overview/"/>
  <summary>Tutorial for Understanding Spec Kitty Missions in Spec Kitty 3.2: Spec Kitty supports four mission types that tailor the workflow and artifacts to your goal.</summary>
  <content type="html">&lt;span id=&quot;understanding-spec-kitty-missions&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Divio type&lt;/strong&gt;: Tutorial&lt;/p&gt;
&lt;p&gt;Spec Kitty supports four mission types that tailor the workflow and artifacts to your goal.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Time&lt;/strong&gt;: ~45 minutes
&lt;strong&gt;Prerequisites&lt;/strong&gt;: Completed &lt;a href=&quot;/guides/tutorials/getting-started/&quot;&gt;Getting Started&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Understanding Spec Kitty missions - Mission Kitty briefing&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Stylized splash — the spy-themed cards are decorative. The four actual mission types (Software Dev, Deep Research, Documentation, Plan) are described below.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;what-is-a-mission&quot;&gt;What Is a Mission?&lt;/h2&gt;
&lt;p&gt;A mission selects the default templates, prompts, and outputs for your work. You choose it during &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; or when running &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;. A mission is the unit that runs the whole spec-to-merge lifecycle; each mission decomposes into work packages (WPs) your agent implements one at a time — see &lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt; for that loop.&lt;/p&gt;
&lt;h2 id=&quot;the-four-mission-types&quot;&gt;The Four Mission Types&lt;/h2&gt;
&lt;p&gt;For the full purpose, phases, and required artifacts of each type, see &lt;a href=&quot;/context/mission-types/&quot;&gt;Mission Types&lt;/a&gt; — this page only covers what you need to pick one and get moving.&lt;/p&gt;
&lt;h3 id=&quot;software-dev-kitty&quot;&gt;Software Dev Kitty&lt;/h3&gt;
&lt;p&gt;Best for building software features and products.&lt;/p&gt;
&lt;p&gt;Example use cases:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;New API endpoint&lt;/li&gt;
&lt;li&gt;UI feature development&lt;/li&gt;
&lt;li&gt;Performance improvements&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;deep-research-kitty&quot;&gt;Deep Research Kitty&lt;/h3&gt;
&lt;p&gt;Best for structured research deliverables.&lt;/p&gt;
&lt;p&gt;Example use cases:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Competitive analysis&lt;/li&gt;
&lt;li&gt;Architecture decision research&lt;/li&gt;
&lt;li&gt;Technology evaluation&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;documentation-kitty&quot;&gt;Documentation Kitty&lt;/h3&gt;
&lt;p&gt;Best for creating or updating documentation sets.&lt;/p&gt;
&lt;p&gt;Example use cases:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;End-user docs refresh&lt;/li&gt;
&lt;li&gt;API reference overhaul&lt;/li&gt;
&lt;li&gt;Internal playbooks&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;plan-kitty&quot;&gt;Plan Kitty&lt;/h3&gt;
&lt;p&gt;Best for goal-oriented planning and strategy documents where you expect to iterate — not code, not docs.&lt;/p&gt;
&lt;p&gt;Example use cases:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Multi-quarter roadmap or strategy doc&lt;/li&gt;
&lt;li&gt;A structured decision/investigation writeup with a rollback-to-draft cycle&lt;/li&gt;
&lt;li&gt;Any goal-oriented plan you want gated by explicit review/approval rather than a code-review or publication gate&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;try-it-create-a-research-mission&quot;&gt;Try It: Create a Research Mission&lt;/h2&gt;
&lt;p&gt;Create a project, then start the research mission:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;init&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;my-research-project&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--ai&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;claude&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;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;my-research-project&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Use &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt; with the research mission to start a research workflow.&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.research Compare three task queue options for a Python service.&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 results (abridged):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/###-task-queue-research/&lt;/code&gt; directory&lt;/li&gt;
&lt;li&gt;Research artifacts defined by the mission templates&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;how-missions-affect-your-workflow&quot;&gt;How Missions Affect Your Workflow&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Templates&lt;/strong&gt;: Each mission uses its own spec/plan/templates.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Artifacts&lt;/strong&gt;: Research missions create research notes; documentation missions generate Divio-oriented sections.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Validation&lt;/strong&gt;: Review criteria differ based on mission expectations.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;the-mission-lifecycle-briefly&quot;&gt;The Mission Lifecycle, Briefly&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;specify → plan → tasks → analyze → implement (per WP: claim → implement → review, with rejection cycles) → accept → merge&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Every mission type — Software Dev, Deep Research, Documentation, and Plan — moves through this same loop; only the artifacts and templates change per type. For the full walkthrough with real commands, see &lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;“Unknown mission”&lt;/strong&gt;: Use &lt;code dir=&quot;auto&quot;&gt;spec-kitty mission list&lt;/code&gt; to list available missions.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Missing &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.research&lt;/code&gt;&lt;/strong&gt;: Your agent’s command files are stale or weren’t generated for this project. Run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; to regenerate them, then check &lt;code dir=&quot;auto&quot;&gt;ls .claude/commands/&lt;/code&gt; (or the equivalent directory for your agent) for &lt;code dir=&quot;auto&quot;&gt;spec-kitty.research.md&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;whats-next&quot;&gt;What’s Next?&lt;/h2&gt;
&lt;p&gt;Explore the full workflow in &lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt; or dive deeper into specific missions.&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/missions/switch-missions/&quot;&gt;Switch Missions&lt;/a&gt; - Change mission types&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/create-specification/&quot;&gt;Create a Specification&lt;/a&gt; - Start with any mission&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/install-and-upgrade/&quot;&gt;Install and Upgrade&lt;/a&gt; - Initial setup options&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/missions/&quot;&gt;Missions&lt;/a&gt; - All mission types reference&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/configuration/&quot;&gt;Configuration&lt;/a&gt; - Project settings&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
