CONSTITUTION.html

<h1 id="llmprovider-constitution">LLMProvider — Constitution</h1>
<blockquote>
<p><strong>Inherits from:</strong>
<code>HelixConstitution/Constitution.md</code> — all universal clauses
in that document apply unconditionally. Rules below extend or tighten
them; they MUST NOT weaken any inherited clause.</p>
</blockquote>
<blockquote>
<p><strong>Status:</strong> Active. This document is the project’s
authoritative rule set. When a rule here conflicts with
<code>CLAUDE.md</code>, <code>AGENTS.md</code>, or any guide, the
Constitution wins.</p>
</blockquote>
<h2 id="mission">Mission</h2>
<p>See README.md.</p>
<h2 id="mandatory-standards">Mandatory Standards</h2>
<ol type="1">
<li><strong>Reproducibility:</strong> every change is reproducible from
a clean clone
(<code>git clone &lt;repo&gt; &amp;&amp; &lt;project bootstrap&gt;</code>);
no hidden steps.</li>
<li><strong>Tests track behavior, not code:</strong> test what the
user-visible behavior is, not what the implementation looks like.</li>
<li><strong>No silent skips, no silent mocks above unit
tests.</strong></li>
<li><strong>Conventional Commits</strong> for all commits.</li>
<li><strong>SSH-only for git operations</strong> (<code>git@…</code>);
HTTPS prohibited.</li>
</ol>
<h2 id="numbered-rules">Numbered Rules</h2>
<!-- Rules are numbered CONST-NNN. New rules append. Removed rules
     keep their number with a "**Retired:** …" line. -->
<h2 id="definition-of-done">Definition of Done</h2>
<p>A change is done when:</p>
<ol type="1">
<li>The code change is committed.</li>
<li>All project-level tests pass on a clean clone.</li>
<li>All challenges in <code>challenges/scripts/</code> pass on the
running host.</li>
<li>Governance docs (<code>CONSTITUTION.md</code>,
<code>AGENTS.md</code>, <code>CLAUDE.md</code>) are coherent with the
change.</li>
</ol>
<h2 id="see-also">See also</h2>
<ul>
<li><code>README.md</code> — project overview, quickstart.</li>
<li><code>AGENTS.md</code> — guidance for AI coding agents (Codex,
Cursor, etc.).</li>
<li><code>CLAUDE.md</code> — guidance specifically for Claude Code.</li>
<li><code>docs/HOST_POWER_MANAGEMENT.md</code> — CONST-033 background
and runbook.</li>
</ul>