aaronrene / overseer-kit public
index.html html
75 lines 14.2 KB
Raw
sha256:cb0d285531d52a0703d33e76389edd88459e272649b519516caf3aef09339b11 docs: restore original site design with bounded-v1 copy Human 7 days ago
1 <!DOCTYPE html>
2 <html lang="en" data-theme="dark">
3 <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
4 <meta name="description" content="Overseer Kit — honesty for agents through one trusted NEXT handoff per repository.">
5 <title>Overseer Kit — Honesty for Agents</title><link rel="icon" href="assets/favicon.ico" sizes="any"><link rel="icon" type="image/png" href="assets/favicon-32.png" sizes="32x32"><link rel="apple-touch-icon" href="assets/apple-touch-icon.png"><link rel="stylesheet" href="assets/style.css"><script src="assets/theme.js" defer></script></head>
6 <body>
7
8 <a class="skip-link" href="#main">Skip to content</a>
9 <header class="site-header">
10 <nav aria-label="Main navigation">
11 <a class="brand" href="index.html" aria-label="Overseer Kit home">
12 <span class="logo-mark" aria-hidden="true">OK</span><span class="brand-name">Overseer Kit</span>
13 </a>
14 <div class="nav-links">
15 <a href="index.html#how-it-works">How it works</a><a href="index.html#start">Get started</a>
16 <a href="scenarios/index.html">Scenarios</a><a href="docs.html">Docs</a>
17 <button type="button" id="theme-toggle" class="theme-toggle" aria-label="Switch to light mode" title="Light / dark"><span class="theme-icon theme-icon-moon" aria-hidden="true">☾</span><span class="theme-icon theme-icon-sun" aria-hidden="true">☀</span></button>
18 </div>
19 </nav>
20 </header>
21 <main id="main">
22 <section id="hero" class="hero">
23 <div class="hero-plane" aria-hidden="true"></div><div class="hero-inner"><div class="hero-copy">
24 <p class="release-badge">Bounded v1 · rc.1 prerelease</p>
25 <h1>Honesty for Agents.</h1>
26 <p class="lead">Pick up the right task, in the right repository, at the right revision.</p>
27 <p class="sublead">Overseer Kit keeps one trusted NEXT handoff per repository. It checks the context before an agent session begins and makes every replacement deliberate.</p>
28 <div class="hero-terminal" role="region" aria-label="Daily Overseer command example"><div class="hero-terminal-chrome" aria-hidden="true"><span class="hero-terminal-dot"></span><span class="hero-terminal-dot"></span><span class="hero-terminal-dot"></span><span class="hero-terminal-title">ok — trusted NEXT</span></div>
29 <pre class="hero-terminal-body"><code><span class="term-prompt">$</span> <span class="term-cmd">./.overseer/bin/ok status</span>
30 <span class="term-out">repository · branch · revision · NEXT</span>
31 <span class="term-prompt">$</span> <span class="term-cmd">./.overseer/bin/ok next</span>
32 <span class="term-ok">validated handoff ready</span> <span class="term-cursor" aria-hidden="true"></span></code></pre></div>
33 <p class="hero-foot-links"><a id="cta-release" href="https://github.com/aaronrene/overseer-kit/releases/tag/v1.0.0-rc.1">Get v1.0.0-rc.1</a><span class="hero-foot-sep" aria-hidden="true">·</span><a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Git-only quickstart</a><span class="hero-foot-sep" aria-hidden="true">·</span><a href="https://github.com/aaronrene/overseer-kit">View on GitHub</a></p>
34 <p class="truth-note">The release is a prerelease. Installation is checksum verified and uses a fixed local source path.</p>
35 </div><figure class="hero-visual"><img src="assets/diagrams/honesty-loop.svg" width="640" height="560" alt="Overseer flow: initialize, check status, read trusted NEXT, and publish a reviewed replacement"></figure></div>
36 </section>
37
38 <section id="context" class="band-kit-basics" aria-label="Context and trusted handoff">
39 <div class="kit-basics-inner"><aside class="mech-check-strip"><figure class="mech-check-visual"><img src="assets/diagrams/mechanical-check.svg" width="448" height="148" alt="Repository context enters a mechanical identity and revision check and either matches or stops"></figure>
40 <div class="mech-check-copy"><div class="mech-check-kicker-row"><p class="mech-check-kicker">The core safeguard</p><details class="mech-check-details"><summary>Technical detail</summary><div class="mech-details-body"><p><strong>Before NEXT is printed:</strong> Overseer validates the repository UUID, physical root, selected authority, branch, revision, and handoff digest.</p><p class="mech-details-cmd-label">Daily read</p><pre class="mech-details-cmd"><code>./.overseer/bin/ok status
41 ./.overseer/bin/ok next</code></pre></div></details></div>
42 <h2>Context check — the right task for this exact checkout</h2><p>A copied prompt should not become another project’s work. Overseer compares on-disk identity and current version-control state before it prints the trusted handoff. A mismatch stops the read and leaves the task untouched.</p></div></aside>
43 <div class="kit-basics-grid"><article class="kit-basics-panel"><div class="kit-basics-icon" aria-hidden="true"><img src="assets/ok-mark.svg" width="64" height="64" alt=""></div><div class="kit-basics-copy"><h2>One trusted NEXT</h2><ul class="kit-basics-list"><li><strong>Readable</strong> — a plain-text task you can inspect before using it.</li><li><strong>Bound</strong> — repository, branch, revision, lane, model label, and action identity travel with it.</li><li><strong>Deliberate</strong> — replacing it requires the prior NEXT digest.</li></ul></div></article>
44 <article class="kit-basics-panel"><div class="kit-basics-icon kit-basics-icon-docs" aria-hidden="true"><img src="assets/diagrams/living-docs-icon.svg" width="78" height="78" alt=""></div><div class="kit-basics-copy"><h2>Repository · Branch · Revision</h2><ul class="kit-basics-list"><li><strong>Repository</strong> — persistent UUID plus exact physical-folder binding.</li><li><strong>Branch</strong> — confirms the workstream named by the handoff.</li><li><strong>Revision</strong> — detects when work moved after the task was written.</li><li><strong>Authority</strong> — Git or Muse is chosen explicitly for each repository.</li></ul></div></article></div>
45 </div>
46 </section>
47
48 <section id="problem" class="band-problem"><header class="section-intro"><p class="section-kicker">The failure mode</p><h2>Why context honesty matters</h2><p class="section-lede">AI-assisted work breaks down when a good prompt is detached from the repository state that made it true.</p></header>
49 <ul class="pain-grid"><li><span class="pain-label">Wrong repository</span><p>A handoff copied from a similar project looks plausible.</p></li><li><span class="pain-label">Stale revision</span><p>The branch moved after the task was written.</p></li><li><span class="pain-label">Lost handoff</span><p>A new session reconstructs intent from partial memory.</p></li><li><span class="pain-label">Accidental replacement</span><p>A task is overwritten without proving which version it replaced.</p></li></ul>
50 <p class="problem-close"><span class="problem-close-lead">Overseer makes the handoff inspectable</span> — and refuses to present it when its repository context no longer matches.</p>
51 </section>
52
53 <section id="how-it-works" class="band-how"><header class="section-intro"><p class="section-kicker">The real flow</p><h2>How it works</h2><p class="section-lede">Initialize once. Check the context. Read NEXT. Publish a reviewed replacement only when the task changes.</p></header>
54 <ol class="loop-steps"><li class="loop-step"><span class="loop-index" aria-hidden="true">01</span><div class="loop-body"><h3>Initialize the repository</h3><p>Choose Git or Muse explicitly, then bind the repository’s persistent identity and physical root.</p></div></li><li class="loop-step"><span class="loop-index" aria-hidden="true">02</span><div class="loop-body"><h3>Check status</h3><p>See the active authority, repository, branch, revision, lane, model label, and NEXT digest.</p></div></li><li class="loop-step"><span class="loop-index" aria-hidden="true">03</span><div class="loop-body"><h3>Read trusted NEXT</h3><p>Validate and print the handoff. Overseer does not run it or decide whether the task is good.</p></div></li><li class="loop-step"><span class="loop-index" aria-hidden="true">04</span><div class="loop-body"><h3>Replace it deliberately</h3><p>Review the new task and publish it with exact context plus the previous NEXT digest.</p></div></li></ol>
55 </section>
56
57 <section id="modes"><h2>Structure at a glance</h2><p>The familiar diagrams are back, with labels aligned to the bounded v1 that actually ships.</p>
58 <figure class="diagram-figure"><figcaption>One handoff is bound to one repository context. Lane remains a label inside that context.</figcaption><img src="assets/diagrams/lanes.svg" alt="Repository identity, branch, revision, and lane lead to one trusted NEXT handoff" width="720" height="280"><ul class="diagram-fallback"><li>Repository identity plus physical root</li><li>Branch, revision, lane, and model label</li><li>One trusted NEXT</li></ul></figure>
59 <figure class="diagram-figure" id="diagram-regimes"><figcaption>Git-only is permanently supported. Muse authority and an optional GitHub mirror are explicit choices.</figcaption><img src="assets/diagrams/regimes.svg" alt="Version-control choices: Git-only, Muse with a GitHub mirror, and Muse-only" width="640" height="320"><ul class="diagram-fallback"><li>Git-only — permanently supported</li><li>Muse plus GitHub mirror — Muse authoritative, mirror controlled</li><li>Muse-only — no GitHub mirror</li></ul></figure>
60 <figure class="diagram-figure"><figcaption>Three checks establish whether a handoff belongs to the current checkout.</figcaption><img src="assets/diagrams/layers.svg" alt="Repository identity, current branch and revision, and NEXT digest checks" width="420" height="280"><ul class="diagram-fallback"><li>Repository identity and physical root</li><li>Selected authority, branch, and revision</li><li>NEXT context and digest</li></ul></figure>
61 <figure class="diagram-figure"><figcaption>The kit installs a repository-bound launcher. Your agent session remains separate and under your control.</figcaption><img src="assets/diagrams/kit-consumer.svg" alt="Overseer Kit source initializes a repository with local configuration and a trusted NEXT handoff for an agent session" width="760" height="260"><ul class="diagram-fallback"><li>Verified kit source → explicit init or adopt</li><li>Repository-bound config and launcher</li><li>Validated NEXT → your agent session</li></ul></figure>
62 </section>
63
64 <section id="boundaries" class="band-problem"><header class="section-intro"><p class="section-kicker">Small by design</p><h2>What Overseer does — and does not do</h2></header><ul class="pain-grid"><li><span class="pain-label">Local CLI</span><p>It runs in a repository you are authorized to manage.</p></li><li><span class="pain-label">No automatic execution</span><p>It prints a task; it does not run the prompt.</p></li><li><span class="pain-label">No automatic merge</span><p>Mirror delivery may open a pull request; the operator reviews and merges.</p></li><li><span class="pain-label">No hosted product</span><p>No service, desktop app, background process, telemetry, or updater.</p></li></ul><p class="problem-close">Hooks are optional and off by default. Overseer protects against stale context and ordinary mistakes on a trusted host; it is not a security boundary against a malicious administrator.</p></section>
65
66 <section id="start"><h2>Get started</h2><p>Choose the version-control mode that matches the repository. Git-only requires no Muse installation, account, or future migration.</p><div class="card-grid suite-grid"><div class="card"><h3>Git-only</h3><p>Permanently supported. Initialize an existing Git checkout and keep all daily handoff work local.</p><p><a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Open the quickstart →</a></p></div><div class="card"><h3>Muse-only</h3><p>Explicitly initialize or adopt Muse authority. Freshness follows the selected Muse branch and revision.</p><p><a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/MIGRATE-EXISTING-REPO.md">Read adoption and rollback →</a></p></div><div class="card"><h3>Muse + GitHub mirror</h3><p>Prepare and verify a controlled projection. Explicit delivery can push the mirror and create a pull request; it never merges it.</p><p><a href="https://github.com/aaronrene/overseer-kit/blob/main/MUSE-BRIDGE-WORKFLOW.md">Read the bridge workflow →</a></p></div></div>
67 <div class="funnel" aria-label="Daily handoff path"><span class="funnel-step">Install</span><span class="funnel-arrow">→</span><span class="funnel-step">Initialize</span><span class="funnel-arrow">→</span><span class="funnel-step">Status</span><span class="funnel-arrow">→</span><span class="funnel-step">NEXT</span><span class="funnel-arrow">→</span><span class="funnel-step">Reviewed replacement</span></div>
68 </section>
69 <section id="musehub" class="musehub-band" aria-labelledby="musehub-heading"><div class="musehub-band-inner"><div class="musehub-brand"><img class="musehub-logo" src="assets/musehub-logo.svg" width="360" height="80" alt="MuseHub"></div><div class="musehub-copy"><h2 id="musehub-heading">Muse when it fits the repository</h2><p>Git-only remains a complete ongoing mode. Muse can become the explicit authority, with or without a controlled GitHub mirror. The choice belongs to each repository.</p><p class="musehub-links"><a href="#diagram-regimes">See version-control choices</a> · <a href="https://github.com/aaronrene/overseer-kit/blob/main/MUSE-BRIDGE-WORKFLOW.md">Bridge workflow</a></p></div></div></section>
70 <section id="scenarios"><h2>See it in practice</h2><p>Five bounded-v1 examples show wrong-project protection, revision freshness, Git-only use, explicit Muse adoption, and controlled mirroring.</p><p><a class="btn btn-secondary" href="scenarios/index.html">Open the scenario gallery →</a></p></section>
71 </main>
72 <footer class="site-footer"><div class="footer-inner">
73 <div><p><strong>Honesty for Agents.</strong></p><p>This website is informational. It does not run Overseer.</p><p>v1.0.0-rc.1 is a prerelease, not stable and not Latest.</p></div>
74 <div class="footer-links"><a href="https://github.com/aaronrene/overseer-kit">GitHub</a><a href="https://github.com/aaronrene/overseer-kit/blob/main/LICENSE">MIT license</a><a href="https://github.com/aaronrene/overseer-kit/blob/main/SECURITY.md">Security</a></div>
75 </div></footer></body></html>
File History 1 commit
sha256:cb0d285531d52a0703d33e76389edd88459e272649b519516caf3aef09339b11 docs: restore original site design with bounded-v1 copy Human 7 days ago