<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/changelog/1x/orchestration-and-api/">
  <id>https://docs.spec-kitty.ai/changelog/1x/orchestration-and-api/</id>
  <title>1.x Orchestration and API Boundary</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/changelog/1x/orchestration-and-api/"/>
  <summary>Historical Spec Kitty 1.x archive page for 1.x Orchestration and API Boundary; use Spec Kitty 3.2 docs for current projects and upgrades.</summary>
  <content type="html">&lt;blockquote&gt;
&lt;p&gt;Archive notice: This page documents historical Spec Kitty behavior and is not the current 3.2 workflow. Start with &lt;a href=&quot;/context/&quot;&gt;Spec Kitty 3.2&lt;/a&gt; for current docs.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;span id=&quot;1x-orchestration-and-api-boundary&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt; uses a host/provider split for automated orchestration:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; owns workflow state and transition validation.&lt;/li&gt;
&lt;li&gt;External providers run orchestration loops.&lt;/li&gt;
&lt;li&gt;Providers integrate through &lt;code dir=&quot;auto&quot;&gt;spec-kitty orchestrator-api&lt;/code&gt; only.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;what-changed&quot;&gt;What changed&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty orchestrate&lt;/code&gt; is not part of the core CLI.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty orchestrator-api&lt;/code&gt; is the supported host contract.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty-orchestrator&lt;/code&gt; is the reference external provider.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;recommended-operator-flow&quot;&gt;Recommended operator flow&lt;/h2&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;orchestrator-api&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;contract-version&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-orchestrator&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;orchestrate&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;034-my-feature&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;--dry-run&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-orchestrator&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;orchestrate&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;034-my-feature&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;build-your-own-provider&quot;&gt;Build-your-own provider&lt;/h2&gt;
&lt;p&gt;Custom providers should:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Read ready work through &lt;code dir=&quot;auto&quot;&gt;list-ready&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;feature-state&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Start work through &lt;code dir=&quot;auto&quot;&gt;start-implementation&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Drive review loops with &lt;code dir=&quot;auto&quot;&gt;transition&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;start-review&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Finalize with &lt;code dir=&quot;auto&quot;&gt;accept-mission&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;merge-mission&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Do not mutate WP lane frontmatter directly from the provider process.&lt;/p&gt;
&lt;h2 id=&quot;references&quot;&gt;References&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/collaboration/run-external-orchestrator/&quot;&gt;Run External Orchestrator&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/collaboration/build-custom-orchestrator/&quot;&gt;Build Custom Orchestrator&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/orchestrator-api/&quot;&gt;Orchestrator API Reference&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;</content>
</entry>
