<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/migrations/feature-flag-deprecation/">
  <id>https://docs.spec-kitty.ai/migrations/feature-flag-deprecation/</id>
  <title>Migration: --feature to --mission</title>
  <updated>2026-07-20T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/migrations/feature-flag-deprecation/"/>
  <summary>Migration from the --feature flag to --mission, deprecated in mission 077 and fully removed as of 3.2.3 (#1060): the timeline and the required call-site changes.</summary>
  <content type="html">&lt;blockquote&gt;
&lt;p&gt;Migration note: This page documents a migration path or historical transition. It is not the current 3.2 happy path.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;span id=&quot;migration---feature-to---mission&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Status&lt;/strong&gt;: Deprecated as of Mission &lt;code dir=&quot;auto&quot;&gt;077-mission-terminology-cleanup&lt;/code&gt;.
&lt;strong&gt;Full removal (3.2.3, #1060)&lt;/strong&gt;: the alias has been &lt;strong&gt;hard-removed from every
user-facing and internal/agent command&lt;/strong&gt;, including the eight commands that
previously kept it during the deprecation window (&lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;merge&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;context&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;lifecycle plan&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;lifecycle tasks&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;mission-type current&lt;/code&gt;) and the internal/agent command cluster (&lt;code dir=&quot;auto&quot;&gt;agent status/tasks/action/context/mission&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter lint&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;materialize&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;validate-encoding&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;validate-tasks&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;verify&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;verify-setup&lt;/code&gt;) removed
earlier in 3.2.x (#1060-A). &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; is no longer accepted anywhere —
passing it exits with code 2 and “No such option: —feature”.&lt;/p&gt;
&lt;h2 id=&quot;why-this-change&quot;&gt;Why This Change&lt;/h2&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; CLI flag has been replaced by &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; as the canonical
selector for tracked missions. This aligns the operator-facing CLI with the
canonical terminology boundary:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Mission Type&lt;/strong&gt; = reusable workflow blueprint (&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;)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Mission&lt;/strong&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;strong&gt;Mission Run&lt;/strong&gt; = runtime/session execution instance only&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; is no longer available anywhere, including the top-level commands
that kept it as a hidden deprecated alias during the migration window. All
first-party surfaces have moved to &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;what-changed&quot;&gt;What Changed&lt;/h2&gt;





















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Before&lt;/th&gt;&lt;th&gt;After&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-kitty mission current --feature 077-foo&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty mission current --mission 077-foo&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty next --feature 077-foo&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty next --mission 077-foo&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status --feature 077-foo&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status --mission 077-foo&lt;/code&gt; (the &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; form is now &lt;strong&gt;removed&lt;/strong&gt; — it errors)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; is rejected everywhere with “No such option: —feature” — there is
no remaining command where it resolves, warns, or is merely hidden from
&lt;code dir=&quot;auto&quot;&gt;--help&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;behavioral-changes&quot;&gt;Behavioral Changes&lt;/h2&gt;
&lt;p&gt;Any &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; occurrence, on any command, is now a parser error. The
command exits before selector resolution with exit code 2.&lt;/p&gt;
&lt;h2 id=&quot;how-to-migrate-scripts&quot;&gt;How to Migrate Scripts&lt;/h2&gt;
&lt;p&gt;Replace &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; with &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; anywhere you invoke &lt;code dir=&quot;auto&quot;&gt;spec-kitty&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;# Old&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;current&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;--feature&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;077-mission-terminology-cleanup&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;# New&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;current&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;077-mission-terminology-cleanup&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;For bulk shell-script migration:&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;find&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;.&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;-name&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;*.sh&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;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-o&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;-name&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;*.bash&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;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;xargs&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;sed&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;-i&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;&apos;&apos;&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;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;s/--feature /--mission /g&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Review the diff before committing. A blind replacement can catch unrelated tools
or documentation.&lt;/p&gt;
&lt;h2 id=&quot;suppressing-the-warning-during-cutover-historical&quot;&gt;Suppressing the Warning During Cutover (historical)&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_SUPPRESS_FEATURE_DEPRECATION&lt;/code&gt; was used to silence the deprecation
warning during the alias window. Now that &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; is fully removed
(3.2.3, #1060), the variable is &lt;strong&gt;inert&lt;/strong&gt; — it is accepted but has no effect, since
there is no warning left to suppress. See
&lt;a href=&quot;/api/environment-variables/&quot;&gt;Environment Variables&lt;/a&gt; for the current
state.&lt;/p&gt;
&lt;h2 id=&quot;removal-complete&quot;&gt;Removal (complete)&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; was removed everywhere in 3.2.3 (#1060). This section previously
listed forward-looking removal criteria; they are retained here only for
historical record of what gated the removal:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;First-party doctrine skills, examples, and user-facing docs teach &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; only.&lt;/li&gt;
&lt;li&gt;First-party machine-facing surfaces completed Scope B alignment.&lt;/li&gt;
&lt;li&gt;A documented audit window showed zero first-party legacy &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; usage in active CI and shipped scripts.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;references&quot;&gt;References&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/kitty-specs/077-mission-terminology-cleanup/spec.md&quot;&gt;Mission spec&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/docs/adr/3.x/2026-04-04-2-mission-type-mission-and-mission-run-terminology-boundary.md&quot;&gt;Mission Type / Mission / Mission Run Terminology Boundary ADR&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/docs/archive/plans/initiatives/2026-04-mission-nomenclature-reconciliation/README.md&quot;&gt;Mission Nomenclature Reconciliation initiative&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/Priivacy-ai/spec-kitty/issues/241&quot;&gt;Tracking issue #241&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
