<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/mission-system/">
  <id>https://docs.spec-kitty.ai/architecture/mission-system/</id>
  <title>The Mission System Explained</title>
  <updated>2026-10-08T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/mission-system/"/>
  <summary>Why mission types exist and how they nest: the Mission Type, Mission, work package, and Workspace hierarchy, the four blueprints, and the two state machines next coordinates.</summary>
  <content type="html">&lt;span id=&quot;the-mission-system-explained&quot;&gt;&lt;/span&gt;
&lt;p&gt;Spec Kitty’s mission system lets you choose a workflow blueprint optimized for your type of work. This document explains why mission types exist, how they shape your experience, and how the pieces fit together.&lt;/p&gt;
&lt;p&gt;Terminology note:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;Mission Type&lt;/code&gt; = reusable blueprint such as &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;Mission&lt;/code&gt; = concrete tracked item under &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;mission-slug&gt;/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;Mission Run&lt;/code&gt; = runtime/session instance&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;Feature&lt;/code&gt; = retired legacy term for a mission; do not use it&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Selector&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; is the only mission selector on every command; the old &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; alias is removed (#1060) and exits with &lt;code dir=&quot;auto&quot;&gt;No such option&lt;/code&gt;. &lt;code dir=&quot;auto&quot;&gt;spec-kitty constitution&lt;/code&gt; is now &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;why-different-missions&quot;&gt;Why Different Missions?&lt;/h2&gt;
&lt;p&gt;Not all projects are the same:&lt;/p&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Work Type&lt;/th&gt;&lt;th&gt;Primary Goal&lt;/th&gt;&lt;th&gt;Key Activities&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Software development&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Working code&lt;/td&gt;&lt;td&gt;Write tests, implement features, review code&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Research&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Validated findings&lt;/td&gt;&lt;td&gt;Collect evidence, analyze data, synthesize conclusions&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Planning&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Actionable plan&lt;/td&gt;&lt;td&gt;Define architecture, map dependencies, write roadmaps&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Documentation&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Clear docs&lt;/td&gt;&lt;td&gt;Audit gaps, create content, validate accessibility&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;A workflow designed for software development doesn’t fit research:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;“All tests pass” makes no sense for a literature review&lt;/li&gt;
&lt;li&gt;“Documented sources” isn’t relevant for code implementation&lt;/li&gt;
&lt;li&gt;Phases like “gather data” don’t apply to feature development&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Mission types solve this by providing domain-specific workflows, validation rules, and artifacts.&lt;/p&gt;
&lt;h2 id=&quot;the-hierarchy-mission-type-mission-work-package-workspace&quot;&gt;The Hierarchy: Mission Type, Mission, work package, Workspace&lt;/h2&gt;
&lt;p&gt;Understanding how the pieces nest together is key to understanding Spec Kitty.&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;Mission Type (reusable workflow blueprint, e.g. 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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;+-- Mission (concrete tracked item)&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|     kitty-specs/042-auth-system/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|       meta.json        &amp;#x3C;-- links mission to mission type + target branch&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|       spec.md          &amp;#x3C;-- what we&apos;re building&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|       plan.md          &amp;#x3C;-- how we&apos;ll build it&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|       tasks.md         &amp;#x3C;-- WP breakdown&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|       tasks/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|         WP01.md        &amp;#x3C;-- work package prompt&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|         WP02.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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|         WP03.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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|           +-- Execution Workspace (.worktrees/042-auth-system-lane-a/)&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;|                 isolated git worktree resolved for this WP&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Mission Type&lt;/strong&gt; — A reusable workflow blueprint. It defines the steps (each carrying its prompt and content templates), the expected artifacts, and the guards. You never edit mission types directly; you select one when starting a mission.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Mission&lt;/strong&gt; — A concrete tracked item, stored in &lt;code dir=&quot;auto&quot;&gt;kitty-specs/###-name/&lt;/code&gt;. Each mission is linked to exactly one mission type via its &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; file. Different missions in the same project can use different mission types.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Feature&lt;/strong&gt; — Retired legacy term for a mission. You may still see &lt;code dir=&quot;auto&quot;&gt;feature&lt;/code&gt; in old filesystem fields and archived records; current commands and docs say mission.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;work package (WP)&lt;/strong&gt; — One parallelizable slice of work within a mission. Each WP has its own markdown prompt file (&lt;code dir=&quot;auto&quot;&gt;tasks/WP01.md&lt;/code&gt;), its own status on the kanban board, and its own dependencies on other WPs.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Workspace&lt;/strong&gt; — An isolated git worktree where a single WP is implemented. Each workspace has its own branch, its own working directory, and its own agent. Multiple workspaces can run in parallel.&lt;/p&gt;
&lt;h3 id=&quot;metajson-the-mission-to-mission-type-link&quot;&gt;meta.json: The Mission-to-Mission-Type Link&lt;/h3&gt;
&lt;p&gt;Every mission directory contains a &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; that records which mission type it uses:&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;json&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;{&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;feature_number&quot;&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:#C789D6;--1:#7C5686&quot;&gt;042&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;slug&quot;&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:#C789D6;--1:#7C5686&quot;&gt;042-auth-system&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;mission&quot;&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:#C789D6;--1:#7C5686&quot;&gt;software-dev&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;target_branch&quot;&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:#C789D6;--1:#7C5686&quot;&gt;main&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;created_at&quot;&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:#C789D6;--1:#7C5686&quot;&gt;2026-03-22T10:00:00Z&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&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 class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;vcs&quot;&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:#C789D6;--1:#7C5686&quot;&gt;git&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:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;mission&lt;/code&gt; field determines which templates, guards, and validation rules apply. If omitted, it defaults to &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;. The key name is historical; the stored value is the mission type.&lt;/p&gt;
&lt;p&gt;Different missions can use different mission types simultaneously:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/042-auth-system/&lt;/code&gt; — mission type &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/043-market-analysis/&lt;/code&gt; — mission type &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/044-api-docs/&lt;/code&gt; — mission type &lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/045-roadmap/&lt;/code&gt; — mission type &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;mission-types-are-doctrine-artifacts&quot;&gt;Mission Types Are Doctrine Artifacts&lt;/h2&gt;
&lt;p&gt;A mission type is not hardcoded into the runtime — it is a &lt;strong&gt;doctrine-defined
artifact&lt;/strong&gt;. The canonical catalogue lives in &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&amp;#x3C;type&gt;/&lt;/code&gt;,
where each type &lt;em&gt;offers&lt;/em&gt; its governance, action indices, step contracts, and
templates. The runtime is a finite-state machine that reads the &lt;em&gt;resolved&lt;/em&gt; mission
type keyed off the &lt;code dir=&quot;auto&quot;&gt;mission&lt;/code&gt; field in &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;; it holds no per-type knowledge
of its own.&lt;/p&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;MissionType&lt;/code&gt; doctrine artifact is &lt;strong&gt;load-bearing&lt;/strong&gt;: it is the single source of
truth for &lt;em&gt;“what is this mission type, what steps does it contain, and what gates
are checked?”&lt;/em&gt; The end-state retires the derived &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/missions/&lt;/code&gt; copies
entirely — the doctrine path (much of it a dead read-path today) goes live and the
&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; copies are removed in a &lt;strong&gt;user-invisible swap&lt;/strong&gt;, verified during
migration by transitional parity scaffolds that are then deleted (no surviving
parity ratchet). #883 is slice 1: governance and the dossier gate reader.&lt;/p&gt;
&lt;h3 id=&quot;software-dev-is-a-peer-not-a-special-case&quot;&gt;software-dev is a peer, not a special case&lt;/h3&gt;
&lt;p&gt;Historically &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt; was the default and carried hardcoded status woven
through the core loop. The direction now is that &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt; is an ordinary
built-in mission type on equal footing with &lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;,
and &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;. Its behaviour resolves from &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; through the same path as the
other three, with no &lt;code dir=&quot;auto&quot;&gt;software-dev-default&lt;/code&gt; special-casing. &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt; remains
the fallback mission type when &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; omits the &lt;code dir=&quot;auto&quot;&gt;mission&lt;/code&gt; field, but that
fallback governs only template-file selection — it no longer leaks software-dev
&lt;em&gt;governance&lt;/em&gt; onto non-software missions. See
&lt;a href=&quot;/architecture/mission-type-resolution/&quot;&gt;Mission-Type Resolution&lt;/a&gt; for the seam that makes this
so, and &lt;a href=&quot;/adr/3.x/2026-07-14-2-doctrine-to-core-mission-type-resolution-unification/&quot;&gt;ADR 2026-07-14-2&lt;/a&gt;
for the decision.&lt;/p&gt;
&lt;h3 id=&quot;the-dual-missions-tree-and-its-retirement-trajectory&quot;&gt;The dual missions tree and its retirement trajectory&lt;/h3&gt;
&lt;p&gt;Two mission trees exist today:&lt;/p&gt;

















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Tree&lt;/th&gt;&lt;th&gt;Role&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&amp;#x3C;type&gt;/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Canonical&lt;/strong&gt; — the source of truth for mission-type behaviour&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/missions/&amp;#x3C;type&gt;/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Derived copies&lt;/strong&gt; that a shrinking set of core readers still bind to directly&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The derived tree is &lt;strong&gt;on the deprecation path&lt;/strong&gt;, not to be entrenched: no new
content is added to it, and no “keep the trees in sync” guard is introduced (that
would entrench the split). The direction is derive-then-delete — each reader is
migrated to the doctrine tree one slice at a time, after which the derived copies
and finally the copy step are removed. The first migration (planned as slice 1 of
this retirement — issue #883) flips the dossier gate reader to the doctrine-tree
source. Later slices migrate templates, gates, and step contracts before the
&lt;code dir=&quot;auto&quot;&gt;specify_cli/missions/&lt;/code&gt; tree is deleted outright.&lt;/p&gt;
&lt;h2 id=&quot;how-missions-work&quot;&gt;How Missions Work&lt;/h2&gt;
&lt;h3 id=&quot;selected-when-creating-a-mission-during-spec-kittyspecify&quot;&gt;Selected When Creating a Mission During /spec-kitty.specify&lt;/h3&gt;
&lt;p&gt;When you run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;, Spec Kitty prompts for the mission type that will back the new mission:&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;? Select mission type:&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Software Dev Kitty - Build high-quality software with structured workflows&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Deep Research Kitty - Conduct systematic research with evidence synthesis&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Plan Kitty - Goal-oriented planning with iterative refinement&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Documentation Kitty - Create high-quality documentation following Divio principles&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;That choice determines:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Workflow phases (the steps you go through)&lt;/li&gt;
&lt;li&gt;Required artifacts (the files you produce)&lt;/li&gt;
&lt;li&gt;Guards (conditions that must be met to advance)&lt;/li&gt;
&lt;li&gt;Agent context (personality and instructions for AI agents)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The mission type is locked in when the mission is created and cannot be changed afterwards.&lt;/p&gt;
&lt;h3 id=&quot;two-state-machines-working-together&quot;&gt;Two State Machines Working Together&lt;/h3&gt;
&lt;p&gt;Missions involve two orthogonal state machines that work in tandem:&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Mission action state&lt;/strong&gt; — which outer lifecycle action are we in?&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;discovery --&gt; specify --&gt; plan --&gt; tasks --&gt; implement --&gt; review --&gt; accept&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Managed by the mission type’s step DAG and &lt;code dir=&quot;auto&quot;&gt;spec-kitty next&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;WP status&lt;/strong&gt; — where is each work package in its lifecycle?&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;planned --&gt; claimed --&gt; in_progress --&gt; for_review --&gt; in_review --&gt; approved --&gt; done&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Managed by the status model (append-only event log).&lt;/p&gt;
&lt;p&gt;Together they determine what &lt;code dir=&quot;auto&quot;&gt;spec-kitty next&lt;/code&gt; returns: “We’re in the implement action, WP01 is approved, WP02 is in_progress, WP03 is planned — your next action is implement WP03.”&lt;/p&gt;
&lt;h2 id=&quot;the-four-built-in-missions&quot;&gt;The Four Built-In Missions&lt;/h2&gt;
&lt;h3 id=&quot;software-dev-default&quot;&gt;software-dev (default)&lt;/h3&gt;
&lt;p&gt;Full software development lifecycle with work packages and code review.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Step sequence:&lt;/strong&gt;&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;discovery --&gt; specify --&gt; plan --&gt; tasks_outline --&gt; tasks_packages --&gt; tasks_finalize --&gt; implement --&gt; review --&gt; accept&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Required artifacts:&lt;/strong&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.md&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Guards:&lt;/strong&gt;&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Transition&lt;/th&gt;&lt;th&gt;What must be true&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;specify —&gt; plan&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; must exist&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;plan —&gt; implement&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt; must exist&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;implement —&gt; review&lt;/td&gt;&lt;td&gt;All WPs must be &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;review —&gt; accept&lt;/td&gt;&lt;td&gt;Review must be approved&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Agent context:&lt;/strong&gt; TDD practices, library-first architecture, tests before code.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Use when:&lt;/strong&gt; Building software missions such as features, fixing bugs, or refactoring code.&lt;/p&gt;
&lt;h3 id=&quot;research&quot;&gt;research&lt;/h3&gt;
&lt;p&gt;Systematic research with evidence-gated transitions.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Step sequence (state machine with loop):&lt;/strong&gt;&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;scoping --&gt; methodology --&gt; gathering &amp;#x3C;--&gt; synthesis --&gt; output --&gt; done&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;gathering &amp;#x3C;--&gt; synthesis&lt;/code&gt; loop allows iterative evidence collection. You can go back to gathering more data after an initial synthesis pass.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Required artifacts:&lt;/strong&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.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;findings.md&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Guards:&lt;/strong&gt;&lt;/p&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Transition&lt;/th&gt;&lt;th&gt;What must be true&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;scoping —&gt; methodology&lt;/td&gt;&lt;td&gt;Scope document (&lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt;) must exist&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;methodology —&gt; gathering&lt;/td&gt;&lt;td&gt;Methodology plan (&lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;) must exist&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;gathering —&gt; synthesis&lt;/td&gt;&lt;td&gt;At least 3 sources documented&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;synthesis —&gt; output&lt;/td&gt;&lt;td&gt;Findings document must exist&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;output —&gt; done&lt;/td&gt;&lt;td&gt;Publication approved&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Special:&lt;/strong&gt; Source tracking in &lt;code dir=&quot;auto&quot;&gt;source-register.csv&lt;/code&gt;, evidence in &lt;code dir=&quot;auto&quot;&gt;evidence-log.csv&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Agent context:&lt;/strong&gt; Research integrity, methodological rigor, evidence documentation.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Use when:&lt;/strong&gt; Investigating technologies, evaluating options, conducting literature reviews, competitive analysis — any work requiring structured evidence gathering.&lt;/p&gt;
&lt;h3 id=&quot;plan&quot;&gt;plan&lt;/h3&gt;
&lt;p&gt;Goal-oriented planning with iterative refinement.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Step sequence (runtime DAG):&lt;/strong&gt;&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;specify --&gt; research --&gt; plan --&gt; review&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Produces planning artifacts (architecture documents, roadmaps, design proposals) without implementation.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Required artifacts:&lt;/strong&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;research.md&lt;/code&gt; from the research step)&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Guards&lt;/strong&gt; (keyed on the runtime step ids, &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/plan/expected-artifacts.yaml&lt;/code&gt;):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;specify&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; exists&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;research.md&lt;/code&gt; exists&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt; exists&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;review&lt;/code&gt;: the plan is approved&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Use when:&lt;/strong&gt; Planning architecture, creating roadmaps, designing systems before implementation begins, writing design proposals.&lt;/p&gt;
&lt;h3 id=&quot;documentation&quot;&gt;documentation&lt;/h3&gt;
&lt;p&gt;Documentation creation following the Divio 4-type system (tutorials, how-to guides, reference, explanations).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Step sequence:&lt;/strong&gt;&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;discover --&gt; audit --&gt; design --&gt; generate --&gt; validate --&gt; publish&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Required artifacts:&lt;/strong&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.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;gap-analysis.md&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Special features:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Gap analysis identifies missing documentation by classifying existing docs against the Divio grid&lt;/li&gt;
&lt;li&gt;Supports auto-generation via JSDoc, Sphinx, or rustdoc for API reference docs&lt;/li&gt;
&lt;li&gt;Three iteration modes: initial (from scratch), gap-filling (audit and fill), mission-specific (single component; &lt;code dir=&quot;auto&quot;&gt;feature_specific&lt;/code&gt; accepted as a legacy input alias)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Guards:&lt;/strong&gt; No guards on step transitions. Validation checks run during acceptance: all Divio types valid, no conflicting generators, templates populated (no &lt;code dir=&quot;auto&quot;&gt;[TODO]&lt;/code&gt; markers), gap analysis complete.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Agent context:&lt;/strong&gt; Write the Docs best practices, Divio 4-type system, accessibility and bias-free language.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Use when:&lt;/strong&gt; Writing tutorials, API docs, how-to guides, filling documentation gaps, documenting a specific feature.&lt;/p&gt;
&lt;h2 id=&quot;mission-comparison&quot;&gt;Mission Comparison&lt;/h2&gt;















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;software-dev&lt;/th&gt;&lt;th&gt;research&lt;/th&gt;&lt;th&gt;plan&lt;/th&gt;&lt;th&gt;documentation&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Domain&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Software&lt;/td&gt;&lt;td&gt;Research&lt;/td&gt;&lt;td&gt;Planning&lt;/td&gt;&lt;td&gt;Documentation&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Steps&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;9 (DAG)&lt;/td&gt;&lt;td&gt;6 (state machine)&lt;/td&gt;&lt;td&gt;4 (linear)&lt;/td&gt;&lt;td&gt;6 (phases)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Has WP iteration&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Yes&lt;/td&gt;&lt;td&gt;Yes&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;td&gt;Yes&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Has loops&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;td&gt;Yes (gather more)&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Default mission&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Yes&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;required-artifacts-by-mission&quot;&gt;Required artifacts by mission&lt;/h3&gt;















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Artifact&lt;/th&gt;&lt;th align=&quot;center&quot;&gt;software-dev&lt;/th&gt;&lt;th align=&quot;center&quot;&gt;research&lt;/th&gt;&lt;th align=&quot;center&quot;&gt;plan&lt;/th&gt;&lt;th align=&quot;center&quot;&gt;documentation&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt;&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt;&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;findings.md&lt;/code&gt;&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;gap-analysis.md&lt;/code&gt;&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;—&lt;/td&gt;&lt;td align=&quot;center&quot;&gt;Required&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;which-mission-should-i-use&quot;&gt;Which Mission Should I Use?&lt;/h2&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;If you’re…&lt;/th&gt;&lt;th&gt;Use mission&lt;/th&gt;&lt;th&gt;Why&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Building a new feature with code changes&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Full lifecycle with TDD, work packages, code review&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Fixing a bug or refactoring existing code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Same lifecycle, just smaller scope&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Investigating or evaluating technology options&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Evidence-gated transitions ensure rigor&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Conducting a literature review or competitive analysis&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Source tracking and iterative gathering loops&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Planning a project roadmap or architecture&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Lightweight, produces plans without code&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Designing a system without implementing it yet&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Four steps, no work packages needed&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Writing tutorials, API docs, or how-to guides&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Divio system ensures comprehensive coverage&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Filling gaps in existing documentation&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Gap analysis mode finds what’s missing&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Commands:&lt;/strong&gt;&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:#919F9F;--1:#5F636F&quot;&gt;# List available missions&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;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;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&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;# Start a mission with a specific mission type&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;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;specify&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;--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;research&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;What are the best auth patterns?&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;/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;# Check which mission type a mission uses&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;kitty-specs/&amp;#x3C;mission-slug&gt;/meta.json&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;template-resolution-customizing-mission-prompts&quot;&gt;Template Resolution: Customizing Mission Prompts&lt;/h2&gt;
&lt;p&gt;Each mission provides command templates (the prompts agents see at each step) and content templates (scaffolding for artifacts like spec.md). You can override any template without modifying the package itself.&lt;/p&gt;
&lt;p&gt;When a template is needed, Spec Kitty searches three locations in order:&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Priority&lt;/th&gt;&lt;th&gt;Location&lt;/th&gt;&lt;th&gt;Purpose&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;1. Project override&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/overrides/command-templates/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Per-project customization&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;2. Global mission&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;~/.kittify/missions/{mission}/command-templates/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;User-wide defaults&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;3. Package default&lt;/td&gt;&lt;td&gt;(built into spec-kitty)&lt;/td&gt;&lt;td&gt;Ships with the tool&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;First match wins. The package default is always the fallback.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;To customize a prompt for your project&lt;/strong&gt;, drop a file into &lt;code dir=&quot;auto&quot;&gt;.kittify/overrides/command-templates/&lt;/code&gt;:&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:#919F9F;--1:#5F636F&quot;&gt;# Copy the default template&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;cp&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;~/.kittify/missions/software-dev/command-templates/implement.md&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&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 class=&quot;indent&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.kittify/overrides/command-templates/implement.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;/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;# Edit to taste&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;vim&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;.kittify/overrides/command-templates/implement.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Your override will be used instead of the package default for that step. Content templates (&lt;code dir=&quot;auto&quot;&gt;templates/&lt;/code&gt;) follow the same resolution chain.&lt;/p&gt;
&lt;h2 id=&quot;guards-what-blocks-step-transitions&quot;&gt;Guards: What Blocks Step Transitions&lt;/h2&gt;
&lt;p&gt;Guards are conditions that must be satisfied before a mission can advance to its next step. They prevent you from skipping ahead — you can’t plan without a specification, and you can’t review without all work packages completed.&lt;/p&gt;
&lt;h3 id=&quot;common-guards-youll-encounter&quot;&gt;Common guards you’ll encounter&lt;/h3&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Guard&lt;/th&gt;&lt;th&gt;What it checks&lt;/th&gt;&lt;th&gt;Example&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Artifact exists&lt;/td&gt;&lt;td&gt;A required file is present&lt;/td&gt;&lt;td&gt;Can’t start planning until &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; exists&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;All WPs approved/done&lt;/td&gt;&lt;td&gt;Every work package passed review or is already landed&lt;/td&gt;&lt;td&gt;Can’t start acceptance until all WPs are review-approved&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Gate passed&lt;/td&gt;&lt;td&gt;A named event was recorded&lt;/td&gt;&lt;td&gt;Can’t finish until review is approved&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Source count&lt;/td&gt;&lt;td&gt;Minimum number of evidence sources&lt;/td&gt;&lt;td&gt;Can’t synthesize until at least 3 sources documented (research)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;When a guard blocks you, &lt;code dir=&quot;auto&quot;&gt;spec-kitty next&lt;/code&gt; tells you what’s missing:&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;Blocked: artifact_exists(&quot;spec.md&quot;) not satisfied.&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;Action: Run /spec-kitty.specify to create the specification document.&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Guards vary by mission. The software-dev mission has guards on most transitions. The plan mission has none — you advance manually. The research mission uses source-count guards to ensure evidence quality. The documentation mission checks quality during acceptance rather than between steps.&lt;/p&gt;
&lt;h2 id=&quot;mission-templates-per-slash-command&quot;&gt;Mission Templates Per Slash Command&lt;/h2&gt;
&lt;p&gt;Each mission customizes the slash commands with domain-appropriate prompts:&lt;/p&gt;
&lt;h3 id=&quot;spec-kittyspecify&quot;&gt;/spec-kitty.specify&lt;/h3&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Mission&lt;/th&gt;&lt;th&gt;Prompt Focus&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Software Dev&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;User scenarios and acceptance criteria&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Research&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Research question, scope, expected outcomes&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Plan&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Goals, constraints, success criteria&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Documentation&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Iteration mode, Divio types, target audience&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;spec-kittyplan&quot;&gt;/spec-kitty.plan&lt;/h3&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Mission&lt;/th&gt;&lt;th&gt;Prompt Focus&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Software Dev&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Technical architecture and implementation plan&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Research&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Research methodology and data collection strategy&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Plan&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Architecture, roadmap, or design structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Documentation&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Documentation structure and generator configuration&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;spec-kittyimplement&quot;&gt;/spec-kitty.implement&lt;/h3&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Mission&lt;/th&gt;&lt;th&gt;Prompt Focus&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Software Dev&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Work packages with TDD workflow&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Research&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Data collection, analysis, synthesis tasks&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Plan&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;(no implementation phase)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Documentation&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Template creation, generator setup, content authoring&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;per-mission-vs-global&quot;&gt;Per-Mission vs. Global&lt;/h2&gt;
&lt;h3 id=&quot;before-080-project-wide-mission&quot;&gt;Before 0.8.0: Project-Wide Mission&lt;/h3&gt;
&lt;p&gt;Early versions set the mission at project level:&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;.kittify/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;mission.yaml  # One mission for entire 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;&lt;strong&gt;Problem&lt;/strong&gt;: Real projects need different approaches for different pieces of work:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Mission A is new software development&lt;/li&gt;
&lt;li&gt;Mission B is researching which library to use&lt;/li&gt;
&lt;li&gt;Mission C is writing user documentation&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;after-080-per-mission-mission-type&quot;&gt;After 0.8.0: Per-Mission Mission Type&lt;/h3&gt;
&lt;p&gt;Now the mission type is selected per mission:&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;kitty-specs/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;010-auth-system/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;    &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;meta.json  # mission: &quot;software-dev&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;011-library-comparison/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;    &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;meta.json  # mission: &quot;research&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;012-user-docs/&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 class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;    &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;meta.json  # mission: &quot;documentation&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Benefits&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Choose the right workflow for each task&lt;/li&gt;
&lt;li&gt;Same project can have software, research, and documentation missions&lt;/li&gt;
&lt;li&gt;No need to reconfigure between different types of work&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;how-missions-affect-agent-behavior&quot;&gt;How Missions Affect Agent Behavior&lt;/h2&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;agent_context&lt;/code&gt; field in each mission provides instructions that shape agent behavior:&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Software Dev agent&lt;/strong&gt;:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;You are a software development agent following TDD practices. Tests before code (non-negotiable).&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;Research agent&lt;/strong&gt;:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;You are a research agent conducting systematic literature reviews. Document ALL sources.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;Documentation agent&lt;/strong&gt;:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;You are a documentation agent following Write the Docs best practices and Divio system.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;These instructions guide AI agents to behave appropriately for the domain.&lt;/p&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See Also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/spec-driven-development/&quot;&gt;Spec-Driven Development&lt;/a&gt; - The methodology missions implement&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/mission-type-resolution/&quot;&gt;Mission-Type Resolution&lt;/a&gt; - How per-mission-type behaviour resolves through the doctrine → charter → core seam&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/divio-documentation/&quot;&gt;Divio Documentation&lt;/a&gt; - The documentation system used by Documentation Kitty&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/kanban-workflow/&quot;&gt;Kanban Workflow&lt;/a&gt; - How work moves through lanes (applies to all missions)&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;This document explains why missions exist and how they differ. For how to select and use missions, see the tutorials and how-to guides.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;try-it&quot;&gt;Try It&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/claude-code-workflow/&quot;&gt;Claude Code Workflow&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;how-to-guides&quot;&gt;How-To Guides&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/install-spec-kitty/&quot;&gt;Install Spec Kitty&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;reference&quot;&gt;Reference&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/api/missions/&quot;&gt;Missions&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/slash-commands/&quot;&gt;Slash Commands&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
