<?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/create-specification/">
  <id>https://docs.spec-kitty.ai/guides/how-to/missions/create-specification/</id>
  <title>How to Create a Feature Specification</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/create-specification/"/>
  <summary>How to create a feature specification with Spec Kitty 3.2: Use this guide to capture a new feature specification with /spec-kitty.specify.</summary>
  <content type="html">&lt;span id=&quot;how-to-create-a-feature-specification&quot;&gt;&lt;/span&gt;
&lt;p&gt;Use this guide to capture a new feature specification with &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;when-to-use&quot;&gt;When to Use&lt;/h2&gt;
&lt;p&gt;Run this when you are starting a brand-new feature and need a spec before planning or implementation.&lt;/p&gt;
&lt;h2 id=&quot;the-command&quot;&gt;The Command&lt;/h2&gt;
&lt;p&gt;In your agent:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.specify &amp;#x3C;description&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;Run it from the repository root checkout. Planning artifacts are created in &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&lt;/code&gt; on the mission’s target branch, and no worktrees are created during specify. If you do not pass &lt;code dir=&quot;auto&quot;&gt;--target-branch&lt;/code&gt;, Spec Kitty uses the current branch.&lt;/p&gt;
&lt;p&gt;When you run the direct CLI form (&lt;code dir=&quot;auto&quot;&gt;spec-kitty specify &amp;#x3C;description&gt;&lt;/code&gt;), it creates the mission scaffold and marks the result as scaffold-only. Fill &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; with the complete specification before running &lt;code dir=&quot;auto&quot;&gt;spec-kitty plan --mission &amp;#x3C;mission&gt;&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;the-discovery-interview&quot;&gt;The Discovery Interview&lt;/h2&gt;
&lt;p&gt;After the command, the CLI interviews you for missing details. You must answer each question before the spec is generated. Expect the agent to respond with &lt;code dir=&quot;auto&quot;&gt;WAITING_FOR_DISCOVERY_INPUT&lt;/code&gt; until the interview is complete.&lt;/p&gt;
&lt;h2 id=&quot;what-gets-created&quot;&gt;What Gets Created&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/###-feature/spec.md&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/###-feature/meta.json&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/###-feature/checklists/requirements.md&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;example&quot;&gt;Example&lt;/h2&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.specify Build a photo organizer that groups albums by date and supports drag-and-drop reordering.&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;During discovery, answer follow-up questions (roles, constraints, success criteria). Once complete, write the specification content to &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;feature&gt;/spec.md&lt;/code&gt; on the mission’s target branch.&lt;/p&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Stuck on discovery&lt;/strong&gt;: Answer the remaining interview questions. The spec will not be created until the interview is complete.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Wrong directory&lt;/strong&gt;: Run from the repository root checkout, not from a worktree.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Wrong landing branch&lt;/strong&gt;: Check &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent mission branch-context --json&lt;/code&gt; before creating the mission, or pass &lt;code dir=&quot;auto&quot;&gt;--target-branch &amp;#x3C;branch&gt;&lt;/code&gt; explicitly.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Need to revise the spec&lt;/strong&gt;: Re-run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt; with the updated description and follow the interview again.&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/slash-commands/&quot;&gt;Slash Commands&lt;/a&gt; - All &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.*&lt;/code&gt; commands&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/cli-commands/&quot;&gt;CLI Commands&lt;/a&gt; - Full CLI reference&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-plan/&quot;&gt;Create a Plan&lt;/a&gt; - Next step after specification&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/keep-main-clean/&quot;&gt;Keep Main Clean&lt;/a&gt; - Choose a target branch without changing planning location&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/missions/switch-missions/&quot;&gt;Switch Missions&lt;/a&gt; - Choose different mission types&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/spec-driven-development/&quot;&gt;Spec-Driven Development&lt;/a&gt; - Why specs come first&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/mission-system/&quot;&gt;Mission System&lt;/a&gt; - How missions affect specifications&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/getting-started/&quot;&gt;Getting Started Tutorial&lt;/a&gt; - Hands-on introduction&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/tutorials/your-first-mission/&quot;&gt;Your First Mission&lt;/a&gt; - Complete workflow walkthrough&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
