<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/ai-agent-architecture/">
  <id>https://docs.spec-kitty.ai/architecture/ai-agent-architecture/</id>
  <title>AI Agent Architecture Explained</title>
  <updated>2026-10-21T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/ai-agent-architecture/"/>
  <summary>How Spec Kitty stays agent-agnostic: slash commands and Agent Skills rendered from one shared command-template source, per agent format, driving the same lane workflow.</summary>
  <content type="html">&lt;span id=&quot;ai-agent-architecture-explained&quot;&gt;&lt;/span&gt;
&lt;p&gt;Spec Kitty supports 17 AI agents (13 slash-command agents and 4 Agent Skills agents), allowing teams to use their preferred tools. This document explains how the multi-agent system works and why it’s designed this way.&lt;/p&gt;
&lt;h2 id=&quot;how-slash-commands-work&quot;&gt;How Slash Commands Work&lt;/h2&gt;
&lt;p&gt;Slash commands (like &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt;) are a convention for invoking predefined workflows:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;User types&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.specify&lt;/code&gt; in their AI agent&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent reads&lt;/strong&gt; the corresponding command file (e.g., &lt;code dir=&quot;auto&quot;&gt;.claude/commands/spec-kitty.specify.md&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent executes&lt;/strong&gt; the instructions in that file&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent interacts&lt;/strong&gt; with the user and codebase&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The command file contains:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A detailed prompt explaining what to do&lt;/li&gt;
&lt;li&gt;Instructions for user interaction&lt;/li&gt;
&lt;li&gt;References to templates and artifacts&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;This lets each AI agent execute the same workflow, even though they have different interfaces.&lt;/p&gt;
&lt;h2 id=&quot;the-supported-agents&quot;&gt;The Supported Agents&lt;/h2&gt;
&lt;p&gt;Spec Kitty supports agents in three groups. The canonical lists are &lt;code dir=&quot;auto&quot;&gt;AI_CHOICES&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;IDE_AGENTS&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/core/config.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;AGENT_DIRS&lt;/code&gt; in
&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/agent_utils/directories.py&lt;/code&gt;; if this page and those lists disagree,
the code wins.&lt;/p&gt;
&lt;h3 id=&quot;cli-slash-command-agents&quot;&gt;CLI slash-command agents&lt;/h3&gt;
&lt;p&gt;These agents run from the command line and read a per-agent command directory:&lt;/p&gt;



























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Agent&lt;/th&gt;&lt;th&gt;Directory&lt;/th&gt;&lt;th&gt;Format&lt;/th&gt;&lt;th&gt;CLI Tool&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Claude Code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Gemini CLI&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.gemini/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;TOML&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;gemini&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Qwen Code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.qwen/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;TOML&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;qwen&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;OpenCode&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.opencode/command/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;opencode&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Augment Code (Auggie CLI)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.augment/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;auggie&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Amazon Q Developer CLI (legacy; use Kiro)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.amazonq/prompts/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;q&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Kiro CLI&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kiro/prompts/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;kiro-cli&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;LLxprt Code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.llxprt/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;TOML&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;llxprt&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;ide-slash-command-agents&quot;&gt;IDE slash-command agents&lt;/h3&gt;
&lt;p&gt;These agents run inside an IDE or editor, so Spec Kitty does not check for a CLI tool:&lt;/p&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Agent&lt;/th&gt;&lt;th&gt;Directory&lt;/th&gt;&lt;th&gt;Format&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;GitHub Copilot&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.github/prompts/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Cursor&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.cursor/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Windsurf&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.windsurf/workflows/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Kilo Code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kilocode/workflows/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Markdown&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;agent-skills-agents&quot;&gt;Agent Skills agents&lt;/h3&gt;
&lt;p&gt;These agents share one skills root, &lt;code dir=&quot;auto&quot;&gt;.agents/skills/spec-kitty-&amp;#x3C;command&gt;/SKILL.md&lt;/code&gt;,
tracked in &lt;code dir=&quot;auto&quot;&gt;.kittify/command-skills-manifest.json&lt;/code&gt;:&lt;/p&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Agent&lt;/th&gt;&lt;th&gt;How commands are invoked&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Codex CLI&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;$spec-kitty-&amp;#x3C;command&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Mistral Vibe&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty-&amp;#x3C;command&gt;&lt;/code&gt; (via &lt;code dir=&quot;auto&quot;&gt;.vibe/config.toml&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Pi&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/skill:spec-kitty-&amp;#x3C;command&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Letta Code&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty-&amp;#x3C;command&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Google Antigravity&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;/spec-kitty-&amp;#x3C;command&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;agent-specific-directories&quot;&gt;Agent-Specific Directories&lt;/h2&gt;
&lt;p&gt;Each agent has its own directory containing command files:&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;project/&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;├── .claude/&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;│   └── commands/&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.specify.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│       ├── spec-kitty.plan.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│       ├── spec-kitty.tasks.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│       ├── spec-kitty.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;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│       ├── spec-kitty.review.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│       └── spec-kitty.accept.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 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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;├── .gemini/&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;│   └── commands/&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;│       └── [same commands in TOML format]&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;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;├── .github/&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;│   └── prompts/&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;│       └── [same commands for Copilot]&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;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;└── ... (the other slash-command agent directories, plus .agents/skills/)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Each directory follows the conventions expected by that agent.&lt;/p&gt;
&lt;h2 id=&quot;command-template-system&quot;&gt;Command Template System&lt;/h2&gt;
&lt;h3 id=&quot;shared-logic-different-formats&quot;&gt;Shared Logic, Different Formats&lt;/h3&gt;
&lt;p&gt;All agents execute the same workflow, but their command file formats differ. Spec Kitty maintains a single source of truth:&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;packs/built-in/missions/mission-steps/&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;└── 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;├── specify/prompt.md      # Template content&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/prompt.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;├── tasks/prompt.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;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;During &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt;, these templates are adapted for each agent:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Markdown agents&lt;/strong&gt; get &lt;code dir=&quot;auto&quot;&gt;.md&lt;/code&gt; files&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;TOML agents&lt;/strong&gt; get &lt;code dir=&quot;auto&quot;&gt;.toml&lt;/code&gt; files with converted syntax&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent Skills agents&lt;/strong&gt; get a &lt;code dir=&quot;auto&quot;&gt;SKILL.md&lt;/code&gt; per command under &lt;code dir=&quot;auto&quot;&gt;.agents/skills/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Different arg syntax&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;$ARGUMENTS&lt;/code&gt; vs &lt;code dir=&quot;auto&quot;&gt;{{args}}&lt;/code&gt;) is handled per agent&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;template-structure&quot;&gt;Template Structure&lt;/h3&gt;
&lt;p&gt;Each command template contains:&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;markdown&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:#82B1FF;--1:#3B61B0&quot;&gt;# /spec-kitty.specify - Create Mission Specification&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:#C5E478;--1:#3B61B0&quot;&gt;**&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--0fw:bold;--1:#3B61B0;--1fw:bold&quot;&gt;Purpose&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;**&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [What this command does]&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:#82B1FF;--1:#3B61B0&quot;&gt;## When to Use&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;[Guidance on when to run this command]&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:#82B1FF;--1:#3B61B0&quot;&gt;## Workflow&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;[Step-by-step instructions for the agent]&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:#82B1FF;--1:#3B61B0&quot;&gt;## Outputs&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;[What artifacts will be created]&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:#82B1FF;--1:#3B61B0&quot;&gt;## Example&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;[Example usage and expected result]&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;keeping-templates-in-sync&quot;&gt;Keeping Templates in Sync&lt;/h3&gt;
&lt;p&gt;When you upgrade Spec Kitty (&lt;code dir=&quot;auto&quot;&gt;pipx upgrade --pip-args=--pre spec-kitty-cli&lt;/code&gt;, or the equivalent
command for your installer), migrations update all agent directories:&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;python&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;# Example migration: only the agents configured in .kittify/config.yaml&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:#C792EA;--1:#8844AE&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; agent_root, subdir &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#B2CCD6;--1:#096E72&quot;&gt;get_agent_dirs_for_project&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;project_path&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;agent_dir &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; project_path &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; agent_root &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; subdir&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:#C792EA;--1:#8844AE&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;not&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; agent_dir.&lt;/span&gt;&lt;span style=&quot;--0:#B2CCD6;--1:#096E72&quot;&gt;exists&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:#C792EA;--1:#8844AE&quot;&gt;continue&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# respect deletions; never mkdir&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:#B2CCD6;--1:#096E72&quot;&gt;update_command_template&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;agent_dir&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&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;specify.md&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt; new_content&lt;/span&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;This ensures all agents stay synchronized when the workflow changes.&lt;/p&gt;
&lt;h2 id=&quot;multi-agent-collaboration&quot;&gt;Multi-Agent Collaboration&lt;/h2&gt;
&lt;h3 id=&quot;different-agents-on-different-wps&quot;&gt;Different Agents on Different WPs&lt;/h3&gt;
&lt;p&gt;The execution workspace model enables multi-agent collaboration:&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: 012-user-auth&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;├── Lane A (WP01, WP02 sequential) → Agent A (Claude Code) in .worktrees/012-user-auth-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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;├── Lane B (parallel API work)     → Agent B (Gemini) in .worktrees/012-user-auth-lane-b/&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;└── Lane C (parallel UI work)      → Agent C (Copilot) in .worktrees/012-user-auth-lane-c/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Each agent:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Works in its resolved execution workspace&lt;/li&gt;
&lt;li&gt;Has its own resolved branch&lt;/li&gt;
&lt;li&gt;Uses the same command templates&lt;/li&gt;
&lt;li&gt;Follows the same workflow&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;why-this-works&quot;&gt;Why This Works&lt;/h3&gt;
&lt;p&gt;All agents:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Read the same WP prompt from &lt;code dir=&quot;auto&quot;&gt;tasks/WP##.md&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Follow the same implementation workflow&lt;/li&gt;
&lt;li&gt;Use the same lane transitions (planned → claimed → in_progress → for_review)&lt;/li&gt;
&lt;li&gt;Produce compatible output (code + commits)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The only difference is which AI model powers each agent.&lt;/p&gt;
&lt;h3 id=&quot;orchestration&quot;&gt;Orchestration&lt;/h3&gt;
&lt;p&gt;You can run multiple agents simultaneously:&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;# Terminal 1 (Claude Code)&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:#C5E478;--1:#3B61B0&quot;&gt;cd&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;.worktrees/012-user-auth-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 style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;claude&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;/spec-kitty.implement WP01&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;# Terminal 2 (Gemini)&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:#C5E478;--1:#3B61B0&quot;&gt;cd&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;.worktrees/012-user-auth-lane-b&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;gemini&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;/spec-kitty.implement WP02&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;# Terminal 3 (opencode)&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:#C5E478;--1:#3B61B0&quot;&gt;cd&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;.worktrees/012-user-auth-lane-c&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;opencode&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;/spec-kitty.implement WP03&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&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;All three work in parallel without conflicts.&lt;/p&gt;
&lt;h2 id=&quot;why-agent-agnostic&quot;&gt;Why Agent-Agnostic?&lt;/h2&gt;
&lt;h3 id=&quot;user-choice&quot;&gt;User Choice&lt;/h3&gt;
&lt;p&gt;Different users prefer different agents:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Some teams use Claude Code for its reasoning&lt;/li&gt;
&lt;li&gt;Some prefer Copilot for IDE integration&lt;/li&gt;
&lt;li&gt;Some use Gemini for its context handling&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Spec Kitty doesn’t force a choice—use what works for you.&lt;/p&gt;
&lt;h3 id=&quot;vendor-independence&quot;&gt;Vendor Independence&lt;/h3&gt;
&lt;p&gt;AI agents evolve rapidly:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;New agents appear regularly&lt;/li&gt;
&lt;li&gt;Existing agents gain new capabilities&lt;/li&gt;
&lt;li&gt;Pricing and availability change&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;By supporting multiple agents, Spec Kitty isn’t locked to any single vendor.&lt;/p&gt;
&lt;h3 id=&quot;team-flexibility&quot;&gt;Team Flexibility&lt;/h3&gt;
&lt;p&gt;A team might use different agents for different tasks:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Claude Code for complex implementation work&lt;/li&gt;
&lt;li&gt;Copilot for quick edits and reviews&lt;/li&gt;
&lt;li&gt;Gemini for research tasks&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Spec Kitty’s workflows work the same regardless of which agent runs them.&lt;/p&gt;
&lt;h2 id=&quot;adding-new-agent-support&quot;&gt;Adding New Agent Support&lt;/h2&gt;
&lt;p&gt;When a new AI agent appears, Spec Kitty can add support by:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Adding to &lt;code dir=&quot;auto&quot;&gt;AI_CHOICES&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;AGENT_DIRS&lt;/code&gt;&lt;/strong&gt;: Update the canonical lists&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Creating directory structure&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;.&amp;#x3C;agent&gt;/commands/&lt;/code&gt; (or agent-specific path)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Converting templates&lt;/strong&gt;: Generate command files in the agent’s format&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Adding CLI checks&lt;/strong&gt;: Verify the agent’s CLI tool is installed (if CLI-based)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;See &lt;a href=&quot;/api/agent-subcommands/&quot;&gt;Agent Subcommands&lt;/a&gt; for the workflow command reference.&lt;/p&gt;
&lt;h2 id=&quot;command-execution-flow&quot;&gt;Command Execution Flow&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;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;User: /spec-kitty.implement WP01&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 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;/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;Agent reads .claude/commands/spec-kitty.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 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;/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;Agent executes workflow:&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;1. Read WP01 prompt from tasks/WP01.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 style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;2. Resolve or create the execution workspace&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;3. Navigate to the printed workspace&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;4. Implement according to WP requirements&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;5. Run tests&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;6. Commit changes&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;7. Move WP to for_review&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 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;/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;Result: WP01 implemented in the canonical execution workspace&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 file provides all instructions; the agent executes them.&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/execution-lanes/&quot;&gt;Execution Workspace Model&lt;/a&gt; - How parallel development enables multi-agent collaboration&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 regardless of agent&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/mission-system/&quot;&gt;Mission System&lt;/a&gt; - How missions customize commands for different work types&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;This document explains the multi-agent architecture. For how to use specific agents, 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-integration/&quot;&gt;Claude Code Integration&lt;/a&gt;&lt;/li&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/non-interactive-init/&quot;&gt;Non-Interactive Init&lt;/a&gt;&lt;/li&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/supported-agents/&quot;&gt;Supported Agents&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/agent-subcommands/&quot;&gt;Agent Subcommands&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
