docs/landing/index.html · aaronrene/overseer-kit

<p class="sublead">A small local CLI for durable handoffs between sessions. Git-only stays fully supported; Muse is an explicit repository choice.</p>

42

43

44

<span class="hero-terminal-title">ok — trusted NEXT</span>

49

</div>

50

<pre class="hero-terminal-body"><code><span class="term-prompt">$</span> <span class="term-cmd">ok -C . status</span> <span class="term-flag">--json</span> <span class="term-str"></span>

51

<span class="term-out">branch: main · NEXT digest: 7ac9…</span>

52

53

<span class="term-ok">context matches · print reviewed task</span> <span class="term-cursor" aria-hidden="true"></span></code></pre>

</div>

<a id="cta-download-mac"

58

href="https://github.com/aaronrene/overseer-kit/releases/download/v1.0.0-rc.1/INSTALL-AND-ROLLBACK.md">Install v1.0.0-rc.1</a>

59

60

<a href="https://github.com/aaronrene/overseer-kit">Clone on GitHub</a>

61

</p>

62

63

<a href="scenarios/index.html">Scenarios</a>

64

· <a href="docs.html">Docs</a>

65

· <a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">Release</a>

</p>

</div>

<img src="assets/diagrams/honesty-loop.svg"

70

width="640"

71

height="560"

72

alt="Original Overseer honesty-loop illustration; a conceptual workflow rather than an automated v1 command sequence">

</figure>

</div>

</section>

<img src="assets/diagrams/mechanical-check.svg"

82

width="448"

83

height="148"

84

alt="Original mechanical-check illustration representing a context match or stop">

</figure>

<p class="mech-check-kicker">The core safeguard</p>

89

90

<summary>Technical detail</summary>

91

92

<p><strong>Default after <code>ok init</code>:</strong> the bound launcher checks repository identity, physical root, authority, branch, revision, and <code>NEXT</code> context before printing a task. It does not judge the task or run it.</p>

93

<p class="mech-details-cmd-label">Read-only checks</p>

94

<pre class="mech-details-cmd"><code>ok -C . status --json

95

ok -C . next</code></pre>

96

<p class="mech-details-cmd-label">Reviewed replacement</p>

97

<pre class="mech-details-cmd"><code>ok -C . next-write …</code></pre>

</div>

</details>

</div>

<h2>Mechanical check — current context, on-disk identity</h2>

102

<p>Overseer compares the current checkout with the handoff on disk: repository UUID and root, selected authority, branch, revision, lane, model label, and prior digest. A mismatch stops instead of silently printing stale instructions.</p>

</div>

</aside>

</div>

<h2>Trusted NEXT</h2>

112

113

<li><strong>One handoff</strong> — <code>next</code> validates and prints the repository’s sole current task.</li>

114

<li><strong>Exact context</strong> — copied configuration, a foreign handoff, or a stale revision refuses closed.</li>

115

<li><strong>Your agent stays yours</strong> — Overseer prints task text; it never executes the prompt or chooses the work.</li>

</ul>

</div>

</article>

</svg>

</div>

<h2>Repository · Revision · NEXT</h2>

133

134

<li><strong>Repository</strong> — a persistent UUID and exact physical root bind the local configuration.</li>

135

<li><strong>Revision</strong> — freshness follows the current Git commit or selected Muse revision.</li>

136

<li><strong>NEXT</strong> — one canonical handoff carries the reviewed task and its context.</li>

137

<li><strong>Replacement</strong> — next-write requires the previous NEXT digest and explicit current context.</li>

</ul>

</div>

</article>

</div>

</div>

</section>

<p class="section-kicker">The failure mode</p>

148

<h2>Why governance honesty matters</h2>

149

<p class="section-lede">AI-assisted work breaks down when a new session starts from the wrong context.</p>

</header>

<li>

<span class="pain-label">Amnesia</span>

154

<p>Each new chat re-derives context from scratch.</p>

155

</li>

156

<li>

157

<span class="pain-label">Wrong repository</span>

158

<p>A plausible prompt is pasted into a similar checkout.</p>

159

</li>

160

<li>

161

<span class="pain-label">Silent drift</span>

162

<p>A handoff outlives the branch or revision that produced it.</p>

163

</li>

164

<li>

165

<span class="pain-label">Unreviewed replacement</span>

166

<p>Task text changes without checking its prior digest or context.</p>

167

</li>

168

</ul>

