<?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/switch-missions/">
  <id>https://docs.spec-kitty.ai/guides/how-to/missions/switch-missions/</id>
  <title>How to Switch Missions</title>
  <updated>2026-06-03T00: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/switch-missions/"/>
  <summary>Choose and change missions to match software, research, or documentation workflows.</summary>
  <content type="html">&lt;span id=&quot;how-to-switch-missions&quot;&gt;&lt;/span&gt;
&lt;p&gt;Missions shape the prompts, artifacts, and workflows Spec Kitty uses for each feature. Each feature selects one mission during &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;, and you can inspect or start new features with a different mission at any time.&lt;/p&gt;
&lt;h2 id=&quot;understanding-per-feature-missions&quot;&gt;Understanding Per-Feature Missions&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Missions are scoped per feature folder under &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The mission defines the workflow steps — each with its own templates — and the artifacts created.&lt;/li&gt;
&lt;li&gt;Switching missions means creating a new feature with a different mission, not mutating an existing feature’s mission.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;mission-selection&quot;&gt;Mission Selection&lt;/h2&gt;
&lt;p&gt;During specification, Spec Kitty infers the mission from your prompt or lets you choose explicitly.&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.specify&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;Research market viability&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:#919F9F;--1:#5F636F&quot;&gt;# -&gt; Infers &quot;research&quot; mission&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;listing-available-missions&quot;&gt;Listing Available Missions&lt;/h2&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;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;list&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 shows all missions and highlights the active mission for the current feature.&lt;/p&gt;
&lt;h2 id=&quot;getting-mission-info&quot;&gt;Getting Mission Info&lt;/h2&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;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;info&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;research&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 this to review the steps, their templates, and expected artifacts before you start.&lt;/p&gt;
&lt;h2 id=&quot;working-with-different-missions&quot;&gt;Working with Different Missions&lt;/h2&gt;
&lt;h3 id=&quot;software-dev-mission&quot;&gt;Software Dev Mission&lt;/h3&gt;
&lt;p&gt;Use this for product and engineering delivery.&lt;/p&gt;
&lt;p&gt;Workflow:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Specify -&gt; Plan -&gt; Tasks -&gt; Implement -&gt; Review&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Key artifacts:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tasks/&lt;/code&gt;, execution workspaces&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;research-mission&quot;&gt;Research Mission&lt;/h3&gt;
&lt;p&gt;Use this for investigations, experiments, or feasibility work.&lt;/p&gt;
&lt;p&gt;Workflow:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Question -&gt; Methodology -&gt; Gather -&gt; Analyze -&gt; Synthesize&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Key artifacts:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Research prompts, findings, and summary reports&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;documentation-mission&quot;&gt;Documentation Mission&lt;/h3&gt;
&lt;p&gt;Use this when your goal is documentation coverage or quality.&lt;/p&gt;
&lt;p&gt;Workflow:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Audit -&gt; Design -&gt; Generate -&gt; Validate&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Key artifacts:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Coverage matrix, doc plan, generated doc sets&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/missions/&quot;&gt;Missions&lt;/a&gt; - All available missions&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/cli-commands/&quot;&gt;CLI Commands&lt;/a&gt; - Mission CLI commands&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-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;h2 id=&quot;background&quot;&gt;Background&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/mission-system/&quot;&gt;Mission System&lt;/a&gt; - How missions work internally&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/documentation-mission/&quot;&gt;Documentation Mission&lt;/a&gt; - Divio documentation workflow&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/missions-overview/&quot;&gt;Missions Overview&lt;/a&gt; - Tutorial walkthrough&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
