index.html
html
sha256:33412f8ca4d4d6c3b72e9f6a6097ef8395b863f35f7451bf475a3cc0fb98ce9c
docs: restore exact original site presentation
Human
7 days ago
| 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 scenario gallery — original job flows presented as bounded-v1 examples."> |
| 7 | <title>Scenario gallery — Overseer Kit</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="../index.html#how-it-works">How it works</a> |
| 23 | <a href="../index.html#structure">Structure</a> |
| 24 | <a href="../index.html#console-access">Get started</a> |
| 25 | <a href="index.html" aria-current="page">Scenarios</a> |
| 26 | <a href="../docs.html">Docs</a> |
| 27 | <button type="button" id="theme-toggle" class="theme-toggle" aria-label="Switch to light mode" title="Light / dark"> |
| 28 | <span class="theme-icon theme-icon-moon" aria-hidden="true">☾</span> |
| 29 | <span class="theme-icon theme-icon-sun" aria-hidden="true">☀</span> |
| 30 | </button> |
| 31 | </div> |
| 32 | </nav> |
| 33 | </header> |
| 34 | |
| 35 | <main class="gallery-main"> |
| 36 | <header class="gallery-intro"> |
| 37 | <h1>Scenario gallery</h1> |
| 38 | <p class="lead">Five original persona flows showing how a trusted repository handoff can support different work. Domain checks remain examples owned by each project.</p> |
| 39 | <div class="badge-key" aria-label="Badge key"> |
| 40 | <span class="badge-key-item"><span class="badge badge-dogfood">supported</span> uses shipped CLI behavior</span> |
| 41 | <span class="badge-key-item"><span class="badge badge-reference">reference</span> project-owned pattern</span> |
| 42 | <span class="badge-key-item"><span class="badge badge-aspirational">illustrative</span> example only</span> |
| 43 | </div> |
| 44 | </header> |
| 45 | |
| 46 | <article class="scenario-detail" id="persona-A"> |
| 47 | <span class="badge badge-dogfood">supported</span> |
| 48 | <h2>A — Software engineering</h2> |
| 49 | <p><strong>Pain:</strong> A new agent session starts in the wrong checkout or follows a handoff written for an older revision.</p> |
| 50 | <h3>How the kit helps</h3> |
| 51 | <ul class="compact"> |
| 52 | <li><strong>Baseline:</strong> Repository-bound status plus one validated NEXT handoff.</li> |
| 53 | <li><strong>Project checks:</strong> CI and domain tests remain owned and run by the repository.</li> |
| 54 | <li><strong>Operator review:</strong> The team reviews the task, work, and merge; Overseer does not approve them.</li> |
| 55 | <li><strong>Optional Muse:</strong> Select Muse authority and a controlled GitHub mirror when that model fits.</li> |
| 56 | </ul> |
| 57 | <figure class="flow-diagram flow-linear diagram" aria-label="Software engineering flow"> |
| 58 | <figcaption>Ship path — validate context, do the work, then use the project’s normal review</figcaption> |
| 59 | <ol class="flow-track"> |
| 60 | <li>Reviewed NEXT</li> |
| 61 | <li>Status matches</li> |
| 62 | <li>Agent works</li> |
| 63 | <li>Tests + review</li> |
| 64 | <li class="flow-end">Merge</li> |
| 65 | </ol> |
| 66 | <p class="flow-aside">Context mismatch → stop; failed project checks → no merge</p> |
| 67 | </figure> |
| 68 | <p>Start with the shipped local workflow: |
| 69 | <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Git-only quickstart</a></p> |
| 70 | </article> |
| 71 | |
| 72 | <article class="scenario-detail" id="persona-B"> |
| 73 | <span class="badge badge-dogfood">reference</span> |
| 74 | <h2>B — Video studio</h2> |
| 75 | <p><strong>Pain:</strong> A session resumes from stale production notes, and project-specific QC steps are easy to miss.</p> |
| 76 | <h3>How the kit helps</h3> |
| 77 | <ul class="compact"> |
| 78 | <li><strong>Baseline:</strong> One repository-bound NEXT identifies the reviewed production task.</li> |
| 79 | <li><strong>Project checks:</strong> The studio may keep its own narration, export, and QC scripts.</li> |
| 80 | <li><strong>Human review:</strong> A listener can approve the export through the studio’s own process.</li> |
| 81 | <li><strong>Optional Muse:</strong> Muse authority can retain repository history; the kit does not ship a video workflow.</li> |
| 82 | </ul> |
| 83 | <figure class="flow-diagram flow-converge diagram" aria-label="Video studio flow"> |
| 84 | <figcaption>Example production lane — project scripts and human review remain external to the kit</figcaption> |
| 85 | <div class="flow-split"> |
| 86 | <ol class="flow-track"> |
| 87 | <li>Narration</li> |
| 88 | <li>Export</li> |
| 89 | <li>QC scripts</li> |
| 90 | </ol> |
| 91 | <span class="flow-join" aria-hidden="true">↘</span> |
| 92 | <ol class="flow-track flow-track-short"> |
| 93 | <li>Independent listen</li> |
| 94 | <li class="flow-end">Publish through studio process</li> |
| 95 | </ol> |
| 96 | </div> |
| 97 | <p class="flow-aside">Any project check fails → revise before publish</p> |
| 98 | </figure> |
| 99 | </article> |
| 100 | |
| 101 | <article class="scenario-detail" id="persona-C"> |
| 102 | <span class="badge badge-reference">reference</span> |
| 103 | <h2>C — Research paper pipeline</h2> |
| 104 | <p><strong>Pain:</strong> A research session loses its source context or continues from stale task instructions.</p> |
| 105 | <h3>How the kit helps</h3> |
| 106 | <ul class="compact"> |
| 107 | <li><strong>Project checks:</strong> A research repository may record source URLs, hashes, quote spans, and regenerated tables.</li> |
| 108 | <li><strong>Human review:</strong> A researcher can re-fetch sources and compare the draft with project evidence.</li> |
| 109 | <li><strong>Optional Muse:</strong> Muse authority may preserve repository history when the team chooses it.</li> |
| 110 | </ul> |
| 111 | <figure class="flow-diagram flow-loop diagram" aria-label="Research pipeline flow"> |
| 112 | <figcaption>Evidence loop — re-fetch until quotes and tables match sources</figcaption> |
| 113 | <ol class="flow-track"> |
| 114 | <li>Retrieve + hash</li> |
| 115 | <li>Quote / table checks</li> |
| 116 | <li>Verifier re-fetch</li> |
| 117 | </ol> |
| 118 | <p class="flow-loop-label" aria-hidden="true">↻ mismatch → rewrite from sources</p> |
| 119 | <ol class="flow-track flow-track-short"> |
| 120 | <li class="flow-end">Bind output SHA → draft</li> |
| 121 | </ol> |
| 122 | <p class="flow-aside">Optional: pin evidence pack for peer review</p> |
| 123 | </figure> |
| 124 | <p><em>Illustrative project workflow — research checks are not shipped in kit core.</em></p> |
| 125 | </article> |
| 126 | |
| 127 | <article class="scenario-detail" id="persona-D"> |
| 128 | <span class="badge badge-aspirational">illustrative</span> |
| 129 | <h2>D — Accounting close</h2> |
| 130 | <p><strong>Pain:</strong> A close process resumes without a clear repository handoff or current reconciliation task.</p> |
| 131 | <h3>How the kit helps</h3> |
| 132 | <ul class="compact"> |
| 133 | <li><strong>Project checks:</strong> An accounting repository may define CSV schemas, checksums, and reconciliation thresholds.</li> |
| 134 | <li><strong>Human control:</strong> Separate preparation and review roles authorize any financial export.</li> |
| 135 | <li><strong>Boundary:</strong> Overseer does not execute transfers, enforce roles, or provide an accounting domain pack.</li> |
| 136 | </ul> |
| 137 | <figure class="flow-diagram flow-dual diagram" aria-label="Accounting close flow"> |
| 138 | <figcaption>Dual control — prep and review stay separate until authorize</figcaption> |
| 139 | <div class="flow-dual-cols"> |
| 140 | <ol class="flow-track"> |
| 141 | <li class="flow-role">Prep</li> |
| 142 | <li>CSV + checksum</li> |
| 143 | <li>Reconcile diffs</li> |
| 144 | </ol> |
| 145 | <ol class="flow-track"> |
| 146 | <li class="flow-role">Review</li> |
| 147 | <li>Re-run checks</li> |
| 148 | <li>Human authorize</li> |
| 149 | </ol> |
| 150 | </div> |
| 151 | <p class="flow-join-line" aria-hidden="true">↓ both green</p> |
| 152 | <ol class="flow-track flow-track-short"> |
| 153 | <li class="flow-end">Export / payout file</li> |
| 154 | </ol> |
| 155 | <p class="flow-aside">Illustrative only: financial authorization stays outside Overseer</p> |
| 156 | </figure> |
| 157 | <p><em>Illustrative only — no kit claim of a production accounting workflow.</em></p> |
| 158 | </article> |
| 159 | |
| 160 | <article class="scenario-detail" id="persona-E"> |
| 161 | <span class="badge badge-reference">reference</span> |
| 162 | <h2>E — Classroom</h2> |
| 163 | <p><strong>Pain:</strong> Students resume from copied or stale instructions and may skip the teacher’s project checks.</p> |
| 164 | <h3>How the kit helps</h3> |
| 165 | <ul class="compact"> |
| 166 | <li><strong>Baseline:</strong> A repository-bound NEXT carries the teacher’s reviewed assignment task.</li> |
| 167 | <li><strong>Project checks:</strong> The course may require tests and secret scanning before submission.</li> |
| 168 | <li><strong>Human review:</strong> A teacher or TA reviews the work; Overseer does not grade it.</li> |
| 169 | <li><strong>Optional Muse:</strong> A course may choose Muse authority; Git-only remains fully supported.</li> |
| 170 | </ul> |
| 171 | <figure class="flow-diagram flow-handoff diagram" aria-label="Classroom flow"> |
| 172 | <figcaption>Teacher sets the rails; student work cannot self-grade</figcaption> |
| 173 | <ol class="flow-track"> |
| 174 | <li class="flow-role">Teacher</li> |
| 175 | <li>Install kit</li> |
| 176 | <li>Freeze assignment</li> |
| 177 | </ol> |
| 178 | <p class="flow-join-line" aria-hidden="true">→ handoff</p> |
| 179 | <ol class="flow-track"> |
| 180 | <li class="flow-role">Student</li> |
| 181 | <li>Build</li> |
| 182 | <li>Tests green</li> |
| 183 | <li>TA verify</li> |
| 184 | <li class="flow-end">Grade publish</li> |
| 185 | </ol> |
| 186 | <p class="flow-aside">Optional later lesson: choose Muse authority explicitly</p> |
| 187 | </figure> |
| 188 | <p><strong>Boundary:</strong> This is an example teaching pattern. The kit ships repository context and handoff commands, not a classroom platform.</p> |
| 189 | </article> |
| 190 | </main> |
| 191 | |
| 192 | <footer class="site-footer"> |
| 193 | <p> |
| 194 | <a href="https://github.com/aaronrene/overseer-kit/blob/main/LICENSE">MIT</a> |
| 195 | · <a href="https://github.com/aaronrene/overseer-kit/blob/main/SECURITY.md">Security</a> |
| 196 | · <a href="../index.html">Home</a> |
| 197 | </p> |
| 198 | <p class="footer-tagline">🆗 Overseer Kit — Honesty for Agents.</p> |
| 199 | </footer> |
| 200 | </body> |
| 201 | </html> |
File History
1 commit
sha256:33412f8ca4d4d6c3b72e9f6a6097ef8395b863f35f7451bf475a3cc0fb98ce9c
docs: restore exact original site presentation
Human
7 days ago