Handbook
<Title> — Technical directive
Copy into project docs/ or sdlc/ per team layout. Governs implementation standards — stack, libraries, patterns, repo conventions. If the change is a significant design fork, add an ADR and keep this file focused on…
Template
Template — Copy this file into your project and fill in the sections. Do not edit the blueprint original.
— Technical directive</h1>
<p><strong>Copy</strong> into project <code>docs/</code> or <code>sdlc/</code> per team layout. Governs <strong>implementation standards</strong> — stack, libraries, patterns, repo conventions. If the change is a <strong>significant design fork</strong>, add an <strong>ADR</strong> and keep this file focused on <strong>day-to-day enforcement</strong>; link the ADR rather than duplicating architecture narrative.</p>
<h2 id="why--for-what">Why / For what</h2>
<ul>
<li><strong>Why:</strong> <engineering or quality forcing function — cite Retro Record or DCP></li>
<li><strong>For what:</strong> <consistency outcome for implementation and review></li>
</ul>
<h2 id="rules">Rules</h2>
<p><imperative technical rules></p>
<h2 id="link-to-adr-if-any">Link to ADR (if any)</h2>
<ul>
<li><strong>ADR:</strong> <code><path></code> — context and consequences</li>
<li><strong>This directive covers:</strong> <operational detail not duplicated in the ADR></li>
</ul>
<h2 id="evidence-of-adoption">Evidence of adoption</h2>
<ul>
<li><strong>Source:</strong> <Retro Record / DCP id></li>
<li><strong>Approved:</strong> <YYYY-MM-DD> <approvers></li>
</ul>
<h2 id="scope">Scope</h2>
<ul>
<li><strong>Applies to:</strong> <services, repos, environments></li>
<li><strong>Exceptions:</strong> …</li>
</ul>
<h2 id="review">Review</h2>
<ul>
<li><strong>Next review:</strong> <date or trigger></li>
<li><strong>Owner:</strong> <name / role — typically tech lead></li>
</ul>
<h2 id="related">Related</h2>
<ul>
<li><other directives, linters, runbooks></li>
</ul><section class="handbook-related mt-5 pt-4" style="border-top:1px solid var(--forge-border)" aria-labelledby="handbook-related-heading"><h2 id="handbook-related-heading" class="h6 font-display mb-3">Related pages</h2><ul class="mb-0 list-unstyled"><li class="mb-1"><a href="sdlc--templates-forge-readme.template.html">Forge workspace</a></li><li class="mb-1"><a href="sdlc--templates-forge-assay-gate.template.html">Assay Gate — {Product Spark name}</a></li><li class="mb-1"><a href="sdlc--templates-forge-charge.template.html">Charge — YYYY-MM-DD</a></li><li class="mb-1"><a href="sdlc--templates-forge-directive-change-proposal.template.html">Directive Change Proposal — DCP-<YYYYMMDD>…</a></li><li class="mb-1"><a href="sdlc--templates-forge-discipline-spike-close.template.html">Discipline exploration spike — close record</a></li></ul></section>
</div>
<div class="col-lg-4 col-xl-3 order-1 order-lg-2">
<nav class="forge-toc" aria-label="On this page">
<p class="toc-title mb-2">On this page</p>
<a class="nav-link" href="#why--for-what">Why / For what</a>
<a class="nav-link" href="#rules">Rules</a>
<a class="nav-link" href="#link-to-adr-if-any">Link to ADR (if any)</a>
<a class="nav-link" href="#evidence-of-adoption">Evidence of adoption</a>
<a class="nav-link" href="#scope">Scope</a>
<a class="nav-link" href="#review">Review</a>
<a class="nav-link" href="#related">Related</a>
</nav>
</div>
</div>
<nav class="d-flex flex-wrap justify-content-between gap-2 mt-4 pt-3" style="border-top:1px solid var(--forge-border)" aria-label="Chapter navigation"><a href="sdlc--templates-forge-retro-record.template.html" class="btn btn-cyan-outline btn-sm">← Retro Record — <team> — <iteration id> — <…</a><a href="sdlc--templates-forge-versona-process.template.html" class="btn btn-forge-outline btn-sm">Process: <process-id> →</a></nav>
<footer class="mt-5 pt-4 small" style="border-top:1px solid var(--forge-border);color:var(--forge-text-3)"><p class="mb-1">Last updated: <strong>2026-04-10</strong>.</p><p class="mb-0" style="font-size:.75rem;color:var(--forge-text-4)"></p></footer>
</div>
</main>
</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js" crossorigin="anonymous"></script>
<script src="assets/forge-theme.js"></script>
<script src="assets/handbook-portal-nav.js" data-root="."></script>
</body>
</html>