169

<p class="problem-close"><span class="problem-close-lead">Overseer Kit makes context visible before work continues</span> — a local handoff tool, not a hosted agent or workflow engine.</p>

</section>

<h2>How it works</h2>

176

<p class="section-lede">Bind the repository, inspect current status, read the trusted handoff, and replace it deliberately.</p>

</header>

<h3>Initialize explicitly</h3>

183

<p>Bind one authorized checkout to its persistent identity, physical root, authority, lane, and model label.</p>

</div>

</li>

<h3>Check status</h3>

190

<p>See the active repository, authority, branch, revision, runtime pin, and current NEXT digest.</p>

</div>

</li>

<h3>Read trusted NEXT</h3>

197

<p>Validate and print the task for your agent. Overseer does not execute it or decide whether it is good.</p>

</div>

</li>

<h3>Replace deliberately</h3>

204

<p>Review new task text, then publish it against the current revision and the exact prior NEXT digest.</p>

</div>

</li>

</ol>

</section>

<h2>Structure at a glance</h2>

212

<p>The original diagrams remain as working metaphors. The captions below state the bounded-v1 contract that ships.</p>

213

214

215

<figcaption>One trusted handoff is bound to one repository context; lane is an explicit label inside it.</figcaption>

216

217

218

<li>Repository identity + physical root + current revision</li>

219

<li>One lane label and one trusted NEXT handoff</li>

</ul>

</figure>

<figcaption>Git-only is permanently supported. Muse authority, with or without a controlled GitHub mirror, is an explicit choice.</figcaption>

225

226

227

<li>git-only — permanent mode; no Muse required</li>

228

<li>muse+git-mirror — Muse authority + controlled GitHub mirror</li>

229

<li>muse-only — Muse authority; no GitHub mirror</li>

</ul>

</figure>

<figcaption>Context validation has three layers: repository identity, current authority and revision, then NEXT context and digest.</figcaption>

235

236

237

<li>Repository — persistent identity and physical root</li>

238

<li>Authority — selected VCS, branch, and revision</li>

239

<li>NEXT — bound context and previous digest</li>

</ul>

</figure>

<figcaption>The verified kit initializes or adopts a repository, installs a bound launcher, and validates NEXT for your agent.</figcaption>

245

246

247

<li>Verified kit → explicit init or adopt → bound config</li>

248

<li>Validated NEXT → your agent; product checks stay in your repository</li>

</ul>

</figure>

</section>

<h2>Get started</h2>

<p>This site is <strong>informational</strong>. Install the local CLI from the reviewed release, then choose Git or Muse authority for a repository you are authorized to manage.</p>

256

257

258

<h3>Path 1 — Git-only <span class="path-badge">permanent · no account</span></h3>

259

<ol>

260

<li>Follow the reviewed <strong>v1.0.0-rc.1</strong> <code>INSTALL-AND-ROLLBACK.md</code> guide.</li>

261

<li>Set <code>PROJECT_ROOT</code> to an existing <code>Git</code> checkout you are authorized to initialize.</li>

262

<li>Run <code>./cli/ok</code> for <code>init --vcs git</code> with the required <code>repository name and context</code>.</li>

263

<li>Use the repository-bound launcher for status, next, and a reviewed next-write.</li>

264

</ol>

265

<p class="cta-honesty">Git-only is a complete ongoing mode. It requires no Muse installation, account, or future migration.</p>

</article>

<h3>Path 2 — Muse authority (<code>adopt</code>)</h3>

270

<ol>

271

<li>Read the Muse <code>adoption and rollback</code> guide before changing repository authority.</li>

272

<li>Prepare the <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/MIGRATE-EXISTING-REPO.md" id="local-console-loopback">separate pinned Muse environment</a>; Muse is not required by the core install.</li>

273

<li>Preview <code>adopt</code> and confirm the <code>repository identity, root, branch, and revision</code>.</li>

274

<li>Apply the authority change explicitly; Muse metadata alone never changes a Git binding.</li>

</ol>

</article>

<h3>Path 3 — Muse + GitHub mirror</h3>

280

<ol>

281

<li>Prepare and verify the controlled projection with <code>mirror</code>; inspect <code>source and destination identities</code>.</li>

282

<li>Explicit delivery may push the mirror and open a pull request. It never merges the pull request.</li>

</ol>

</article>

<p class="bound-honesty"><em>Overseer is bound to one local checkout. It prints a task; it does not execute the prompt, judge the task, or merge code.</em></p>

