Publish architecture-as-code introduction with a one-page download

MANIFEST.md

@@ -42,6 +42,8 @@ admits future files.
 - `explainers/how-the-repository-works/how-the-repository-works.pdf`
 - `explainers/how-the-repository-works/index.html`
 - `explainers/index.html`
+- `explainers/what-is-architecture-as-code/index.html`
+- `explainers/what-is-architecture-as-code/what-is-architecture-as-code.pdf`
 - `favicon.ico`
 - `index.html`
 - `install/go/claude/index.html`

explainers/SHA256SUMS

@@ -1,2 +1,3 @@
 8ae367f04698355742ee093740ed148a5ebd9a139b80e161788215c2ff4098f0  how-a-document-prints/how-a-document-prints.pdf
 c694fa298d6279f00da62236956592de9207c4f62c5c4e318c5634015d1e901d  how-the-repository-works/how-the-repository-works.pdf
+22c60a38dad79e467ecef08103b0a121ed14d6f15d984a80ed6ab1fd9fb67866  what-is-architecture-as-code/what-is-architecture-as-code.pdf

explainers/index.html

@@ -56,12 +56,17 @@
   <main id="main" class="wrap" tabindex="-1">
     <div class="hero">
       <h1>Explainers</h1>
-      <p class="lede">One subject per page, in more depth than the front page goes. Read online — no PDF, no sign-up.</p>
+      <p class="lede">One subject per page, in more depth than the front page goes. Read online, with a one-page PDF where available. No sign-up.</p>
     </div>
 
     <section aria-labelledby="items-heading">
       <h2 id="items-heading">Explainers</h2>
       <div class="stack-grid">
+        <article class="card">
+          <h3>What is architecture-as-code?</h3>
+          <p>The problem, the approach and what remains with your team. Read online or take the one-page PDF.</p>
+          <a class="card-link" href="what-is-architecture-as-code/">Read it &rarr;</a>
+        </article>
         <article class="card">
           <h3>Governed access to your enterprise model</h3>
           <p>Repository MCP: who can see and change what, and how to choose a deployment and implementation path.</p>

explainers/what-is-architecture-as-code/index.html

