<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/vision/">
  <id>https://docs.spec-kitty.ai/architecture/vision/</id>
  <title>Architecture Vision (living)</title>
  <updated>2026-10-03T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/vision/"/>
  <summary>Landing page for the living architecture vision: the current and future, still-changeable forward intent for Spec Kitty, above the per-era history slots.</summary>
  <content type="html">&lt;span id=&quot;architecture-vision-living&quot;&gt;&lt;/span&gt;
&lt;p&gt;This directory holds the &lt;strong&gt;current and future&lt;/strong&gt; architecture vision for Spec Kitty —
forward intent that may still change. It is one of the living architecture surfaces
(see &lt;a href=&quot;/architecture/&quot;&gt;architecture index&lt;/a&gt; for the boundary and decay rules).&lt;/p&gt;
&lt;h2 id=&quot;what-belongs-here&quot;&gt;What belongs here&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The synthesized “where the architecture is going” narrative for the active era.&lt;/li&gt;
&lt;li&gt;Forward-looking structural intent that has not yet been ratified as an ADR.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;what-does-not-belong-here&quot;&gt;What does NOT belong here&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Ratified decisions&lt;/strong&gt; — those are ADRs under &lt;code dir=&quot;auto&quot;&gt;docs/adr/&amp;#x3C;era&gt;/&lt;/code&gt; (immutable, era-stamped).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Explorations / spikes&lt;/strong&gt; — those are research notes under &lt;code dir=&quot;auto&quot;&gt;docs/plans/research/&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Historical vision&lt;/strong&gt; — when a vision statement is no longer current/future it is
&lt;em&gt;demoted&lt;/em&gt; into its era’s history slot, &lt;code dir=&quot;auto&quot;&gt;vision/README-&amp;#x3C;era&gt;.md&lt;/code&gt; (the decay path; nothing is deleted).&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;vision-vs-decision-vs-spike&quot;&gt;Vision vs Decision vs Spike&lt;/h2&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Artifact&lt;/th&gt;&lt;th&gt;Meaning&lt;/th&gt;&lt;th&gt;Home&lt;/th&gt;&lt;th&gt;Mutability&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Vision&lt;/td&gt;&lt;td&gt;Forward intent&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;docs/architecture/vision/&lt;/code&gt; (top-level, living)&lt;/td&gt;&lt;td&gt;May change&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Decision (ADR)&lt;/td&gt;&lt;td&gt;Ratified decision&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;docs/adr/&amp;#x3C;era&gt;/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Immutable, era-stamped&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Spike&lt;/td&gt;&lt;td&gt;Exploration&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;docs/plans/research/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Dated record&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;forward-signal-for-the-4x-line-2026-09-30&quot;&gt;Forward signal for the 4.x line (2026-09-30)&lt;/h2&gt;
&lt;p&gt;4.0.0 is the active cycle, at release-candidate stage. The authority for its intent is the
&lt;a href=&quot;/plans/4-0-0-milestone-roadmap/&quot;&gt;4.0.0 milestone roadmap&lt;/a&gt;; in architecture terms it
points at:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Hosted collaboration lives outside open-core.&lt;/strong&gt; The hosted client surfaces
(&lt;code dir=&quot;auto&quot;&gt;zeitgeist_client/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;saas_client/&lt;/code&gt;, hosted auth and the moment publisher) were removed from
open-core (#6164; the code is preserved in &lt;code dir=&quot;auto&quot;&gt;spec-kitty/event-router&lt;/code&gt;), and the retired sync
transport stays retired. See &lt;a href=&quot;/context/team-kitty/&quot;&gt;Team Kitty and Zeitgeist&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Structural finish.&lt;/strong&gt; One canonical event store stays the single source of lifecycle truth.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One governed front door.&lt;/strong&gt; A stable, versioned application API that the CLI, UI, MCP
and SDK consumers build against, rather than parallel ad-hoc surfaces.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Charter service strangler.&lt;/strong&gt; Move charter reads, then writes, behind the stable
boundary described by &lt;a href=&quot;/adr/4.x/2026-10-03-1-charter-read-write-service-strangler/&quot;&gt;ADR 2026-10-03-1&lt;/a&gt;
and the &lt;a href=&quot;/architecture/diagrams/&quot;&gt;living C4 model&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No new shadow paths.&lt;/strong&gt; Route or extract onto an existing authority; never build a
parallel one.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The 3.x-era forward signal (2026-08-12) was demoted to the &lt;a href=&quot;/architecture/vision/README-3.x/&quot;&gt;3.x history slot&lt;/a&gt;.&lt;/p&gt;</content>
</entry>
