aaronrene / overseer-kit public
index.html html
21 lines 4.6 KB
Raw
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34 docs: align public documentation and website with bounded v1 Human minor ⚠ breaking 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="Illustrative bounded-v1 scenarios: correct project, branch and revision, Git-only operation, explicit Muse adoption and controlled mirroring.">
7 <title>Scenarios — Overseer Kit</title>
8 <link rel="icon" href="../assets/favicon.ico" sizes="any">
9 <link rel="stylesheet" href="../assets/style.css">
10 <script src="../assets/theme.js" defer></script>
11 </head>
12 <body>
13 <a class="skip-link" href="#main">Skip to content</a>
14 <header class="site-header"><nav aria-label="Main navigation">
15 <a class="brand" href="../index.html"><span class="logo-mark" aria-hidden="true">OK</span> Overseer Kit</a>
16 <div class="nav-links"><a href="../index.html#how-it-works">How it works</a><a href="../docs.html">Docs</a><a href="../scenarios/">Scenarios</a><button type="button" id="theme-toggle" hidden aria-label="Switch to light mode">Theme</button></div>
17 </nav></header>
18 <main id="main"><section class="page-intro"><p class="eyebrow">SCENARIOS</p><h1>Fewer context mistakes.<br>More deliberate handoffs.</h1><p class="lead">Examples of how the bounded CLI can fit into your work.</p><p>These are illustrative scenarios, not claims of shipped project integrations or additional automated features. You choose the task and decide when to publish it.</p></section><div class="scenario-grid"><article id="persona-wrong-project" class="scenario"><span class="badge-example">Example</span><p class="eyebrow">Two similar projects</p><h2>Prevent a prompt from the wrong project</h2><p>You switch between similar repository folders. Run the repository-bound launcher in the intended checkout before copying NEXT. Identity and physical-root checks refuse a foreign binding or copied handoff.</p><p class="command-flow"><code>status → next</code></p></article><article id="persona-resume" class="scenario"><span class="badge-example">Example</span><p class="eyebrow">Returning to a branch</p><h2>Resume against the right revision</h2><p>A task written before a branch switch or later commit may be stale. Check status and NEXT. Review what changed, then explicitly publish a replacement against the current revision and prior NEXT digest.</p><p class="command-flow"><code>status → next → next-write</code></p></article><article id="persona-git-only" class="scenario"><span class="badge-example">Example</span><p class="eyebrow">A Git-only developer</p><h2>Keep the tools you already use</h2><p>Initialize a Git checkout and read its handoff locally. Git-only operation is permanent and needs no Muse package, account or later migration.</p><p class="command-flow"><code>init → status → next</code></p></article><article id="persona-adopt" class="scenario"><span class="badge-example">Example</span><p class="eyebrow">A team choosing Muse</p><h2>Choose repository authority explicitly</h2><p>Review adoption and rollback guidance, prepare the separate pinned Muse environment, and preview the change. Explicit adoption changes the selected authority; the appearance of Muse metadata alone never changes a Git binding.</p><p class="command-flow"><code>adopt</code></p></article><article id="persona-mirror" class="scenario"><span class="badge-example">Example</span><p class="eyebrow">A maintainer publishing source</p><h2>Inspect a controlled GitHub mirror</h2><p>With Muse selected, prepare a reviewed projection, verify the source and destination identities, and explicitly deliver the mirror. Delivery can create a pull request; the operator remains responsible for review and merge.</p><p class="command-flow"><code>mirror</code></p></article></div><section class="callout"><h2>Start with your own repository.</h2><p><a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/GIT-ONLY-QUICKSTART.md">Git-only quickstart</a> · <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/MIGRATE-EXISTING-REPO.md">Explicit adoption and rollback</a> · <a href="https://github.com/aaronrene/overseer-kit/blob/main/MUSE-BRIDGE-WORKFLOW.md">Controlled mirroring</a></p><p>v1.0.0-rc.1 is a prerelease. No hosted service, desktop runtime or automatic task execution is involved.</p></section></main>
19 <footer><p><strong>One repository. One trusted NEXT.</strong></p><p>This website is informational. It does not run Overseer.</p><p><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 policy</a></p></footer>
20 </body>
21 </html>
File History 1 commit
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34 docs: align public documentation and website with bounded v1 Human minor ⚠ 7 days ago