<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/mission-types/">
  <id>https://docs.spec-kitty.ai/context/mission-types/</id>
  <title>Mission Types</title>
  <updated>2026-11-13T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/context/mission-types/"/>
  <summary>The four Mission types Spec Kitty ships today, their purpose, phases, and how to choose one.</summary>
  <content type="html">&lt;span id=&quot;mission-types&quot;&gt;&lt;/span&gt;
&lt;p&gt;A &lt;a href=&quot;/context/ops-vs-missions/&quot;&gt;Mission&lt;/a&gt; is the canonical spec-to-consolidate workflow unit.
Every mission is an instance of one &lt;strong&gt;mission type&lt;/strong&gt;, which shapes the phases
it moves through, the artifacts it produces, and the agent instructions used
along the way. As of this writing there are exactly four mission types, each
defined by its own &lt;code dir=&quot;auto&quot;&gt;mission.yaml&lt;/code&gt; under &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/missions/&lt;/code&gt; (the built-in pack
carries an identical copy under &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&amp;#x3C;type&gt;/&lt;/code&gt;, beside the
&lt;code dir=&quot;auto&quot;&gt;mission-runtime.yaml&lt;/code&gt; step DAG):
&lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;. There is no fifth type
— if you’re choosing, pick from this list.&lt;/p&gt;
&lt;h2 id=&quot;how-to-choose&quot;&gt;How to choose&lt;/h2&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Your situation&lt;/th&gt;&lt;th&gt;Mission type&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;You’re building or changing software: a feature, a fix, a refactor, with tests&lt;/td&gt;&lt;td&gt;&lt;strong&gt;software-dev&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;You need to systematically investigate a question and produce evidence-backed findings&lt;/td&gt;&lt;td&gt;&lt;strong&gt;research&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;You’re creating or overhauling user-facing or contributor documentation&lt;/td&gt;&lt;td&gt;&lt;strong&gt;documentation&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;You need a goal-oriented plan/strategy document, not code or docs, with room to iterate&lt;/td&gt;&lt;td&gt;&lt;strong&gt;plan&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;If your task doesn’t need a spec, a review gate, or multi-session tracking at
all, you may not need a Mission — see &lt;a href=&quot;/context/ops-vs-missions/&quot;&gt;Ops vs. Missions&lt;/a&gt;
for the Op alternative.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;software-dev&quot;&gt;software-dev&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Purpose&lt;/strong&gt;: “Build high-quality software with structured workflows and
test-driven development.” Enforces Library-First, CLI Interface, and
Test-First principles; tests are written before code.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Phases&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;discovery&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;specify&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;tasks&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;analyze&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt; →
&lt;code dir=&quot;auto&quot;&gt;review&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt;, per the mission’s runtime step DAG in &lt;code dir=&quot;auto&quot;&gt;mission-runtime.yaml&lt;/code&gt;):&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Discovery &amp;#x26; Research&lt;/li&gt;
&lt;li&gt;Specification&lt;/li&gt;
&lt;li&gt;Implementation Planning&lt;/li&gt;
&lt;li&gt;Tasks&lt;/li&gt;
&lt;li&gt;Analysis (cross-artifact consistency, recorded as an analysis report)&lt;/li&gt;
&lt;li&gt;Implementation&lt;/li&gt;
&lt;li&gt;Code Review&lt;/li&gt;
&lt;li&gt;Acceptance&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;mission.yaml&lt;/code&gt; workflow description frames the same arc as research → design →
implement → test → review. Required artifacts: &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.md&lt;/code&gt;; source code lands under &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Best for&lt;/strong&gt;: any code change — new features, bug fixes, refactors — where
tests, an implementation plan, and code review matter.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;research&quot;&gt;research&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Purpose&lt;/strong&gt;: “Conduct systematic research with structured methodology and
evidence synthesis.” Enforces research integrity and methodological rigor: all
sources must be documented, findings must trace back to evidence, and at least
3 sources must be documented before synthesis can begin.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Phases&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;scoping&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;methodology&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;gathering&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;synthesis&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;output&lt;/code&gt; →
&lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt;, per the mission’s runtime step DAG):&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Research Scoping&lt;/li&gt;
&lt;li&gt;Methodology Design&lt;/li&gt;
&lt;li&gt;Source Gathering&lt;/li&gt;
&lt;li&gt;Findings Synthesis&lt;/li&gt;
&lt;li&gt;Publication Output&lt;/li&gt;
&lt;li&gt;Acceptance&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Required artifacts: &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; (research question/scope), &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;
(methodology), &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;findings.md&lt;/code&gt; (synthesized findings). The mission
also expects &lt;code dir=&quot;auto&quot;&gt;research/source-register.csv&lt;/code&gt; documenting sources with citations, URLs,
and access dates; the gathering step needs at least three &lt;code dir=&quot;auto&quot;&gt;source_documented&lt;/code&gt;
events, and publication is gated on approval.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Best for&lt;/strong&gt;: systematic literature reviews, empirical investigations, or any
question that needs a defensible, cited evidence trail rather than a single
freeform answer.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;documentation&quot;&gt;documentation&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Purpose&lt;/strong&gt;: “Create and maintain high-quality software documentation
following Write the Docs and Divio principles.” Drives documentation as code,
using the Divio four-type system (tutorial, how-to, reference, explanation)
and supporting three iteration modes: &lt;code dir=&quot;auto&quot;&gt;initial&lt;/code&gt; (from scratch), &lt;code dir=&quot;auto&quot;&gt;gap_filling&lt;/code&gt;
(audit existing docs and fill gaps), and &lt;code dir=&quot;auto&quot;&gt;mission_specific&lt;/code&gt; (document one
component; &lt;code dir=&quot;auto&quot;&gt;feature_specific&lt;/code&gt; is accepted as a legacy input alias).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Phases&lt;/strong&gt; (declared under &lt;code dir=&quot;auto&quot;&gt;workflow.phases&lt;/code&gt;; the runtime step DAG follows the
same arc and adds a final acceptance step):&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Discover — identify documentation needs and target audience&lt;/li&gt;
&lt;li&gt;Audit — analyze existing documentation and identify gaps&lt;/li&gt;
&lt;li&gt;Design — plan documentation structure and Divio types&lt;/li&gt;
&lt;li&gt;Generate — create documentation from templates and generators&lt;/li&gt;
&lt;li&gt;Validate — check quality, accessibility, and completeness&lt;/li&gt;
&lt;li&gt;Publish — deploy documentation and notify stakeholders&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Required artifacts: &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.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;gap-analysis.md&lt;/code&gt;.
Supports generator integration (JSDoc, Sphinx, rustdoc) for API reference
docs.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Best for&lt;/strong&gt;: standing up documentation from nothing, auditing and closing
gaps in existing docs, or documenting one specific component in depth.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;plan&quot;&gt;plan&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Purpose&lt;/strong&gt;: “Goal-oriented planning with iterative refinement.” Designed
for planning artifacts (strategy, structured plans) rather than code or
end-user docs, where iteration is expected: a review can send a draft back
for another pass instead of forcing linear progress.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Phases&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;specify&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;review&lt;/code&gt;, per the mission’s
runtime step DAG):&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Specify — define the goals&lt;/li&gt;
&lt;li&gt;Research &amp;#x26; Analysis&lt;/li&gt;
&lt;li&gt;Draft Plan&lt;/li&gt;
&lt;li&gt;Review &amp;#x26; Approval&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Required artifacts: &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;; optional &lt;code dir=&quot;auto&quot;&gt;research.md&lt;/code&gt; and a &lt;code dir=&quot;auto&quot;&gt;data/&lt;/code&gt;
directory. Unlike the other three types, this mission type’s approval gate is
plan approval rather than a code-review or publication gate.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Best for&lt;/strong&gt;: producing a goal-oriented plan or strategy document where you
expect to iterate — research findings can send you back to restructuring, and
review can send a draft back for another pass — before anything is
implemented.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;verifying-this-list-yourself&quot;&gt;Verifying this list yourself&lt;/h2&gt;
&lt;p&gt;This page is generated from reading each mission type’s own definition
directly, not from memory:&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;ls&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;-d&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;src/specify_cli/missions/&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;/&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;|&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;grep&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;-v&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;__pycache__&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;# src/specify_cli/missions/documentation/  plan/  research/  software-dev/&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;cat&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;src/specify_cli/missions/&amp;#x3C;type&gt;/mission.yaml&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;If a fifth mission type directory appears in that listing that isn’t described
above, this page is stale — file a docs gap rather than guessing at its
purpose.&lt;/p&gt;
&lt;p&gt;For the distinction between starting a Mission and using a lightweight Op
instead, see &lt;a href=&quot;/context/ops-vs-missions/&quot;&gt;Ops vs. Missions&lt;/a&gt;.&lt;/p&gt;</content>
</entry>