@@ -0,0 +1,97 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>What is architecture-as-code? | Transitrix</title>
+  <meta name="description" content="A first introduction to architecture-as-code: the stale-copy problem, how a shared model works, and what remains with your team.">
+  <link rel="canonical" href="https://transitrix.com/explainers/what-is-architecture-as-code/">
+  <meta property="og:type" content="website">
+  <meta property="og:url" content="https://transitrix.com/explainers/what-is-architecture-as-code/">
+  <meta property="og:title" content="What is architecture-as-code? | Transitrix">
+  <meta property="og:description" content="A first introduction to architecture-as-code: the stale-copy problem, how a shared model works, and what remains with your team.">
+  <meta property="og:image" content="https://transitrix.com/assets/og/transitrix-og.png">
+  <meta property="og:image:width" content="1200">
+  <meta property="og:image:height" content="630">
+  <meta property="og:locale" content="en_US">
+  <meta property="og:locale:alternate" content="de_DE">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:image" content="https://transitrix.com/assets/og/transitrix-og.png">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400&family=IBM+Plex+Mono:wght@400&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="../../assets/css/style.css">
+  <link rel="icon" type="image/svg+xml" href="/assets/img/transitrix-icon.svg">
+  <link rel="icon" type="image/png" sizes="16x16" href="/assets/img/favicon-16.png">
+  <link rel="icon" type="image/png" sizes="32x32" href="/assets/img/favicon-32.png">
+  <link rel="icon" type="image/png" sizes="128x128" href="/assets/img/favicon-128.png">
+  <link rel="apple-touch-icon" sizes="256x256" href="/assets/img/apple-touch-icon.png">
+  <script>if(localStorage.getItem('theme')==='light')document.documentElement.setAttribute('data-theme','light');</script>
+  <!-- Cloudflare Web Analytics -->
+  <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "1d2971bbe7964ede92ee02e5c78da48c"}'></script>
+  <!-- End Cloudflare Web Analytics -->
+</head>
+<body>
+  <a class="skip-link" href="#main">Skip to main content</a>
+  <header class="site-header">
+    <div class="wrap">
+      <a class="logo" href="../../">Transitrix</a>
+      <div class="header-right">
+        <button class="theme-toggle" id="theme-toggle" aria-label="Toggle theme">
+          <svg class="icon-moon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+          <svg class="icon-sun" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>
+        </button>
+      </div>
+      <nav class="site-nav" aria-label="Primary">
+        <ul>
+          <li><a href="/learn/">Learn</a></li>
+          <li><a href="/dsl-examples/">Examples</a></li>
+          <li><a href="https://github.com/transitrix/methodology" target="_blank" rel="noopener noreferrer">Methodology</a></li>
+          <li><a href="/library/">Library</a></li>
+          <li><a href="/install/">Install &amp; start</a></li>
+        </ul>
+      </nav>
+    </div>
+  </header>
+  <main id="main" class="wrap" tabindex="-1">
+<h1>What is architecture-as-code?</h1>
+<p class="lede">You leave with a decision you can keep true.</p>
+<p>Not a report of one — the model the decision was made in, in your own repository, and the method to keep it current after we are gone.</p>
+<p><a class="btn" href="what-is-architecture-as-code.pdf" download>Download the one-page PDF</a></p>
+<div>
+<section><h2>The problem</h2>
+<p>A system is retired. A diagram still shows it. A process changes. The document does not.</p>
+<p>The same facts live in separate diagrams, documents and spreadsheets. Before a decision can use them, someone has to work out which copies are still true.</p>
+<p>The work changes: people maintain the shared description and review changes, rather than reconcile separate copies.</p>
+</section>
+<section><h2>How it works</h2><div>
+<div><div><h3>Describe the organisation once</h3><p>Plain-text files name goals, processes, systems, owners and their relationships. Together, these records form the model.</p></div></div>
+<div><div><h3>Generate what you need to see</h3><p>Diagrams and reports show selected parts of that model. They are produced from the same records instead of being edited as separate copies.</p></div></div>
+<div><div><h3>Review and check each change</h3><p>A repository keeps the files and their history. Proposed changes are reviewed; automatic checks flag broken rules and references.</p></div></div>
+</div></section>
+<section><h2>What stays with you</h2>
+<p><strong>A description you can inspect</strong> Your team can read the records, see their history and propose the next change.</p>
+<p><strong>Connections you can follow</strong> Trace the recorded links from a system to the processes and goals that depend on it.</p>
+<p><strong>A way to keep it useful</strong> The model and review practice remain with your team after an engagement ends.</p>
+</section>
+</div>
+<section aria-labelledby="scope-heading"><h2 id="scope-heading">Architecture-as-Code for the enterprise</h2>
+<p>That is what <strong>Architecture-as-Code for the enterprise</strong> is for: the git-native, text-first discipline software already has, carried up to the strategy, business and architecture layers that code-scoped tools never reach. The enterprise is described once, in plain text, and every view — a goal tree, a capability map, a sequence diagram — is projected from that one description.</p>
+<div>
+<p><strong>Against code-scoped tools.</strong> Architecture-as-Code exists today and stops at software. The layers where the money is committed — motivation, strategy, business — are the ones it never reaches, and they are the ones this covers.</p>
+<p><strong>Against context and memory layers.</strong> This is a formal model, not free-form notes and not opaque embeddings. It validates, it diffs, and a change to it is reviewed the way a change to code is reviewed. A machine can act on it because it is grounded, not because it was remembered.</p>
+</div></section>
+
+</main>
+  <footer class="site-footer">
+    <div class="wrap footer-inner">
+      <p>
+        <a href="https://github.com/transitrix">github.com/transitrix</a> ·
+        <a href="https://x.com/transitrix">@transitrix</a> ·
+        <a href="https://korobeinikov.consulting">korobeinikov.consulting</a>
+      </p>
+    </div>
+  </footer>
+  <script src="../../assets/js/theme.js"></script>
+</body>
+</html>

sitemap.xml

@@ -37,6 +37,10 @@
     <loc>https://transitrix.com/explainers/how-the-repository-works/</loc>
     <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/explainers/how-the-repository-works/"/>
   </url>
+  <url>
+    <loc>https://transitrix.com/explainers/what-is-architecture-as-code/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/explainers/what-is-architecture-as-code/"/>
+  </url>
   <url>
     <loc>https://transitrix.com/install/</loc>
     <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/install/"/>