287

<p>Operator detail:

288

<a href="https://github.com/aaronrene/overseer-kit/releases/download/v1.0.0-rc.1/INSTALL-AND-ROLLBACK.md">Installation and rollback</a>

289

· Release index: <a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">v1.0.0-rc.1</a>

290

· Git guide:

291

<a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Git-only quickstart</a></p>

</section>

</div>

<h2 id="musehub-heading">Muse when it fits the repository</h2>

301

<p><code>Git-only</code> remains a complete ongoing mode. Muse can become the explicit repository authority, with or without a controlled GitHub mirror. The choice belongs to each repository.</p>

302

303

<a href="#diagram-regimes">See version-control options</a>

304

· Adoption guide:

305

<code>docs/MIGRATE-EXISTING-REPO.md</code>

</p>

</div>

</div>

</section>

<h2>Where to go next</h2>

313

<p>This site explains the bounded local CLI. Day-to-day agent work stays in your existing tools.</p>

<h3>GitHub</h3>

<p><a href="https://github.com/aaronrene/overseer-kit">overseer-kit</a> — <code>source</code>, issues, and release history.</p>

</div>

· <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/CONSUMER-ADAPTER-PATTERN.md">Adapter pattern</a>

323

· <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Quickstart</a></p>

</div>

<h3>Release</h3>

<p>After reviewing <code>v1.0.0-rc.1</code>:

328

<a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">Open the release</a>

329

— see <a href="#console-access">Get started</a>.</p>

</div>

<h3>Scenarios</h3>

<p><a href="scenarios/index.html">Scenario gallery</a> — the original job flows, clearly labeled as examples.</p>

</div>

</div>

<span class="funnel-step" id="funnel-github">Install the CLI</span>

338

339

<span class="funnel-step" id="funnel-kit">Bind one repository</span>

340

341

<span class="funnel-step" id="funnel-musehub">Read trusted NEXT</span>

</div>

</section>

<h2>Scenarios</h2>

<p>The original persona flows remain, with copy that separates shipped CLI behavior from illustrative domain practice.</p>

348

<p><a class="btn btn-secondary" href="scenarios/index.html">Open the scenario gallery →</a></p>

</section>

</main>

<p>

<a href="https://github.com/aaronrene/overseer-kit/blob/main/LICENSE">MIT open source</a>

355

· <a href="https://github.com/aaronrene/overseer-kit/blob/main/SECURITY.md">Security</a>

356

</p>

357

<p class="footer-tagline">🆗 Overseer Kit — Honesty for Agents.</p>

358

</footer>

359

</body>

360

</html>

