aaronrene / overseer-kit public
index.html html
218 lines 10.4 KB
Raw
sha256:4671b7f787ddbe63ced31c895b688c77ab495653b65a730b423329f26b3c1439 feat: K1-P1 complete — agent provenance, build-verification… Sonnet 4.6 patch 55 days ago
1 <!DOCTYPE html>
2 <html lang="en">
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 — phased AI work without amnesia, fake DONE, or silent drift. Governance + honesty on plain GitHub.">
7 <title>🆗 Overseer Kit — Governance + honesty for AI-assisted work</title>
8 <link rel="stylesheet" href="assets/style.css">
9 </head>
10 <body>
11 <header class="site-header">
12 <nav>
13 <a class="brand" href="index.html">🆗 Overseer Kit</a>
14 <div class="nav-links">
15 <a href="#l0">Layers</a>
16 <a href="scenarios/index.html">Scenarios</a>
17 <a href="#quickstart">Quickstart</a>
18 <a href="#funnel">GitHub → MuseHub</a>
19 <a href="../../README.md">Docs</a>
20 </div>
21 </nav>
22 </header>
23
24 <main>
25 <section id="hero">
26 <h1>🆗 Overseer Kit</h1>
27 <p class="lead">Phased AI work without amnesia, fake DONE, or silent drift — on plain GitHub.</p>
28 <p class="sublead">Optional MuseHub depth when you need provenance, signed identity, and non-invertible history.</p>
29 <div class="cta-row">
30 <a class="btn btn-primary" href="#quickstart">Get started</a>
31 <a class="btn btn-secondary" href="scenarios/index.html">Scenario gallery</a>
32 <a class="btn btn-secondary" href="https://github.com/aaronrene/overseer-kit">GitHub</a>
33 </div>
34 </section>
35
36 <section id="problem">
37 <h2>The problem</h2>
38 <p>AI-assisted development breaks down at the boundaries between sessions:</p>
39 <ul class="compact">
40 <li><strong>Amnesia</strong> — each new chat re-derives context from scratch.</li>
41 <li><strong>Self-approval</strong> — agents mark phases DONE without independent verification.</li>
42 <li><strong>Silent drift</strong> — roadmaps and handovers fall out of sync with reality.</li>
43 <li><strong>Skipped tests</strong> — expensive remakes when mechanical gates are bypassed.</li>
44 </ul>
45 <p>🆗 Overseer Kit makes <em>skipping honesty expensive</em> — not by running your product, but by governing how phased work proceeds.</p>
46 </section>
47
48 <section id="l0">
49 <h2>L0 in 60 seconds — roadmap + handover</h2>
50 <p>Every repo gets a living <strong>ROADMAP</strong> (phase control board) and <strong>HANDOVER</strong> (session relay with one next step). Fresh AI sessions paste the handover prompt instead of guessing.</p>
51 <div class="layer-stack">
52 <div class="layer layer-l0">
53 <strong>L0 — Governance docs</strong>
54 ROADMAP phases · HANDOVER relay · tier authority · model labels · freeze review
55 </div>
56 </div>
57 <pre>./cli/overseer init --regime git-only
58 ./cli/overseer governance-sync --dry-run
59 ./cli/overseer status</pre>
60 <p>L0 alone is useful on any GitHub repo. No Muse install required.</p>
61 </section>
62
63 <section id="l1">
64 <h2>Add L1 — mechanical checkpoints</h2>
65 <p>When artifacts are measurable (media exports, test suites, data transforms), L1 runs verify scripts before the pipeline advances.</p>
66 <div class="layer-stack">
67 <div class="layer layer-l1">
68 <strong>L1 — Checkpoint orchestrator</strong>
69 <code>overseer verify-step</code> · policy/manifest · ARTIFACT_SHA256 binding · fail-closed exits
70 </div>
71 </div>
72 <p>Domain logic stays in <em>your</em> verify scripts — the kit ships the orchestrator socket, not video QC or accounting rules.</p>
73 </section>
74
75 <section id="l2">
76 <h2>Add L2 — boss / worker / checker</h2>
77 <p>When handoffs involve money, publish, or audit stakes, L2 adds role-gated verdicts on an append-only ledger.</p>
78 <div class="layer-stack">
79 <div class="layer layer-l2">
80 <strong>L2 — Honesty module</strong>
81 <code>overseer honesty-status</code> · <code>overseer ledger</code> · producer/verifier separation · hash chain
82 </div>
83 </div>
84 <p>Producers cannot self-certify. Verifiers run in independent sessions. Tampering breaks the chain.</p>
85 </section>
86
87 <section id="l3">
88 <h2>Optional L3 — MuseHub substrate</h2>
89 <p>Same CLI commands. When you flip to <code>muse+git-mirror</code>, you gain content-addressed history, safe GitHub mirror export, and drift realign — without gating L0–L2.</p>
90 <div class="layer-stack">
91 <div class="layer layer-l3">
92 <strong>L3 — MuseHub deepen (optional)</strong>
93 Canonical Muse history · <code>realign</code> · isolated mirror PR · provenance enrichment
94 </div>
95 </div>
96 <p><strong>Guardrail:</strong> no core governance feature is MuseHub-only. Git-only is a first-class baseline.</p>
97 </section>
98
99 <section id="modularity">
100 <h2>Modularity — lanes, modules, domain packs</h2>
101 <div class="card-grid">
102 <div class="card">
103 <h3>Multi-lane docs</h3>
104 <p>Named handover/roadmap pairs per concern (<code>governance-sync --lane</code>).</p>
105 </div>
106 <div class="card">
107 <h3>L1 + L2 modules</h3>
108 <p>Typed checkpoint and honesty sockets — enable in <code>.overseer/config.yaml</code>.</p>
109 </div>
110 <div class="card">
111 <h3>Domain packs</h3>
112 <p>Consumer-owned verify scripts and hooks — VideoFactory, research, classroom, etc.</p>
113 </div>
114 <div class="card">
115 <h3>VCS adapters</h3>
116 <p><code>git-only</code> · <code>muse+git-mirror</code> · <code>muse-only</code> — same CLI surface.</p>
117 </div>
118 </div>
119 </section>
120
121 <section id="personas">
122 <h2>Who it is for</h2>
123 <div class="card-grid">
124 <div class="card">
125 <h3>AI video studios</h3>
126 <p>Stop remakes and fake approvals before publish.</p>
127 </div>
128 <div class="card">
129 <h3>Research labs</h3>
130 <p>Bind claims to evidence hashes; independent verifier sessions.</p>
131 </div>
132 <div class="card">
133 <h3>Classrooms</h3>
134 <p>Portable integrity curriculum — L0 default; Muse identity optional.</p>
135 </div>
136 <div class="card">
137 <h3>Treasuries &amp; regulated ops</h3>
138 <p>Dual-control hooks + append-only ledger for audit trails.</p>
139 </div>
140 </div>
141 <p><a href="scenarios/index.html">See the full scenario gallery →</a></p>
142 </section>
143
144 <section id="quickstart">
145 <h2>Quickstart — git-only in 5 minutes</h2>
146 <ol>
147 <li>Clone <a href="https://github.com/aaronrene/overseer-kit">overseer-kit</a>.</li>
148 <li>From your consumer repo: <code>./cli/overseer -C . init --regime git-only --non-interactive</code></li>
149 <li>Open <code>docs/OVERSEER-HANDOVER.md</code> → copy the paste-ready prompt.</li>
150 <li>Run <code>./cli/overseer governance-sync --dry-run</code> before ending each session.</li>
151 </ol>
152 <p>Full guide: <a href="../GIT-ONLY-QUICKSTART.md">Git-only quickstart</a> · Consumer pattern: <a href="../CONSUMER-ADAPTER-PATTERN.md">CONSUMER-ADAPTER-PATTERN.md</a></p>
153 </section>
154
155 <section id="musehub-upgrade">
156 <h2>MuseHub upgrade path</h2>
157 <p>When provenance matters, flip regime — same commands, deeper history:</p>
158 <ol>
159 <li>Install <a href="https://musehub.ai">Muse</a> and run <code>muse init</code> in your repo.</li>
160 <li>Set <code>regime: muse+git-mirror</code> in <code>.overseer/config.yaml</code>.</li>
161 <li><code>./cli/overseer sync</code> — seeds bridge workflow + safe deploy script.</li>
162 <li>Day-to-day: <code>muse commit</code> on feature branches. Publish via <code>scripts/muse-bridge-deploy.sh</code> only.</li>
163 </ol>
164 <p>Operator runbook: <a href="../K7-DOGFOOD-OPERATOR-RUNBOOK.md">K7 dogfood runbook</a></p>
165 </section>
166
167 <section id="roadmap-public">
168 <h2>Public roadmap</h2>
169 <table style="width:100%; border-collapse:collapse; font-size:0.9375rem;">
170 <thead>
171 <tr style="border-bottom:1px solid var(--border); text-align:left;">
172 <th style="padding:0.5rem;">Phase</th>
173 <th style="padding:0.5rem;">Deliverable</th>
174 <th style="padding:0.5rem;">Status</th>
175 </tr>
176 </thead>
177 <tbody>
178 <tr style="border-bottom:1px solid var(--border);"><td style="padding:0.5rem;">K9b</td><td style="padding:0.5rem;">L1 checkpoint orchestrator</td><td style="padding:0.5rem;">DONE</td></tr>
179 <tr style="border-bottom:1px solid var(--border);"><td style="padding:0.5rem;">K10</td><td style="padding:0.5rem;">L2 honesty ledger</td><td style="padding:0.5rem;">DONE</td></tr>
180 <tr style="border-bottom:1px solid var(--border);"><td style="padding:0.5rem;">K11</td><td style="padding:0.5rem;">API/CI freeze provider</td><td style="padding:0.5rem;">DONE</td></tr>
181 <tr><td style="padding:0.5rem;">K12</td><td style="padding:0.5rem;">Track N landing + scenario gallery</td><td style="padding:0.5rem;">DONE</td></tr>
182 </tbody>
183 </table>
184 <p style="margin-top:1rem;"><a href="../ROADMAP.md">Full ROADMAP.md</a></p>
185 </section>
186
187 <section id="funnel">
188 <h2>GitHub → Kit → MuseHub</h2>
189 <p>Start where you are. Add layers when stakes rise. Upgrade substrate only when provenance pays for itself.</p>
190 <div class="funnel">
191 <span class="funnel-step" id="funnel-github">① GitHub today</span>
192 <span class="funnel-arrow">→</span>
193 <span class="funnel-step" id="funnel-kit">② 🆗 Overseer Kit layers</span>
194 <span class="funnel-arrow">→</span>
195 <span class="funnel-step" id="funnel-musehub">③ MuseHub when ready</span>
196 </div>
197 <div class="diagram">Plain GitHub repo
198 │ overseer init (git-only)
199 ▼
200 L0 governance ──► L1 checkpoints ──► L2 honesty ledger
201 │ │
202 │ optional regime flip │
203 ▼ ▼
204 muse+git-mirror ──► realign / mirror / provenance badge</div>
205 <p>Not another agent framework. <strong>Governance + honesty</strong> for people who already use Cursor and GitHub.</p>
206 </section>
207 </main>
208
209 <footer class="site-footer">
210 <p>
211 <a href="../../LICENSE">Apache-2.0</a>
212 · <a href="../../SECURITY.md">Security</a>
213 · <a href="../PHASE-K12-TRACK-N-LANDING-CONTRACT.md">K12 contract</a>
214 </p>
215 <p>🆗 Overseer Kit — portable governance for AI-assisted development</p>
216 </footer>
217 </body>
218 </html>
File History 1 commit
sha256:4671b7f787ddbe63ced31c895b688c77ab495653b65a730b423329f26b3c1439 feat: K1-P1 complete — agent provenance, build-verification… Sonnet 4.6 patch 55 days ago