aaronrene / overseer-kit public
index.html html
201 lines 10.1 KB
Raw
sha256:a78e7e5a8740e03315f325d19edeb3aa1b306b3337d04abbaa9a9e0f3bbeb7a1 docs: MuseHub-first before ISR #74 — staging solidify NEXT Human 1 day 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 — software engineering, video studio, research, accounting, and classroom personas.">
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 personas showing how living docs and safety layers compose in practice. Each flow below is different — matching that job’s real path.</p>
39 <div class="badge-key" aria-label="Badge key">
40 <span class="badge-key-item"><span class="badge badge-dogfood">dogfood</span> in active use</span>
41 <span class="badge-key-item"><span class="badge badge-reference">reference</span> documented pattern</span>
42 <span class="badge-key-item"><span class="badge badge-aspirational">aspirational</span> illustrative only</span>
43 </div>
44 </header>
45
46 <article class="scenario-detail" id="persona-A">
47 <span class="badge badge-dogfood">dogfood</span>
48 <h2>A — Software engineering</h2>
49 <p><strong>Pain:</strong> Agents mark features DONE without freeze review; contributors lack honest phase boundaries; merges skip gates.</p>
50 <h3>How the kit helps</h3>
51 <ul class="compact">
52 <li><strong>Baseline:</strong> Public phase board + handover; design → build gates on every slice.</li>
53 <li><strong>Checkpoints:</strong> CI and domain tests as gate equivalents before merge.</li>
54 <li><strong>Dual control:</strong> Independent freeze review (local or API provider in GitHub Actions).</li>
55 <li><strong>Optional deepen:</strong> Muse mirror for provenance when history stakes rise.</li>
56 </ul>
57 <figure class="flow-diagram flow-linear diagram" aria-label="Software engineering flow">
58 <figcaption>Ship path — freeze before build; CI blocks merge</figcaption>
59 <ol class="flow-track">
60 <li>Spec freeze</li>
61 <li>Independent review</li>
62 <li>Auto build</li>
63 <li>CI gates</li>
64 <li class="flow-end">Merge</li>
65 </ol>
66 <p class="flow-aside">Review or CI red → no merge</p>
67 </figure>
68 <p>This repo ships a CI pattern as a template:
69 <a href="https://github.com/aaronrene/overseer-kit/blob/main/templates/ci/freeze-review-github-actions.yml">freeze-review workflow template</a></p>
70 </article>
71
72 <article class="scenario-detail" id="persona-B">
73 <span class="badge badge-dogfood">dogfood</span>
74 <h2>B — Video studio</h2>
75 <p><strong>Pain:</strong> Remakes, fake approvals, and “done” narration before export gates pass.</p>
76 <h3>How the kit helps</h3>
77 <ul class="compact">
78 <li><strong>Baseline:</strong> Production status board + handover per video lane.</li>
79 <li><strong>Checkpoints:</strong> Verify scripts for narration, export, QC.</li>
80 <li><strong>Dual control:</strong> Independent verifier re-runs gates; human listen-approve on the ledger.</li>
81 <li><strong>Optional deepen:</strong> Signed approvals + custody pin on Muse when provenance pays for itself.</li>
82 </ul>
83 <figure class="flow-diagram flow-converge diagram" aria-label="Video studio flow">
84 <figcaption>Production lane — scripts verify; human listens before advance</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">Status board advance</li>
95 </ol>
96 </div>
97 <p class="flow-aside">Any verify fail → remake, no board advance</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> Fabricated citations and tables that do not match source data.</p>
105 <h3>How the kit helps</h3>
106 <ul class="compact">
107 <li><strong>Checkpoints:</strong> Source URL + retrieved hash; quote span checks; table regeneration from CSV.</li>
108 <li><strong>Dual control:</strong> Verifier re-fetches sample sources; verdict binds output SHA.</li>
109 <li><strong>Optional deepen:</strong> Evidence pack as content-addressed tree for peer review snapshot.</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>Domain pack stub — not shipped in kit core.</em></p>
125 </article>
126
127 <article class="scenario-detail" id="persona-D">
128 <span class="badge badge-aspirational">aspirational</span>
129 <h2>D — Accounting close</h2>
130 <p><strong>Pain:</strong> Disputed payouts and reconciliations without dual control.</p>
131 <h3>How the kit helps</h3>
132 <ul class="compact">
133 <li><strong>Checkpoints:</strong> CSV schema + checksum; reconcile diff thresholds.</li>
134 <li><strong>Dual control:</strong> Separate prep vs review roles; verifier + human authorization on export.</li>
135 <li><strong>Optional deepen:</strong> Muse capabilities map to propose vs execute transfers.</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">Propose ≠ execute on Muse when transfers are live</p>
156 </figure>
157 <p><em>Illustrative — aspirational domain pack; no kit claim of a production close 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 skip tests and self-mark assignments complete.</p>
164 <h3>How the kit helps</h3>
165 <ul class="compact">
166 <li><strong>Baseline:</strong> Freeze → build → verification discipline on every assignment.</li>
167 <li><strong>Checkpoints:</strong> Optional assignment gates (tests green, no secrets in repo).</li>
168 <li><strong>Dual control:</strong> Optional TA verifier session before grade publish.</li>
169 <li><strong>Optional deepen:</strong> Student Muse identity for portfolio provenance.</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">Later lesson: optional Muse pin for portfolio history</p>
187 </figure>
188 <p><strong>Traffic story:</strong> Teacher installs on GitHub; later lesson offers optional Muse deepen for signed portfolio history.</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 — portable governance for AI-assisted development.</p>
199 </footer>
200 </body>
201 </html>
File History 2 commits
sha256:a78e7e5a8740e03315f325d19edeb3aa1b306b3337d04abbaa9a9e0f3bbeb7a1 docs: MuseHub-first before ISR #74 — staging solidify NEXT Human 1 day ago
sha256:4671b7f787ddbe63ced31c895b688c77ab495653b65a730b423329f26b3c1439 feat: K1-P1 complete — agent provenance, build-verification… Sonnet 4.6 patch 53 days ago