1	<!DOCTYPE html>
2	<html lang="en" data-theme="dark">
3	<head>
4	<meta charset="utf-8">
5	<meta name="viewport" content="width=device-width, initial-scale=1">
6	<meta name="description" content="Overseer Kit — honesty for agents through a trusted repository handoff.">
7	<title>Overseer Kit — Honesty for Agents</title>
8	<link rel="icon" href="assets/favicon.ico" sizes="any">
9	<link rel="icon" type="image/png" href="assets/favicon-32.png" sizes="32x32">
10	<link rel="apple-touch-icon" href="assets/apple-touch-icon.png">
11	<link rel="stylesheet" href="assets/style.css">
12	<script src="assets/theme.js" defer></script>
13	</head>
14	<body>
15	<header class="site-header">
16	<nav>
17	<a class="brand" href="index.html" aria-label="Overseer Kit home">
18	<span class="logo-mark" aria-hidden="true">OK</span>
19	<span class="brand-name">Overseer Kit</span>
20	</a>
21	<div class="nav-links">
22	<a href="#how-it-works">How it works</a>
23	<a href="#console-access">Get started</a>
24	<a href="scenarios/index.html">Scenarios</a>
25	<a href="docs.html">Docs</a>
26	<button type="button" id="theme-toggle" class="theme-toggle" aria-label="Switch to light mode" title="Light / dark">
27	<span class="theme-icon theme-icon-moon" aria-hidden="true">☾</span>
28	<span class="theme-icon theme-icon-sun" aria-hidden="true">☀</span>
29	</button>
30	</div>
31	</nav>
32	</header>
33
34	<main>
35	<section id="hero" class="hero">
36	<div class="hero-plane" aria-hidden="true"></div>
37	<div class="hero-inner">
38	<div class="hero-copy">
39	<h1>Honesty for Agents.</h1>
40	<p class="lead">Keep every agent anchored to the right repository, revision, and reviewed next task.</p>
41	<p class="sublead">A small local CLI for durable handoffs between sessions. Git-only stays fully supported; Muse is an explicit repository choice.</p>
42
43	<div class="hero-terminal" role="region" aria-label="Overseer status and NEXT command example">
44	<div class="hero-terminal-chrome" aria-hidden="true">
45	<span class="hero-terminal-dot"></span>
46	<span class="hero-terminal-dot"></span>
47	<span class="hero-terminal-dot"></span>
48	<span class="hero-terminal-title">ok — trusted NEXT</span>
49	</div>
50	<pre class="hero-terminal-body"><code><span class="term-prompt">$</span> <span class="term-cmd">ok -C . status</span> <span class="term-flag">--json</span> <span class="term-str"></span>
51	<span class="term-out">branch: main · NEXT digest: 7ac9…</span>
52	<span class="term-prompt">$</span> <span class="term-cmd">ok -C . next</span> <span class="term-flag"></span> <span class="term-str"></span>
53	<span class="term-ok">context matches · print reviewed task</span> <span class="term-cursor" aria-hidden="true"></span></code></pre>
54	</div>
55
56	<p class="hero-foot-links">
57	<a id="cta-download-mac"
58	href="https://github.com/aaronrene/overseer-kit/releases/download/v1.0.0-rc.1/INSTALL-AND-ROLLBACK.md">Install v1.0.0-rc.1</a>
59	<span class="hero-foot-sep" aria-hidden="true">·</span>
60	<a href="https://github.com/aaronrene/overseer-kit">Clone on GitHub</a>
61	</p>
62	<p class="tertiary-links">
63	<a href="scenarios/index.html">Scenarios</a>
64	· <a href="docs.html">Docs</a>
65	· <a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">Release</a>
66	</p>
67	</div>
68	<figure class="hero-visual">
69	<img src="assets/diagrams/honesty-loop.svg"
70	width="640"
71	height="560"
72	alt="Original Overseer honesty-loop illustration; a conceptual workflow rather than an automated v1 command sequence">
73	</figure>
74	</div>
75	</section>
76
77	<section id="kit-basics" class="band-kit-basics" aria-label="Repository check, trusted NEXT, and living docs">
78	<div class="kit-basics-inner">
79	<aside class="mech-check-strip" id="mechanical-check" aria-label="Mechanical check">
80	<figure class="mech-check-visual">
81	<img src="assets/diagrams/mechanical-check.svg"
82	width="448"
83	height="148"
84	alt="Original mechanical-check illustration representing a context match or stop">
85	</figure>
86	<div class="mech-check-copy">
87	<div class="mech-check-kicker-row">
88	<p class="mech-check-kicker">The core safeguard</p>
89	<details class="mech-check-details">
90	<summary>Technical detail</summary>
91	<div class="mech-details-body">
92	<p><strong>Default after <code>ok init</code>:</strong> the bound launcher checks repository identity, physical root, authority, branch, revision, and <code>NEXT</code> context before printing a task. It does not judge the task or run it.</p>
93	<p class="mech-details-cmd-label">Read-only checks</p>
94	<pre class="mech-details-cmd"><code>ok -C . status --json
95	ok -C . next</code></pre>
96	<p class="mech-details-cmd-label">Reviewed replacement</p>
97	<pre class="mech-details-cmd"><code>ok -C . next-write …</code></pre>
98	</div>
99	</details>
100	</div>
101	<h2>Mechanical check — current context, on-disk identity</h2>
102	<p>Overseer compares the current checkout with the handoff on disk: repository UUID and root, selected authority, branch, revision, lane, model label, and prior digest. A mismatch stops instead of silently printing stale instructions.</p>
103	</div>
104	</aside>
105	<div class="kit-basics-grid">
106	<article class="kit-basics-panel">
107	<div class="kit-basics-icon" aria-hidden="true">
108	<img src="assets/ok-mark.svg" width="64" height="64" alt="">
109	</div>
110	<div class="kit-basics-copy">
111	<h2>Trusted NEXT</h2>
112	<ul class="kit-basics-list">
113	<li><strong>One handoff</strong> — <code>next</code> validates and prints the repository’s sole current task.</li>
114	<li><strong>Exact context</strong> — copied configuration, a foreign handoff, or a stale revision refuses closed.</li>
115	<li><strong>Your agent stays yours</strong> — Overseer prints task text; it never executes the prompt or chooses the work.</li>
116	</ul>
117	</div>
118	</article>
119	<article class="kit-basics-panel">
120	<div class="kit-basics-icon kit-basics-icon-docs" aria-hidden="true">
121	<svg xmlns="http://www.w3.org/2000/svg" width="78" height="78" viewBox="8 12 84 72" focusable="false">
122	<rect x="14" y="18" width="40" height="52" rx="4" fill="none" stroke="#7ec8ff" stroke-width="3"/>
123	<path d="M24 34h20M24 46h20M24 58h12" fill="none" stroke="#7ec8ff" stroke-width="2.5" stroke-linecap="round"/>
124	<path d="M24 34l3.5 3.5 7-8" fill="none" stroke="#5cb88a" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
125	<path d="M68 28a18 18 0 0 1 0 36" fill="none" stroke="#e8a35c" stroke-width="3" stroke-linecap="round"/>
126	<path d="M68 64a18 18 0 0 1 0-36" fill="none" stroke="#e85d4c" stroke-width="3" stroke-linecap="round" stroke-dasharray="4 5"/>
127	<path d="M78 22l6 6-6 6" fill="none" stroke="#e8a35c" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
128	<path d="M58 70l-6-6 6-6" fill="none" stroke="#e85d4c" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
129	</svg>
130	</div>
131	<div class="kit-basics-copy">
132	<h2>Repository · Revision · NEXT</h2>
133	<ul class="kit-basics-list">
134	<li><strong>Repository</strong> — a persistent UUID and exact physical root bind the local configuration.</li>
135	<li><strong>Revision</strong> — freshness follows the current Git commit or selected Muse revision.</li>
136	<li><strong>NEXT</strong> — one canonical handoff carries the reviewed task and its context.</li>
137	<li><strong>Replacement</strong> — next-write requires the previous NEXT digest and explicit current context.</li>
138	</ul>
139	</div>
140	</article>
141	</div>
142	</div>
143	</section>
144
145	<section id="problem" class="band-problem">
146	<header class="section-intro">
147	<p class="section-kicker">The failure mode</p>
148	<h2>Why governance honesty matters</h2>
149	<p class="section-lede">AI-assisted work breaks down when a new session starts from the wrong context.</p>
150	</header>
151	<ul class="pain-grid">
152	<li>
153	<span class="pain-label">Amnesia</span>
154	<p>Each new chat re-derives context from scratch.</p>
155	</li>
156	<li>
157	<span class="pain-label">Wrong repository</span>
158	<p>A plausible prompt is pasted into a similar checkout.</p>
159	</li>
160	<li>
161	<span class="pain-label">Silent drift</span>
162	<p>A handoff outlives the branch or revision that produced it.</p>
163	</li>
164	<li>
165	<span class="pain-label">Unreviewed replacement</span>
166	<p>Task text changes without checking its prior digest or context.</p>
167	</li>
168	</ul>
169	<p class="problem-close"><span class="problem-close-lead">Overseer Kit makes context visible before work continues</span> — a local handoff tool, not a hosted agent or workflow engine.</p>
170	</section>
171
172	<section id="how-it-works" class="band-how">
173	<header class="section-intro">
174	<p class="section-kicker">The loop</p>
175	<h2>How it works</h2>
176	<p class="section-lede">Bind the repository, inspect current status, read the trusted handoff, and replace it deliberately.</p>
177	</header>
178	<ol class="loop-steps">
179	<li class="loop-step">
180	<span class="loop-index" aria-hidden="true">01</span>
181	<div class="loop-body">
182	<h3>Initialize explicitly</h3>
183	<p>Bind one authorized checkout to its persistent identity, physical root, authority, lane, and model label.</p>
184	</div>
185	</li>
186	<li class="loop-step">
187	<span class="loop-index" aria-hidden="true">02</span>
188	<div class="loop-body">
189	<h3>Check status</h3>
190	<p>See the active repository, authority, branch, revision, runtime pin, and current NEXT digest.</p>
191	</div>
192	</li>
193	<li class="loop-step">
194	<span class="loop-index" aria-hidden="true">03</span>
195	<div class="loop-body">
196	<h3>Read trusted NEXT</h3>
197	<p>Validate and print the task for your agent. Overseer does not execute it or decide whether it is good.</p>
198	</div>
199	</li>
200	<li class="loop-step">
201	<span class="loop-index" aria-hidden="true">04</span>
202	<div class="loop-body">
203	<h3>Replace deliberately</h3>
204	<p>Review new task text, then publish it against the current revision and the exact prior NEXT digest.</p>
205	</div>
206	</li>
207	</ol>
208	</section>
209
210	<section id="structure">
211	<h2>Structure at a glance</h2>
212	<p>The original diagrams remain as working metaphors. The captions below state the bounded-v1 contract that ships.</p>
213
214	<figure class="diagram-figure" id="diagram-lanes">
215	<figcaption>One trusted handoff is bound to one repository context; lane is an explicit label inside it.</figcaption>
216	<img src="assets/diagrams/lanes.svg" alt="Original work-lanes illustration, used here as a conceptual view of repository context and one trusted handoff" width="720" height="280">
217	<ul class="diagram-fallback">
218	<li>Repository identity + physical root + current revision</li>
219	<li>One lane label and one trusted NEXT handoff</li>
220	</ul>
221	</figure>
222
223	<figure class="diagram-figure" id="diagram-regimes">
224	<figcaption>Git-only is permanently supported. Muse authority, with or without a controlled GitHub mirror, is an explicit choice.</figcaption>
225	<img src="assets/diagrams/regimes.svg" alt="Version-control options from git-only to Muse with GitHub mirror to Muse-only" width="640" height="320">
226	<ul class="diagram-fallback">
227	<li>git-only — permanent mode; no Muse required</li>
228	<li>muse+git-mirror — Muse authority + controlled GitHub mirror</li>
229	<li>muse-only — Muse authority; no GitHub mirror</li>
230	</ul>
231	</figure>
232
233	<figure class="diagram-figure" id="diagram-layers">
234	<figcaption>Context validation has three layers: repository identity, current authority and revision, then NEXT context and digest.</figcaption>
235	<img src="assets/diagrams/layers.svg" alt="Original safety-layer illustration, representing repository, revision, and NEXT context checks" width="420" height="280">
236	<ul class="diagram-fallback">
237	<li>Repository — persistent identity and physical root</li>
238	<li>Authority — selected VCS, branch, and revision</li>
239	<li>NEXT — bound context and previous digest</li>
240	</ul>
241	</figure>
242
243	<figure class="diagram-figure" id="diagram-kit-consumer">
244	<figcaption>The verified kit initializes or adopts a repository, installs a bound launcher, and validates NEXT for your agent.</figcaption>
245	<img src="assets/diagrams/kit-consumer.svg" alt="Original kit-and-consumer illustration, representing verified source, explicit setup, repository binding, and an agent handoff" width="760" height="260">
246	<ul class="diagram-fallback">
247	<li>Verified kit → explicit init or adopt → bound config</li>
248	<li>Validated NEXT → your agent; product checks stay in your repository</li>
249	</ul>
250	</figure>
251	</section>
252
253	<section id="console-access">
254	<h2>Get started</h2>
255	<p>This site is <strong>informational</strong>. Install the local CLI from the reviewed release, then choose Git or Muse authority for a repository you are authorized to manage.</p>
256
257	<article class="path-card path-preferred" id="path-1">
258	<h3>Path 1 — Git-only <span class="path-badge">permanent · no account</span></h3>
259	<ol>
260	<li>Follow the reviewed <strong>v1.0.0-rc.1</strong> <code>INSTALL-AND-ROLLBACK.md</code> guide.</li>
261	<li>Set <code>PROJECT_ROOT</code> to an existing <code>Git</code> checkout you are authorized to initialize.</li>
262	<li>Run <code>./cli/ok</code> for <code>init --vcs git</code> with the required <code>repository name and context</code>.</li>
263	<li>Use the repository-bound launcher for status, next, and a reviewed next-write.</li>
264	</ol>
265	<p class="cta-honesty">Git-only is a complete ongoing mode. It requires no Muse installation, account, or future migration.</p>
266	</article>
267
268	<article class="path-card" id="path-2">
269	<h3>Path 2 — Muse authority (<code>adopt</code>)</h3>
270	<ol>
271	<li>Read the Muse <code>adoption and rollback</code> guide before changing repository authority.</li>
272	<li>Prepare the <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/MIGRATE-EXISTING-REPO.md" id="local-console-loopback">separate pinned Muse environment</a>; Muse is not required by the core install.</li>
273	<li>Preview <code>adopt</code> and confirm the <code>repository identity, root, branch, and revision</code>.</li>
274	<li>Apply the authority change explicitly; Muse metadata alone never changes a Git binding.</li>
275	</ol>
276	</article>
277
278	<article class="path-card" id="path-3">
279	<h3>Path 3 — Muse + GitHub mirror</h3>
280	<ol>
281	<li>Prepare and verify the controlled projection with <code>mirror</code>; inspect <code>source and destination identities</code>.</li>
282	<li>Explicit delivery may push the mirror and open a pull request. It never merges the pull request.</li>
283	</ol>
284	</article>
285
286	<p class="bound-honesty"><em>Overseer is bound to one local checkout. It prints a task; it does not execute the prompt, judge the task, or merge code.</em></p>
287	<p>Operator detail:
288	<a href="https://github.com/aaronrene/overseer-kit/releases/download/v1.0.0-rc.1/INSTALL-AND-ROLLBACK.md">Installation and rollback</a>
289	· Release index: <a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">v1.0.0-rc.1</a>
290	· Git guide:
291	<a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Git-only quickstart</a></p>
292	</section>
293
294	<section id="musehub" class="musehub-band" aria-labelledby="musehub-heading">
295	<div class="musehub-band-inner">
296	<div class="musehub-brand">
297	<img class="musehub-logo" src="assets/musehub-logo.svg" width="360" height="80" alt="MuseHub">
298	</div>
299	<div class="musehub-copy">
300	<h2 id="musehub-heading">Muse when it fits the repository</h2>
301	<p><code>Git-only</code> remains a complete ongoing mode. Muse can become the explicit repository authority, with or without a controlled GitHub mirror. The choice belongs to each repository.</p>
302	<p class="musehub-links">
303	<a href="#diagram-regimes">See version-control options</a>
304	· Adoption guide:
305	<code>docs/MIGRATE-EXISTING-REPO.md</code>
306	</p>
307	</div>
308	</div>
309	</section>
310
311	<section id="next-steps">
312	<h2>Where to go next</h2>
313	<p>This site explains the bounded local CLI. Day-to-day agent work stays in your existing tools.</p>
314	<div class="card-grid suite-grid">
315	<div class="card">
316	<h3>GitHub</h3>
317	<p><a href="https://github.com/aaronrene/overseer-kit">overseer-kit</a> — <code>source</code>, issues, and release history.</p>
318	</div>
319	<div class="card">
320	<h3>Docs</h3>
321	<p><a href="docs.html">Docs on this site</a>
322	· <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/CONSUMER-ADAPTER-PATTERN.md">Adapter pattern</a>
323	· <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Quickstart</a></p>
324	</div>
325	<div class="card">
326	<h3>Release</h3>
327	<p>After reviewing <code>v1.0.0-rc.1</code>:
328	<a href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">Open the release</a>
329	— see <a href="#console-access">Get started</a>.</p>
330	</div>
331	<div class="card">
332	<h3>Scenarios</h3>
333	<p><a href="scenarios/index.html">Scenario gallery</a> — the original job flows, clearly labeled as examples.</p>
334	</div>
335	</div>
336	<div class="funnel" id="funnel" aria-label="Adoption path">
337	<span class="funnel-step" id="funnel-github">Install the CLI</span>
338	<span class="funnel-arrow">→</span>
339	<span class="funnel-step" id="funnel-kit">Bind one repository</span>
340	<span class="funnel-arrow">→</span>
341	<span class="funnel-step" id="funnel-musehub">Read trusted NEXT</span>
342	</div>
343	</section>
344
345	<section id="scenarios">
346	<h2>Scenarios</h2>
347	<p>The original persona flows remain, with copy that separates shipped CLI behavior from illustrative domain practice.</p>
348	<p><a class="btn btn-secondary" href="scenarios/index.html">Open the scenario gallery →</a></p>
349	</section>
350	</main>
351
352	<footer class="site-footer">
353	<p>
354	<a href="https://github.com/aaronrene/overseer-kit/blob/main/LICENSE">MIT open source</a>
355	· <a href="https://github.com/aaronrene/overseer-kit/blob/main/SECURITY.md">Security</a>
356	</p>
357	<p class="footer-tagline">🆗 Overseer Kit — Honesty for Agents.</p>
358	</footer>
359	</body>
360	</html>