<?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/harnesses/claude-code/">
  <id>https://docs.spec-kitty.ai/guides/how-to/harnesses/claude-code/</id>
  <title>Use Spec Kitty in Claude Code</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/harnesses/claude-code/"/>
  <summary>How to use Spec Kitty in Claude Code, the first-class integration-tested reference harness: prerequisites, command install, and the slash-command workflow.</summary>
  <content type="html">&lt;span id=&quot;use-spec-kitty-in-claude-code&quot;&gt;&lt;/span&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Tier:&lt;/strong&gt; first_class — reference harness, integration-tested.
&lt;strong&gt;Citation (accessed 2026-05-21):&lt;/strong&gt; &lt;a href=&quot;https://docs.claude.com/en/docs/claude-code/overview&quot;&gt;https://docs.claude.com/en/docs/claude-code/overview&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Spec Kitty CLI installed.&lt;/strong&gt; See &lt;a href=&quot;/guides/how-to/installation/install-spec-kitty/&quot;&gt;Install Spec Kitty&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project initialized for this harness:&lt;/strong&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;init&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;--ai&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;claude&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Claude Code installed and signed in.&lt;/strong&gt; Follow the &lt;a href=&quot;https://docs.claude.com/en/docs/claude-code/overview&quot;&gt;Claude Code overview&lt;/a&gt; for installation and authentication.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;where-spec-kitty-installs-files&quot;&gt;Where Spec Kitty installs files&lt;/h2&gt;
&lt;p&gt;Per the &lt;a href=&quot;/api/supported-harnesses/&quot;&gt;supported-harnesses matrix&lt;/a&gt;, Claude Code uses the slash-command mechanism. Spec Kitty installs:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Directory:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Files:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;spec-kitty.specify.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.plan.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.tasks.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.implement.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.review.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.accept.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.merge.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.status.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.charter.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.analyze.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty.research.md&lt;/code&gt;, plus the &lt;code dir=&quot;auto&quot;&gt;spec-kitty.tasks-*&lt;/code&gt; helpers.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Each file is a Claude Code slash-command definition; the agent surfaces them as &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.&amp;#x3C;command&gt;&lt;/code&gt; in chat.&lt;/p&gt;
&lt;h2 id=&quot;canonical-invocation&quot;&gt;Canonical invocation&lt;/h2&gt;
&lt;p&gt;Slash-command syntax inside the Claude Code TUI:&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;/spec-kitty.specify &quot;&amp;#x3C;one-line mission description&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;/spec-kitty.plan&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;/spec-kitty.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.implement WP01&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 command name is the filename stem under &lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt;. Arguments after the command name are forwarded as a single string.&lt;/p&gt;
&lt;h2 id=&quot;worked-example&quot;&gt;Worked example&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;From your project root, start Claude Code (&lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;In the chat, type:
&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;/spec-kitty.specify &quot;a hello world page&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;Spec Kitty’s interview prompts appear — answer them inside the chat.&lt;/li&gt;
&lt;li&gt;When asked for a kebab-case slug, supply something short, e.g. &lt;code dir=&quot;auto&quot;&gt;hello-world-page&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The mission spec lands at &lt;code dir=&quot;auto&quot;&gt;kitty-specs/hello-world-page-&amp;#x3C;mid8&gt;/spec.md&lt;/code&gt; and the kanban moves the mission into the &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; lane.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty.*&lt;/code&gt; commands do not show in Claude Code.&lt;/strong&gt;
Run &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent config sync&lt;/code&gt; from the repo root. This rewrites &lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt; from the canonical source templates (see &lt;code dir=&quot;auto&quot;&gt;CLAUDE.md&lt;/code&gt;, “Template Source Location”). Restart Claude Code afterwards.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Profile not loading (researcher / reviewer roles do not adopt).&lt;/strong&gt;
Inside Claude Code, run:&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;/spk-charter-profile-load researcher-robbie&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Replace the profile id with the one named in the work-package frontmatter (&lt;code dir=&quot;auto&quot;&gt;agent_profile:&lt;/code&gt;).&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;where-to-learn-more-about-claude-code&quot;&gt;Where to learn more about Claude Code&lt;/h2&gt;
&lt;p&gt;Authoritative documentation: &lt;a href=&quot;https://docs.claude.com/en/docs/claude-code/overview&quot;&gt;https://docs.claude.com/en/docs/claude-code/overview&lt;/a&gt; (accessed 2026-05-21).&lt;/p&gt;</content>
</entry>
