ADR NNNN: <a class="headerlink" href="#adr-nnnn" title="Permanent link">¶</a></h1>
<h2 id="status">Status<a class="headerlink" href="#status" title="Permanent link">¶</a></h2>
<p><code>Proposed</code> | <code>Accepted</code> | <code>Superseded by ADR NNNN</code> — YYYY-MM-DD</p>
<h2 id="context">Context<a class="headerlink" href="#context" title="Permanent link">¶</a></h2>
<p>What situation, constraint or question forces a decision. State verified facts as facts; reference anything not yet verified by its spike ID in <code>OPEN_QUESTIONS.md</code> (S1–S14) instead of asserting it.</p>
<h2 id="decision">Decision<a class="headerlink" href="#decision" title="Permanent link">¶</a></h2>
<p>The decision, in the imperative. Include concrete values (versions, paths, config keys, signatures) so a later reader can check the code against the ADR.</p>
<h2 id="consequences">Consequences<a class="headerlink" href="#consequences" title="Permanent link">¶</a></h2>
<p>What becomes easier, what becomes harder, what must now be done elsewhere (settings keys, CI jobs, docs, follow-up tasks in <code>docs/ROADMAP.md</code>).</p>
<h2 id="alternatives-considered">Alternatives considered<a class="headerlink" href="#alternatives-considered" title="Permanent link">¶</a></h2>
<p>One bullet per rejected option: the option, and at least one concrete reason it was rejected.</p>
<hr />
<p>Conventions:</p>
<ul>
<li>File name <code>docs/adr/NNNN-<kebab-slug>.md</code>; numbers never reused.</li>
<li>An ADR is never edited after <code>Accepted</code> except to change its Status; a new ADR supersedes it.</li>
<li>Specs link ADRs as <code>docs/adr/NNNN-<slug>.md</code>.</li>
</ul>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" class="lucide lucide-circle-arrow-up" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10"/><path d="m16 12-4-4-4 4M12 16V8"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
© 2026 Gishant Singh. MIT licensed.
</div>
Made with
<a href="https://zensical.org/" target="_blank" rel="noopener">
Zensical
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"annotate":null,"base":"../..","features":["navigation.tabs","navigation.tabs.sticky","navigation.sections","navigation.indexes","navigation.path","navigation.top","toc.follow","content.code.copy"],"redirect":"../../redirect.json","search":"../../assets/javascripts/workers/search.7d14d953.min.js","tags":null,"translations":{"clipboard.copied":"Copied to clipboard","clipboard.copy":"Copy to clipboard","search.result.more.one":"1 more on this page","search.result.more.other":"# more on this page","search.result.none":"No matching documents","search.result.one":"1 matching document","search.result.other":"# matching documents","search.result.placeholder":"Type to start searching","search.result.term.missing":"Missing","select.version":"Select version"},"version":null}</script>
<script src="../../assets/javascripts/bundle.8dcc8e9c.min.js"></script>
</body>
</html>