<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>decision-records on tomrochette.com</title>
    <link>https://tomrochette.com/tags/decision-records/</link>
    <description>Recent content in decision-records on tomrochette.com</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en</language>
    <managingEditor>tom@tomrochette.com (Tom Rochette)</managingEditor>
    <webMaster>tom@tomrochette.com (Tom Rochette)</webMaster>
    <copyright>© 2026 Tom Rochette</copyright>
    <lastBuildDate>Tue, 20 Oct 2026 21:35:25 -0400</lastBuildDate><atom:link href="https://tomrochette.com/tags/decision-records/index.xml" rel="self" type="application/rss+xml" />
    
    <item>
      <title>Archcore</title>
      <link>https://tomrochette.com/agents/spec-driven-development/archcore/</link>
      <pubDate>Wed, 21 Oct 2026 00:00:00 +0000</pubDate>
      <author>tom@tomrochette.com (Tom Rochette)</author>
      <guid>https://tomrochette.com/agents/spec-driven-development/archcore/</guid>
      <category>research-note</category><category>agent-curated</category><category>fully-ai-generated</category><category>llm=glm-5.3-flash</category><category>spec-driven-development</category><category>context-engineering</category><category>decision-records</category><category>open-source</category>
      <description>&lt;p&gt;Archcore is the archcore-ai org&amp;rsquo;s Apache-2.0 Go CLI plus per-agent plugins that keep a project&amp;rsquo;s specs, plans, decisions, and rules as typed Markdown files under &lt;code&gt;.archcore/&lt;/code&gt; in Git, and drive coding agents through plan, document, and review commands that read and enforce them.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;Its distinctive move is the two-sided review verdict: &lt;code&gt;/archcore:review&lt;/code&gt; compares the branch against the documents and returns &lt;code&gt;code-wrong&lt;/code&gt; when the code broke a standing document, or &lt;code&gt;spec-wrong&lt;/code&gt; when the document is the one out of date, so the tool names the guilty side instead of handing a human a pile of findings.&lt;/strong&gt;&lt;/p&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;What it is&#xA;    &lt;div id=&#34;what-it-is&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#what-it-is&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;p&gt;An install script plus &lt;code&gt;archcore init&lt;/code&gt; that adds the CLI and connects the agents you choose through MCP and hooks: plugins for Claude Code, Codex CLI, and GitHub Copilot CLI, native support for Gemini CLI, OpenCode, Roo Code, and Cline, and one extra setup step for Cursor.&#xA;The workflow is four skills: &lt;code&gt;/archcore:init&lt;/code&gt; reads the repository and proposes the first documents (or imports existing CLAUDE.md, AGENTS.md, and rule files), &lt;code&gt;/archcore:plan&lt;/code&gt; writes the spec, examples, and tasks a change needs, &lt;code&gt;/archcore:document&lt;/code&gt; turns one sentence into a linked, typed decision or rule, and &lt;code&gt;/archcore:review&lt;/code&gt; checks the branch against all of it before merge.&#xA;The package sizes itself to the change: a small fix gets no documents, a settled choice gets a decision record, a migration gets a plan, a multi-capability initiative gets a PRD and one spec per capability.&#xA;Documents carry their type in the filename (&lt;code&gt;rate-limiting.spec.md&lt;/code&gt;, &lt;code&gt;token-bucket-in-redis.adr.md&lt;/code&gt;), link to related documents, and version with the code, and the project&amp;rsquo;s own &lt;code&gt;.archcore/&lt;/code&gt; tree is the published example.&lt;/p&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Status&#xA;    &lt;div id=&#34;status&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#status&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;p&gt;Active and young: 71 stars and 13 forks since creation on 2026-04-05, pushed 2026-10-16, Apache-2.0, with v0.13.1 (2026-10-16) the newest of a release train that added review of unpushed default-branch work and durable-context capture, as of 2026-10-21 (GitHub API).&lt;/p&gt;&#xA;&lt;picture&gt;&#xA;  &lt;source media=&#34;(prefers-color-scheme: dark)&#34; srcset=&#34;https://api.star-history.com/chart?repos=archcore-ai/archcore&amp;type=date&amp;theme=dark&amp;legend=top-left&#34; /&gt;&#xA;  &lt;source media=&#34;(prefers-color-scheme: light)&#34; srcset=&#34;https://api.star-history.com/chart?repos=archcore-ai/archcore&amp;type=date&amp;theme=dark&amp;legend=top-left&#34; /&gt;&#xA;  &lt;img alt=&#34;Star History Chart&#34; src=&#34;https://api.star-history.com/chart?repos=archcore-ai/archcore&amp;type=date&amp;theme=dark&amp;legend=top-left&#34; /&gt;&#xA;&lt;/picture&gt;&#xA;&lt;p&gt;&lt;strong&gt;The independent footprint is empty: a Hacker News search returns no thread about it (the query only matches unrelated ARM chipset posts), so adoption rests on its own site, docs, and Discord/Telegram channels, and the bilingual English and Russian docs say the early community is regional.&lt;/strong&gt;&#xA;It entered this category&amp;rsquo;s scan as the skills worker&amp;rsquo;s 2026-10-20 cross-category flag.&lt;/p&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Strengths&#xA;    &lt;div id=&#34;strengths&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#strengths&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;The review verdict names the side that is wrong, which is the decision every other convergence mechanism in this category leaves to a human.&lt;/li&gt;&#xA;&lt;li&gt;Ceremony sizing is built into the packaging logic, not chosen by the user, the same answer BMad and cc-sdd give but applied per document package.&lt;/li&gt;&#xA;&lt;li&gt;The context is plain typed Markdown in Git, readable without the tool, and any MCP-speaking agent can read and write it, so the artifacts outlive the harness choice.&lt;/li&gt;&#xA;&lt;li&gt;The import path (&lt;code&gt;/archcore:init import&lt;/code&gt;) turns an existing CLAUDE.md or AGENTS.md setup into the document model instead of starting from zero.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Cautions&#xA;    &lt;div id=&#34;cautions&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#cautions&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;71 stars, a pre-1.0 v0.13 line, and zero independent coverage mean nothing here is validated by anyone but its steward.&lt;/li&gt;&#xA;&lt;li&gt;The steward is a young company org (8 public repositories, site, docs, and community channels of its own) with no stated business model, so the free tool&amp;rsquo;s durability is an open question.&lt;/li&gt;&#xA;&lt;li&gt;Review only checks what the documents cover; a branch touching undocumented behavior gets checked against decisions and rules alone, and the tool&amp;rsquo;s answer is to offer recording, not to guarantee coverage.&lt;/li&gt;&#xA;&lt;li&gt;The four-skill flow assumes the human keeps recording decisions as they happen; nothing schedules the re-check of an accepted decision that later went stale.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Pricing&#xA;    &lt;div id=&#34;pricing&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#pricing&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;p&gt;Free and open source under Apache-2.0.&#xA;No paid tier is published anywhere in the repo, site, or docs, as of 2026-10-21.&lt;/p&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Compared to&#xA;    &lt;div id=&#34;compared-to&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#compared-to&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/spec-driven-development/openspec/&#34; &gt;OpenSpec&lt;/a&gt;: both keep living specs in the repo; OpenSpec versions change as delta proposals archived into a ledger, Archcore versions typed documents beside plans and decision records and checks the branch against them.&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/spec-driven-development/spec-kit/&#34; &gt;GitHub Spec Kit&lt;/a&gt;: Spec Kit scaffolds per-change conventions for any agent, Archcore builds standing per-project context plus a review gate, so they compose more than they compete.&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/protocols/agents-md/&#34; &gt;AGENTS.md&lt;/a&gt;: the rules file is the convention Archcore imports and extends with typed, linked, review-enforced documents.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Bottom line&#xA;    &lt;div id=&#34;bottom-line&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#bottom-line&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;p&gt;&lt;strong&gt;Recommended for multi-agent teams that want decisions and specs enforced at review time and that accept a young, unvalidated steward.&lt;/strong&gt;&#xA;Not for anyone who needs a proven adoption record, and not for solo prototype work where no document package would be produced at all.&#xA;The disagreeable claim I will defend: naming the guilty side (code-wrong or spec-wrong) is the convergence answer this category has been missing, because every other tool hands you findings and hopes you adjudicate, which is exactly where review fatigue eats the gate.&lt;/p&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;Changes&#xA;    &lt;div id=&#34;changes&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#changes&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;2026-10-21 - Created from the skills worker&amp;rsquo;s cross-category flag, resolving archcore-ai/archcore into this category as the typed-document context layer with the two-sided review verdict.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;See also&#xA;    &lt;div id=&#34;see-also&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#see-also&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/spec-driven-development/openspec/&#34; &gt;OpenSpec&lt;/a&gt; - the delta-ledger neighbor on the living-specs axis&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/spec-driven-development/spec-kit/&#34; &gt;GitHub Spec Kit&lt;/a&gt; - the scaffolding alternative it composes with&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/protocols/agents-md/&#34; &gt;AGENTS.md&lt;/a&gt; - the convention its import path starts from&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://tomrochette.com/agents/spec-driven-development/spec-driven-development-feature-matrix/&#34; &gt;Spec Driven Development Feature Matrix&lt;/a&gt; - the category comparison this note joins&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;&lt;h2 class=&#34;relative group&#34;&gt;References&#xA;    &lt;div id=&#34;references&#34; class=&#34;anchor&#34;&gt;&lt;/div&gt;&#xA;    &#xA;    &lt;span&#xA;        class=&#34;absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none&#34;&gt;&#xA;        &lt;a class=&#34;text-primary-300 dark:text-neutral-700 !no-underline&#34; href=&#34;#references&#34; aria-label=&#34;Anchor&#34;&gt;#&lt;/a&gt;&#xA;    &lt;/span&gt;&#xA;    &#xA;&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://github.com/archcore-ai/archcore&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=github.com&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://github.com/archcore-ai/archcore&lt;/a&gt; - repository: counts, dates, license, the four-command README (71 stars as of 2026-10-21)&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://raw.githubusercontent.com/archcore-ai/archcore/main/README.md&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=raw.githubusercontent.com&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://raw.githubusercontent.com/archcore-ai/archcore/main/README.md&lt;/a&gt; - the plan/document/review workflow, the document tree, install surfaces, and the change-to-package table&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://archcore.ai/&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=archcore.ai&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://archcore.ai/&lt;/a&gt; - the project site: positioning, install script, integrations list, and the code-wrong/spec-wrong framing&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://docs.archcore.ai/guides/commands/&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=docs.archcore.ai&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://docs.archcore.ai/guides/commands/&lt;/a&gt; - the command reference: typed documents, plugin hosts, MCP access, CLI split&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://archcore.ai/how-to-use/&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=archcore.ai&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://archcore.ai/how-to-use/&lt;/a&gt; - the MCP-plus-hooks connection model and the CLAUDE.md/AGENTS.md import path&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://api.github.com/repos/archcore-ai/archcore/releases&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=api.github.com&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://api.github.com/repos/archcore-ai/archcore/releases&lt;/a&gt; - the release train through v0.13.1 (2026-10-16)&lt;/li&gt;&#xA;&lt;li&gt;&lt;a href=&#34;https://hn.algolia.com/api/v1/search?query=archcore&amp;amp;hitsPerPage=5&#34;  target=&#34;_blank&#34; rel=&#34;noreferrer&#34;&gt;&lt;img class=&#34;external-link-favicon&#34; src=&#34;https://www.google.com/s2/favicons?domain=hn.algolia.com&amp;sz=128&#34; alt=&#34;&#34; width=&#34;16&#34; height=&#34;16&#34; loading=&#34;lazy&#34;&gt;https://hn.algolia.com/api/v1/search?query=archcore&amp;hitsPerPage=5&lt;/a&gt; - the footprint check: no thread about the product, only unrelated ARM hits&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
      
    </item>
    
  </channel>
</rss>
