diff --git a/apps/web/app/_components/interactive-map-stage.tsx b/apps/web/app/_components/interactive-map-stage.tsx
index 0b7240a..bfbf016 100644
--- a/apps/web/app/_components/interactive-map-stage.tsx
+++ b/apps/web/app/_components/interactive-map-stage.tsx
@@ -85,8 +85,8 @@ function resultForIssue(issue: string): { example: Example; index: number } {
 
 const stageMeta: Array<{ key: StageKey; label: string; hint: string }> = [
   { key: "files", label: "Files", hint: "Finding relevant code" },
-  { key: "checks", label: "Checks", hint: "Building validations" },
-  { key: "risks", label: "Risks", hint: "Assessing impact" }
+  { key: "checks", label: "Tests", hint: "Finding checks" },
+  { key: "risks", label: "Risks", hint: "Reviewing impact" }
 ];
 
 function OutputCard({
@@ -103,9 +103,9 @@ function OutputCard({
   onSelect: () => void;
 }) {
   const config = {
-    files: { icon: FileText, title: "Files to inspect", count: "7 files", metric: "Confidence", value: "High" },
-    checks: { icon: CheckCircle, title: "Checks to run", count: "8 checks", metric: "Confidence", value: "High" },
-    risks: { icon: Warning, title: "Risks to review", count: "6 risks", metric: "Impact", value: "Medium" }
+    files: { icon: FileText, title: "Files to open first", count: "7 files", metric: "Match", value: "Strong" },
+    checks: { icon: CheckCircle, title: "Tests and checks", count: "8 checks", metric: "Support", value: "Found" },
+    risks: { icon: Warning, title: "Risks worth reviewing", count: "6 risks", metric: "Impact", value: "Medium" }
   }[stage];
   const Icon = config.icon;
 
@@ -125,7 +125,7 @@ function OutputCard({
       <span className="stage-card-rows">
         {items.map((item, index) => (
           <span key={item} style={{ "--row-index": index } as CSSProperties}>
-            <b>{index + 1}</b><code>{ready ? item : "Scanning repository signals…"}</code><small>{stage === "files" ? (index === 0 ? "Exact match" : "High signal") : stage === "checks" ? "Evidence" : "Why"}</small>
+            <b>{index + 1}</b><code>{ready ? item : "Scanning the repository…"}</code><small>{stage === "files" ? (index === 0 ? "Strong match" : "Connected") : stage === "checks" ? "Suggested" : "Why it matters"}</small>
           </span>
         ))}
       </span>
@@ -195,12 +195,12 @@ export function InteractiveMapStage() {
           </select>
           <CaretDown size={14} weight="bold" aria-hidden />
         </label>
-        <span className="stage-local-status"><i /> Local demo</span>
+        <span className="stage-local-status"><i /> Runs here</span>
       </div>
 
       <div className="stage-body">
         <div className="stage-input-column">
-          <div className="stage-input-heading"><span>1</span><strong>Describe the issue<br />in plain English</strong></div>
+          <div className="stage-input-heading"><span>1</span><strong>Describe what needs fixing</strong></div>
           <div className="stage-issue-field">
             <label className="sr-only" htmlFor="fixmap-hero-issue">Software issue</label>
             <textarea id="fixmap-hero-issue" value={issue} maxLength={500} onChange={(event) => setIssue(event.target.value)} />
@@ -209,7 +209,7 @@ export function InteractiveMapStage() {
               <ArrowRight size={19} weight="bold" aria-hidden />
             </button>
           </div>
-          <div className="stage-trust-note"><ShieldCheck size={19} weight="duotone" aria-hidden /><span><strong>Starting map, not proof.</strong>Review results before making changes.</span></div>
+          <div className="stage-trust-note"><ShieldCheck size={19} weight="duotone" aria-hidden /><span><strong>A starting point, not a verdict.</strong>Open the files and run the checks before changing code.</span></div>
         </div>
 
         <div className="stage-output-column">
diff --git a/apps/web/app/_components/site-header.tsx b/apps/web/app/_components/site-header.tsx
index 5e2be49..e482841 100644
--- a/apps/web/app/_components/site-header.tsx
+++ b/apps/web/app/_components/site-header.tsx
@@ -23,9 +23,9 @@ function NavLinks() {
           Get started <CaretDown size={14} weight="bold" aria-hidden />
         </summary>
         <div className="nav-dropdown-panel">
-          <Link href="/get-started#cli"><strong>CLI</strong><span>Run FixMap from a terminal</span></Link>
-          <Link href="/get-started#mcp"><strong>MCP</strong><span>Connect a coding agent</span></Link>
-          <Link href="/get-started#action"><strong>GitHub Action</strong><span>Map every pull request</span></Link>
+          <Link href="/get-started#agent"><strong>Coding agent</strong><span>Add the /fixmap command</span></Link>
+          <Link href="/get-started#terminal"><strong>Terminal</strong><span>Try or install the CLI</span></Link>
+          <Link href="/get-started#pull-requests"><strong>Pull requests</strong><span>Post a map automatically</span></Link>
         </div>
       </details>
       <a className="nav-github" href={repoUrl}>
diff --git a/apps/web/app/demo.tsx b/apps/web/app/demo.tsx
index cf58109..562e59b 100644
--- a/apps/web/app/demo.tsx
+++ b/apps/web/app/demo.tsx
@@ -10,15 +10,15 @@ type Stage = "plan" | "explain" | "compare" | "verify";
 const presets = [
   {
     label: "Password reset emails never arrive",
-    note: "A symptom with no symbol. This is where a lexical ranker is weakest — watch what happens in the next preset."
+    note: "Start here. The task describes a symptom without naming a file or code symbol, so FixMap has to find the strongest repository signals."
   },
   {
     label: "sendMail throws and password reset emails never arrive",
-    note: "The same bug with one symbol named. The transport rises into the top three, and its reason says why: it defines sendMail."
+    note: "The same problem now names sendMail. Watch the email transport move to the top because that file defines the symbol."
   },
   {
     label: "TOKEN_TTL_MINUTES is ignored, reset links expire immediately",
-    note: "A named constant is the strongest anchor there is. The file that defines it wins outright."
+    note: "A named constant gives FixMap a strong anchor. The file that defines it moves to the top."
   },
   {
     label: "Invoices are created twice for the same customer",
@@ -26,7 +26,7 @@ const presets = [
   },
   {
     label: "make it better",
-    note: "No searchable anchor. FixMap reports nothing and says so, instead of ranking something plausible."
+    note: "This task is too vague to ground. FixMap returns no suggestions instead of presenting a plausible guess as evidence."
   }
 ];
 
@@ -126,10 +126,10 @@ export function Demo() {
       <div className="stage-tabs" role="group" aria-label="FixMap stages">
         {(
           [
-            ["plan", "1 · Plan", "Where do I start?"],
-            ["explain", "2 · Ask why", "Why not this file?"],
-            ["compare", "3 · Compare", "Did better context move?"],
-            ["verify", "4 · Verify", "Did the change match?"]
+            ["plan", "1 · Find files", "Where should I start?"],
+            ["explain", "2 · Ask why", "Why this file?"],
+            ["compare", "3 · Refine task", "Did the result improve?"],
+            ["verify", "4 · Check change", "Did the work drift?"]
           ] as const
         ).map(([value, label, hint]) => (
           <button
@@ -147,9 +147,9 @@ export function Demo() {
 
       <div className="demo-shell">
         <div className="demo-input">
-          <label htmlFor="task">The task</label>
+          <label htmlFor="task">Describe the software problem</label>
           <textarea id="task" value={task} onChange={(event) => setTask(event.target.value)} rows={3} />
-          <div className="preset-list" role="group" aria-label="Example tasks">
+          <div className="preset-list" role="group" aria-label="Example software problems">
             {presets.map((preset) => (
               <button
                 key={preset.label}
@@ -163,22 +163,23 @@ export function Demo() {
           </div>
           {activePreset ? <p className="preset-note">{activePreset.note}</p> : null}
 
-          <label className="picker-label" htmlFor="context-limit">Context limit: {limit}</label>
-          <input id="context-limit" type="range" min="1" max="8" value={limit} onChange={(event) => setLimit(Number(event.target.value))} />
-          <label className="picker-label"><input type="checkbox" checked={excludeBuild} onChange={(event) => setExcludeBuild(event.target.checked)} /> Exclude generated <code>dist/**</code></label>
-          <label className="picker-label"><input type="checkbox" checked={workingTree} onChange={(event) => setWorkingTree(event.target.checked)} /> Include the selected scenario as a working-tree change set</label>
-
-          <p className="demo-command">
-            <span>Same result from the CLI</span>
-            <code>{command}</code>
-          </p>
+          <details className="demo-advanced">
+            <summary>Adjust limits, exclusions, and CLI output</summary>
+            <label className="picker-label" htmlFor="context-limit">Maximum file suggestions: {limit}</label>
+            <input id="context-limit" type="range" min="1" max="8" value={limit} onChange={(event) => setLimit(Number(event.target.value))} />
+            <label className="picker-label"><input type="checkbox" checked={excludeBuild} onChange={(event) => setExcludeBuild(event.target.checked)} /> Ignore generated <code>dist/**</code> files</label>
+            <label className="picker-label"><input type="checkbox" checked={workingTree} onChange={(event) => setWorkingTree(event.target.checked)} /> Include unsaved working-tree changes</label>
+            <p className="demo-command">
+              <span>Run the same example from a terminal</span>
+              <code>{command}</code>
+            </p>
+          </details>
 
           <div className="privacy-note">
             <span aria-hidden="true">●</span>
             <p>
-              <strong>This is FixMap itself, not a mockup.</strong> The page imports the same
-              ranking, explanation, and verification code the CLI runs, and executes it on a
-              sample repository in your browser. Nothing you type is sent anywhere.
+              <strong>This is the real FixMap engine.</strong> It runs on a sample repository in
+              this tab. Nothing you type is uploaded.
             </p>
           </div>
         </div>
@@ -210,8 +211,8 @@ function PlanPanel({ report }: { report: ReturnType<typeof buildReportFromRepo>
   return (
     <>
       <div className="results-head">
-        <span>Context files</span>
-        <small>{report.contextFiles.length} ranked</small>
+        <span>Files to inspect first</span>
+        <small>{report.contextFiles.length} suggestions</small>
       </div>
 
       {report.contextFiles.length > 0 ? (
@@ -220,30 +221,34 @@ function PlanPanel({ report }: { report: ReturnType<typeof buildReportFromRepo>
             <span className="result-number">{String(index + 1).padStart(2, "0")}</span>
             <div>
               <code>{file.path}</code>
-              <p>{file.reasons.join("; ")}</p>
+              <details className="result-reasons">
+                <summary>Why FixMap suggested this file</summary>
+                <p>{file.reasons.join("; ")}</p>
+                <small>Ranking score: {file.score}</small>
+              </details>
             </div>
             <span className={`confidence ${file.confidence}`}>
-              {file.confidence} · {file.score}
+              {file.confidence} match
             </span>
           </article>
         ))
       ) : (
         <div className="empty-result">
-          <strong>Nothing ranked.</strong>
-          <p>FixMap returns an empty report rather than a plausible guess.</p>
+          <strong>FixMap could not ground this task.</strong>
+          <p>Add a symptom, file name, or code symbol. FixMap will not invent a confident-looking result for a vague request.</p>
         </div>
       )}
 
       {report.testRoutes.length > 0 ? (
         <div className="route-preview">
-          <span>Run this</span>
+          <span>Test or check to run</span>
           <code>{report.testRoutes[0]!.command}</code>
         </div>
       ) : null}
 
       {report.impact?.files.length ? (
         <div className="panel-block">
-          <p className="panel-heading">Likely impact · inspect, not assumed edits</p>
+          <p className="panel-heading">Other files this change may affect</p>
           {report.impact.files.slice(0, 5).map((file) => (
             <p key={file.path}>
               <span className={`severity ${file.confidence === "high" ? "warning" : "info"}`}>{file.confidence}</span>
@@ -260,7 +265,7 @@ function PlanPanel({ report }: { report: ReturnType<typeof buildReportFromRepo>
 
       {report.risks.length > 0 ? (
         <div className="panel-block">
-          <p className="panel-heading">Risk</p>
+          <p className="panel-heading">Risks worth reviewing</p>
           {report.risks.map((risk) => (
             <p key={risk.area}>
               <span className={`severity ${risk.severity}`}>{risk.severity}</span>
@@ -331,10 +336,8 @@ function ExplainPanel({
       ) : null}
 
       <p className="panel-footnote">
-        A ranked list explains what it chose. This answers the question it cannot: why the file
-        you expected is missing. The four answers are genuinely different — it ranked lower than
-        you thought, it scored below the cutoff, it was excluded on purpose, or the scan never
-        saw it.
+        This tells you whether the file ranked lower, fell below the cutoff, was excluded on
+        purpose, or was never scanned.
       </p>
     </>
   );
@@ -351,7 +354,7 @@ function ComparePanel({ comparison }: { comparison: ReturnType<typeof compareRep
   ];
   return (
     <>
-      <div className="results-head"><span>Earlier plan vs. current task</span><small>{changes.length} changed</small></div>
+      <div className="results-head"><span>What changed after you clarified the task</span><small>{changes.length} changes</small></div>
       <p className="explain-summary">{comparison.summary}</p>
       {changes.map((delta) => (
         <article className="finding" key={`${delta.status}-${delta.path}`}>
@@ -359,7 +362,7 @@ function ComparePanel({ comparison }: { comparison: ReturnType<typeof compareRep
           <div><code>{delta.path}</code><p>rank {delta.previousRank ?? "—"} → {delta.currentRank ?? "—"}; score {delta.previousScore ?? "—"} → {delta.currentScore ?? "—"}</p></div>
         </article>
       ))}
-      <p className="panel-footnote">Compare makes task refinement measurable: save a JSON plan, add the missing symbol or path, and confirm the real fix site rises.</p>
+      <p className="panel-footnote">A clearer task should move the real fix site closer to the top. Compare shows whether it actually did.</p>
     </>
   );
 }
@@ -378,9 +381,9 @@ function VerifyPanel({
   return (
     <>
       <div className="results-head">
-        <span>Plan vs. diff</span>
+        <span>Planned work vs. changed files</span>
         <small className={hasError ? "status-excluded" : "status-ranked"}>
-          exit {hasError ? 1 : 0}
+          {hasError ? "Needs review" : "No blocking errors"}
         </small>
       </div>
 
diff --git a/apps/web/app/demo/page.tsx b/apps/web/app/demo/page.tsx
index 1bf7913..b764ca1 100644
--- a/apps/web/app/demo/page.tsx
+++ b/apps/web/app/demo/page.tsx
@@ -7,11 +7,11 @@ import { sampleRepo, sampleRepoWithChanges } from "../sample-repo";
 
 export const metadata: Metadata = {
   title: "Live demo",
-  description: "Try FixMap Plan, Explain, Compare, focus controls, and Verify on a sample repository in your browser.",
+  description: "Give FixMap a sample task and see the files, tests, impact, and risks it surfaces before a change begins.",
   alternates: { canonical: "/demo" },
   openGraph: {
     title: "Live FixMap demo",
-    description: "Run the real FixMap ranking and verification engine in your browser.",
+    description: "See the real FixMap engine choose files, tests, impact, and risks in your browser.",
     url: "/demo"
   }
 };
@@ -30,15 +30,15 @@ export default function DemoPage() {
     <main>
       <section className="subpage-hero compact-hero page-shell">
         <p className="eyebrow">Live demo</p>
-        <h1>See the map form <em>in real time.</em></h1>
+        <h1>See FixMap choose <em>where to start.</em></h1>
         <p>
-          Try Plan, Explain, Compare, exclusions, limits, and Verify against a small sample repository. This is the same core
-          logic used by the CLI, running locally in your browser—not a recording or staged result.
+          Pick a sample software problem. FixMap will show the files to inspect first, the checks that can prove the change,
+          nearby impact, and risks worth reviewing. The real engine runs below—not a recording or staged result.
         </p>
         <div className="inline-facts">
-          <span><Browser size={20} aria-hidden /> Runs in this tab</span>
+          <span><Browser size={20} aria-hidden /> Real FixMap engine</span>
           <span><LockKey size={20} aria-hidden /> Nothing is uploaded</span>
-          <span><Sparkle size={20} aria-hidden /> Start with the first preset</span>
+          <span><Sparkle size={20} aria-hidden /> Choose an example below</span>
         </div>
       </section>
 
@@ -48,12 +48,14 @@ export default function DemoPage() {
 
       <section className="section page-shell">
         <div className="premium-section-intro compact">
-          <p className="eyebrow">Example agent conversation</p>
-          <h2>Plan → edit carefully → verify.</h2>
-          <p>The FixMap turns below are generated from this page&rsquo;s sample repository at build time, using the same renderer as the CLI.</p>
+          <p className="eyebrow">Optional technical detail</p>
+          <h2>See the complete agent conversation.</h2>
+          <p>Open the transcript to follow the exact Plan → edit → Verify workflow generated from this sample repository.</p>
         </div>
 
-        <div className="doc-layout">
+        <details className="demo-transcript">
+          <summary>Open the complete Plan → edit → Verify example</summary>
+          <div className="doc-layout">
           <article className="doc-section">
             <h3>User</h3>
             <p>{agentTask}. Can you fix it?</p>
@@ -106,12 +108,13 @@ const transport = createTransport({
               <li><strong>Run tests:</strong> FixMap routes checks; it does not pretend to execute them.</li>
             </ol>
           </aside>
-        </div>
+          </div>
+        </details>
       </section>
 
       <section className="section page-shell demo-next">
-        <div><p className="eyebrow">Ready for your repository?</p><h2>Take the same workflow to the terminal.</h2></div>
-        <div><p>Run one command for a public GitHub issue, or use FixMap locally for private source and working-tree diffs.</p><Link className="button primary" href="/get-started">Choose a setup <ArrowRight size={18} weight="bold" aria-hidden /></Link></div>
+        <div><p className="eyebrow">Ready for your repository?</p><h2>Give the next task a better starting point.</h2></div>
+        <div><p>Try FixMap once, add <code>/fixmap</code> to a coding agent, or run it automatically on pull requests.</p><Link className="button primary" href="/get-started">Choose how to use FixMap <ArrowRight size={18} weight="bold" aria-hidden /></Link></div>
       </section>
     </main>
   );
diff --git a/apps/web/app/get-started/page.tsx b/apps/web/app/get-started/page.tsx
index 344e80f..5e8a405 100644
--- a/apps/web/app/get-started/page.tsx
+++ b/apps/web/app/get-started/page.tsx
@@ -6,11 +6,11 @@ import { commands, marketplaceUrl, repoUrl, siteStats } from "../_lib/site-data"
 
 export const metadata: Metadata = {
   title: "Get started",
-  description: "Install the /fixmap command, run the CLI, connect MCP, or add FixMap to pull requests with the GitHub Action.",
+  description: "Try FixMap once, add /fixmap to a coding agent, run it in a terminal, or add it to pull requests.",
   alternates: { canonical: "/get-started" },
   openGraph: {
     title: "Get started with FixMap",
-    description: "Install /fixmap, use the CLI, connect MCP, or add the GitHub Action.",
+    description: "Try FixMap once, add it to a coding agent, or run it automatically on pull requests.",
     url: "/get-started"
   }
 };
@@ -19,57 +19,66 @@ export default function GetStartedPage() {
   return (
     <main>
       <section className="subpage-hero page-shell">
-        <p className="eyebrow">Get started</p>
-        <h1>Choose where the map <em>should appear.</em></h1>
-        <p>Install the CLI once, add a discoverable slash command to a coding agent, connect the MCP tools, or publish a map automatically on pull requests.</p>
-        <div className="jump-links"><a href="#slash-command">/fixmap</a><a href="#cli">CLI</a><a href="#mcp">MCP</a><a href="#action">GitHub Action</a></div>
+        <p className="eyebrow">Fastest way to try FixMap</p>
+        <h1>Run it once. <em>Install it only if it helps.</em></h1>
+        <p>Paste this command into a terminal. FixMap will inspect a public GitHub issue, scan a temporary checkout, show where to start, and remove the checkout when it finishes.</p>
+        <div className="setup-quick-try">
+          <CopyCommand command="npx -y @aryam/fixmap@latest plan --issue https://github.com/chalk/chalk/issues/624" />
+          <p>Requires Node.js 20.11 or newer. No account, API key, model call, or global installation.</p>
+        </div>
+        <div className="jump-links" aria-label="Choose a FixMap setup"><a href="#agent">Coding agent</a><a href="#terminal">Terminal</a><a href="#pull-requests">Pull requests</a><a href="#mcp">Advanced MCP</a></div>
       </section>
 
-      <section className="setup-section page-shell" id="slash-command">
-        <div className="setup-heading"><span>01</span><Command size={34} aria-hidden /><div><p className="eyebrow">Slash command</p><h2>Type /fixmap. See every workflow.</h2></div></div>
+      <section className="setup-section page-shell" id="agent">
+        <div className="setup-heading"><span>01</span><Command size={34} aria-hidden /><div><p className="eyebrow">Recommended for coding agents</p><h2>Add /fixmap to your agent.</h2></div></div>
         <div className="setup-content">
-          <p className="setup-lede">Install project-level discovery for Claude Code, Cursor, GitHub Copilot, and Agent Skills. Invoking <code>/fixmap</code> without a task opens the complete Plan, Context, Graph, Explain, Compare, Watch, Verify, Benchmark, Validate, Doctor, MCP, focus, working-tree, and fresh-scan menu.</p>
-          <CopyCommand command={commands.setup} />
-          <p>The installer is idempotent and refuses to overwrite an existing customized command. Target one integration with <code>--agent claude</code>, <code>cursor</code>, <code>copilot</code>, or <code>agents</code>. Use <code>--force</code> only after reviewing the file.</p>
-          <h3>See the same menu in a terminal</h3>
-          <CopyCommand command={commands.features} />
+          <p className="setup-lede">Choose this path if you use Claude Code, Cursor, GitHub Copilot, or Agent Skills. Two commands install FixMap and make <code>/fixmap</code> discoverable in the current project.</p>
+          <ol className="setup-steps">
+            <li><strong>Install FixMap</strong><CopyCommand command="npm install --global @aryam/fixmap@latest" /></li>
+            <li><strong>Add the agent command</strong><CopyCommand command={commands.setup} /></li>
+            <li><strong>Use it</strong><p>Type <code>/fixmap</code> in your coding agent, then choose Plan before editing or Verify after the change.</p></li>
+          </ol>
+          <details className="setup-advanced">
+            <summary>Choose one specific agent or inspect every workflow</summary>
+            <p>Target one integration with <code>--agent claude</code>, <code>cursor</code>, <code>copilot</code>, or <code>agents</code>. The installer will not overwrite a customized command unless you explicitly use <code>--force</code>.</p>
+            <CopyCommand command={commands.features} />
+          </details>
         </div>
       </section>
 
-      <section className="setup-section page-shell" id="cli">
-        <div className="setup-heading"><span>02</span><TerminalWindow size={34} aria-hidden /><div><p className="eyebrow">CLI</p><h2>Install once. Keep the command short.</h2></div></div>
+      <section className="setup-section page-shell" id="terminal">
+        <div className="setup-heading"><span>02</span><TerminalWindow size={34} aria-hidden /><div><p className="eyebrow">Terminal</p><h2>Install once. Describe the task.</h2></div></div>
         <div className="setup-content">
-          <p className="setup-lede">Install FixMap globally, then paste a public GitHub issue URL. FixMap fetches the task, infers the repository, scans a temporary checkout, and removes it when the report is done.</p>
+          <p className="setup-lede">Install FixMap globally, then give it a public issue URL or describe a problem inside a local repository.</p>
           <CopyCommand command="npm install --global @aryam/fixmap@latest" />
           <CopyCommand command={commands.publicIssue} />
-          <h3>Or work inside a local repository</h3>
-          <CopyCommand command={commands.localTask} />
-          <CopyCommand command={commands.diff} />
-          <h3>Compact agent handoff</h3>
-          <CopyCommand command={'fixmap plan --issue "reset links fail" --format agent'} />
-          <h3>Budgeted source context</h3>
-          <CopyCommand command={commands.context} />
-          <h3>Portable Impact Graph</h3>
-          <CopyCommand command={commands.graph} />
-          <h3>Watch an agent&apos;s edits</h3>
-          <p>Save the JSON plan, then stream drift and recalculated-impact updates whenever the local working tree changes:</p>
-          <CopyCommand command={'fixmap watch --report plan.json --repo . --include-untracked'} />
-          <h3>Benchmark this repository</h3>
-          <p>Backtest BM25, FixMap, and Impact Graph on historical parent snapshots without running repository code:</p>
-          <CopyCommand command="fixmap benchmark --repo . --last 50" />
+          <p className="setup-result"><strong>What you get:</strong> a short list of files to inspect first, tests and checks to run, nearby impact, and risks worth reviewing.</p>
+          <details className="setup-advanced">
+            <summary>Show local repository and advanced commands</summary>
+            <h3>Work inside a local repository</h3>
+            <CopyCommand command={commands.localTask} />
+            <CopyCommand command={commands.diff} />
+            <h3>Prepare a compact handoff for an agent</h3>
+            <CopyCommand command={'fixmap plan --issue "reset links fail" --format agent'} />
+            <h3>Package source context within a budget</h3>
+            <CopyCommand command={commands.context} />
+            <h3>Export the impact relationships</h3>
+            <CopyCommand command={commands.graph} />
+            <h3>Watch an agent&apos;s edits</h3>
+            <CopyCommand command={'fixmap watch --report plan.json --repo . --include-untracked'} />
+            <h3>Benchmark this repository</h3>
+            <CopyCommand command="fixmap benchmark --repo . --last 50" />
+            <h3>Pin FixMap to a project</h3>
+            <CopyCommand command="npm install --save-dev @aryam/fixmap" />
+            <p>Use <code>npx fixmap</code> inside that repository or call it from an npm script.</p>
+          </details>
 
-          <h3>Pin it to a project instead</h3>
-          <p>Use a project dependency when everyone working on that repository should get the same version:</p>
-          <CopyCommand command="npm install --save-dev @aryam/fixmap" />
-          <p>A project install is reached with <code>npx fixmap</code> inside the repository, or from an npm script.</p>
-
-          <h3>One-off trial without installing</h3>
-          <CopyCommand command="npx -y @aryam/fixmap@latest plan --issue https://github.com/chalk/chalk/issues/624" />
-          <p>If the current directory or one of its parents already contains FixMap, npm may deliberately choose that project-local binary. Check <code>--version</code>, or use the isolated-prefix test below when the exact package version matters.</p>
-
-          <h3>Safe PowerShell test project</h3>
-          <p>Create the directory before changing into it. If <code>cd</code> fails, PowerShell stays in the previous directory and a project-scoped npm install will go there instead.</p>
-          <CopyCommand command={`$fixmapTestPath = Join-Path $env:USERPROFILE "fixmaptesting"
+          <details className="setup-advanced">
+            <summary>Troubleshoot versions and make an isolated PowerShell test</summary>
+            <p>Run <code>fixmap doctor</code> when an older project or global install may be shadowing the version you expected.</p>
+            <CopyCommand command="fixmap doctor" />
+            <p>For an exact clean test on Windows, create the directory before changing into it:</p>
+            <CopyCommand command={`$fixmapTestPath = Join-Path $env:USERPROFILE "fixmaptesting"
 New-Item -ItemType Directory -Path $fixmapTestPath -Force -ErrorAction Stop | Out-Null
 Set-Location $fixmapTestPath -ErrorAction Stop
 npm init -y
@@ -82,21 +91,16 @@ export async function resetPassword(email: string) {
 }
 '@
 npx fixmap plan --issue "password reset emails fail"`} />
-          <p>Use <code>Get-Location</code> before installing whenever a directory command reports an error.</p>
-
-          <h3>Check what you are actually running</h3>
-          <p>An older global install can shadow the version <code>npx</code> was asked for, which makes a feature that shipped look like it never existed. <code>doctor</code> reports the version in use, where it resolved from, and any conflicting global — and exits non-zero when it finds one:</p>
-          <CopyCommand command="fixmap doctor" />
-          <p>Doctor 0.8.4 and newer compares an exact npm-requested version when that newer Doctor is the process npm starts. An older project-local binary can win before the newer code starts, so treat the printed running version as authoritative. For an exact clean test, use the isolated-prefix/direct-shim procedure in the repository README.</p>
-
-          <p className="small-note">Requires Node.js 20.11 or newer. No account, API key, or model call at any point.</p>
+            <p>Use <code>Get-Location</code> before installing whenever a directory command reports an error. Treat the version printed by Doctor as the version actually running.</p>
+          </details>
+          <p className="small-note">Requires Node.js 20.11 or newer. FixMap runs locally with no account, API key, or model call.</p>
         </div>
       </section>
 
       <section className="setup-section page-shell" id="mcp">
-        <div className="setup-heading"><span>03</span><Robot size={34} aria-hidden /><div><p className="eyebrow">MCP</p><h2>Let the agent ask.</h2></div></div>
+        <div className="setup-heading"><span>03</span><Robot size={34} aria-hidden /><div><p className="eyebrow">Advanced agent setup</p><h2>Connect FixMap as tools your agent can call.</h2></div></div>
         <div className="setup-content">
-          <p className="setup-lede">FixMap exposes seven local stdio tools: <code>fixmap_plan</code>, <code>fixmap_context</code>, <code>fixmap_graph</code>, <code>fixmap_explain</code>, <code>fixmap_compare</code>, <code>fixmap_verify</code>, and <code>fixmap_doctor</code>.</p>
+          <p className="setup-lede">Use MCP when you want a compatible agent to request a plan, ask why a file was included or missed, package source context, inspect impact relationships, or verify a completed change.</p>
           <h3>Claude Code</h3>
           <CopyCommand command="claude mcp add fixmap -- fixmap mcp" />
           <h3>Cursor, Windsurf, and other MCP clients</h3>
@@ -112,10 +116,10 @@ npx fixmap plan --issue "password reset emails fail"`} />
         </div>
       </section>
 
-      <section className="setup-section page-shell" id="action">
-        <div className="setup-heading"><span>04</span><GithubLogo size={34} weight="fill" aria-hidden /><div><p className="eyebrow">GitHub Action</p><h2>Map every pull request.</h2></div></div>
+      <section className="setup-section page-shell" id="pull-requests">
+        <div className="setup-heading"><span>04</span><GithubLogo size={34} weight="fill" aria-hidden /><div><p className="eyebrow">Pull requests</p><h2>Post a FixMap report automatically.</h2></div></div>
         <div className="setup-content">
-          <p className="setup-lede">The Action posts one report as a pull-request comment and writes the complete result to the job summary. Set <code>no-cache: true</code> when a workflow needs an explicit fresh scan.</p>
+          <p className="setup-lede">The GitHub Action comments with the map on each pull request and writes the complete result to the job summary.</p>
           <pre className="code-block" tabIndex={0}><code>{`name: FixMap
 on:
   pull_request:
diff --git a/apps/web/app/globals.css b/apps/web/app/globals.css
index 3a0328c..3189fc4 100644
--- a/apps/web/app/globals.css
+++ b/apps/web/app/globals.css
@@ -192,16 +192,20 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .stage-tab small { color: var(--ink); opacity: 1; }
 .stage-tab.active small { color: inherit; }
 .demo-shell { display: grid; grid-template-columns: .9fr 1.1fr; min-height: 650px; }
-.demo-input, .demo-results { padding: 38px; }
+.demo-input, .demo-results { min-width: 0; padding: 38px; }
 .demo-input { border-right: 1px solid var(--line); background: var(--paper); }
 .demo-input label, .picker-label { display: block; margin-bottom: 9px; color: var(--ink-soft); font-weight: 650; font-size: 13px; }
 .demo-input textarea, .picker { width: 100%; border: 1px solid var(--line-strong); border-radius: 8px; background: var(--paper-light); color: var(--ink); }
 .demo-input textarea { padding: 14px; resize: vertical; }
 .picker { height: 46px; padding: 0 12px; }
 .preset-list { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 14px; }
-.preset-list button { padding: 8px 10px; border: 1px solid var(--line); border-radius: 6px; background: transparent; color: var(--ink-soft); font-size: 12px; cursor: pointer; }
+.preset-list button { max-width: 100%; padding: 8px 10px; border: 1px solid var(--line); border-radius: 6px; background: transparent; color: var(--ink-soft); font-size: 12px; overflow-wrap: anywhere; cursor: pointer; }
 .preset-list button[aria-pressed="true"] { border-color: var(--green); background: var(--mint-soft); color: var(--green-dark); }
 .preset-note { margin-top: 16px; color: var(--ink-soft); font-size: 13px; }
+.demo-advanced { margin-top: 20px; padding-block: 16px; border-block: 1px solid var(--line); }
+.demo-advanced summary, .result-reasons summary, .demo-transcript > summary, .setup-advanced > summary { color: var(--green-dark); font-weight: 650; cursor: pointer; }
+.demo-advanced[open] summary, .setup-advanced[open] > summary { margin-bottom: 18px; }
+.demo-advanced .picker-label { margin-top: 16px; }
 .demo-command { margin-top: 26px; display: grid; gap: 8px; }
 .demo-command span { color: var(--ink-faint); font-size: 12px; }
 .demo-command code, .changed-list code { padding: 8px 10px; border-radius: 6px; background: var(--navy); color: var(--mint); font: 12px/1.5 var(--font-mono), monospace; overflow-wrap: anywhere; }
@@ -215,6 +219,9 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .result-number { color: var(--green); font: 12px var(--font-mono), monospace; }
 .result code { color: var(--ink); font: 13px var(--font-mono), monospace; overflow-wrap: anywhere; }
 .result p { margin: 5px 0 0; color: var(--ink-faint); font-size: 12px; }
+.result-reasons { margin-top: 7px; }
+.result-reasons summary { color: var(--ink-soft); font-size: 12px; }
+.result-reasons small { display: block; margin-top: 7px; color: var(--ink-faint); font-size: 11px; }
 .confidence, .severity { align-self: start; padding: 4px 7px; border-radius: 4px; background: var(--mint-soft); color: var(--green-dark); font: 600 10px var(--font-mono), monospace; text-transform: uppercase; }
 .confidence.low, .severity.warning { background: #f6e8d9; color: var(--warning); }
 .severity.error { background: #f6dfe4; color: var(--danger); }
@@ -237,6 +244,9 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .empty-result p { margin: 0; color: var(--ink-soft); }
 .demo-next { display: grid; grid-template-columns: 1fr 1fr; gap: 90px; border-top: 1px solid var(--line); }
 .demo-next > div:last-child p { color: var(--ink-soft); font-size: 18px; }
+.demo-transcript { margin-top: 38px; border-top: 1px solid var(--line-strong); }
+.demo-transcript > summary { padding: 22px 0; font-size: 17px; }
+.demo-transcript .doc-layout { margin-top: 10px; }
 
 /* Evidence */
 .score-grid { display: grid; grid-template-columns: repeat(2, 1fr); border: 1px solid var(--line-strong); border-radius: 16px; overflow: hidden; }
@@ -279,6 +289,8 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 /* Setup and docs */
 .jump-links { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 34px; }
 .jump-links a { padding: 9px 14px; border: 1px solid var(--line-strong); border-radius: 6px; color: var(--green-dark); text-decoration: none; font-weight: 620; }
+.setup-quick-try { max-width: 900px; margin-top: 34px; }
+.setup-quick-try > p { margin: 10px 0 0; color: var(--ink-faint); font-size: 13px; }
 .setup-section { padding-block: 90px; display: grid; grid-template-columns: minmax(0, .65fr) minmax(0, 1.35fr); gap: 100px; border-top: 1px solid var(--line); }
 .setup-heading { min-width: 0; display: grid; grid-template-columns: 50px 40px minmax(0, 1fr); align-items: start; gap: 10px; }
 .setup-heading > div { min-width: 0; }
@@ -288,6 +300,15 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .setup-content { min-width: 0; max-width: 820px; }
 .setup-lede { color: var(--ink-soft); font-size: 19px; }
 .setup-content h3 { margin: 34px 0 12px; }
+.setup-steps { margin: 28px 0 0; padding: 0; list-style: none; counter-reset: setup-step; border-top: 1px solid var(--line); }
+.setup-steps > li { position: relative; padding: 24px 0 24px 46px; counter-increment: setup-step; border-bottom: 1px solid var(--line); }
+.setup-steps > li::before { content: counter(setup-step); position: absolute; top: 26px; left: 0; width: 27px; height: 27px; display: grid; place-items: center; border: 1px solid var(--green); border-radius: 50%; color: var(--green-dark); font: 600 11px var(--font-mono), monospace; }
+.setup-steps strong { display: block; margin-bottom: 12px; font-size: 17px; }
+.setup-steps p { margin: 0; color: var(--ink-soft); }
+.setup-advanced { margin-top: 24px; padding-block: 18px; border-block: 1px solid var(--line); }
+.setup-advanced + .setup-advanced { margin-top: 12px; }
+.setup-advanced > p { color: var(--ink-soft); }
+.setup-result { margin: 24px 0 0; padding-block: 18px; border-block: 1px solid var(--line); color: var(--ink-soft); }
 .small-note { margin-top: 18px; color: var(--ink-faint); font-size: 13px; }
 .copy-command { min-height: 64px; padding: 10px 10px 10px 18px; display: flex; align-items: center; gap: 20px; border: 1px solid var(--line-strong); border-radius: 9px; background: var(--paper-light); }
 .copy-command + .copy-command { margin-top: 12px; }
@@ -727,17 +748,18 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .pro-home { overflow: hidden; }
 .pro-hero { padding-block: 88px 96px; display: grid; grid-template-columns: minmax(0, .9fr) minmax(560px, 1.1fr); align-items: center; gap: clamp(56px, 6vw, 96px); }
 .pro-hero-copy { min-width: 0; }
-.pro-hero-copy h1 { max-width: 680px; margin-bottom: 24px; font-size: clamp(54px, 5.4vw, 76px); line-height: .98; letter-spacing: -.06em; }
-.pro-hero-lede { max-width: 650px; margin-bottom: 30px; color: var(--ink-soft); font-size: 19px; line-height: 1.55; }
+.pro-hero-copy h1 { max-width: 720px; margin-bottom: 24px; font-size: clamp(54px, 5.4vw, 76px); line-height: .98; letter-spacing: -.04em; }
+.pro-hero-lede { max-width: 650px; margin-bottom: 0; color: var(--ink-soft); font-size: 19px; line-height: 1.55; }
 .pro-hero-copy .copy-command { max-width: 610px; border-radius: 7px; box-shadow: none; }
-.pro-hero-copy .button-row { margin-top: 20px; }
+.pro-hero-copy .button-row { margin-top: 30px; }
 .pro-trust-line { margin-top: 28px; display: flex; flex-wrap: wrap; gap: 10px 22px; color: var(--ink-faint); font-size: 12px; }
 .pro-trust-line span { display: inline-flex; align-items: center; gap: 6px; }
 .pro-trust-line svg { color: var(--green); }
 .pro-hero .interactive-map-stage { width: 100%; border-radius: 10px; box-shadow: 0 18px 50px rgba(10, 33, 59, .08); }
 
-.pro-film { padding-block: 24px 104px; display: grid; grid-template-columns: minmax(250px, .5fr) minmax(0, 1.5fr); align-items: end; gap: clamp(48px, 7vw, 104px); }
+.pro-film { padding-block: 24px 104px; display: grid; grid-template-columns: minmax(250px, .5fr) minmax(0, 1.5fr); align-items: end; gap: clamp(48px, 7vw, 104px); scroll-margin-top: 90px; }
 .pro-film .pro-section-heading { align-self: center; }
+.pro-film .text-link { margin-top: 14px; }
 .pro-film video { display: block; width: 100%; aspect-ratio: 16 / 9; border: 1px solid var(--line-strong); border-radius: 10px; background: var(--navy); box-shadow: 0 18px 50px rgba(10, 33, 59, .1); }
 
 .pro-workflow, .pro-surfaces { padding-block: 96px; }
@@ -765,9 +787,10 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
 .pro-proof-metrics dd { margin: 0; color: var(--mint); font: 620 34px/1 var(--font-mono), monospace; letter-spacing: -.05em; }
 
 .pro-surfaces { display: grid; grid-template-columns: .58fr 1.42fr; gap: clamp(60px, 8vw, 120px); }
-.pro-surface-grid { display: grid; grid-template-columns: repeat(2, 1fr); border-top: 1px solid var(--line-strong); }
+.pro-surface-grid { display: grid; grid-template-columns: repeat(3, 1fr); border-top: 1px solid var(--line-strong); }
 .pro-surface-grid > a { min-height: 255px; padding: 28px 28px 24px 0; display: flex; flex-direction: column; align-items: flex-start; border-bottom: 1px solid var(--line); border-right: 1px solid var(--line); text-decoration: none; }
-.pro-surface-grid > a:nth-child(even) { padding-left: 28px; border-right: 0; }
+.pro-surface-grid > a:not(:first-child) { padding-left: 28px; }
+.pro-surface-grid > a:last-child { border-right: 0; }
 .pro-surface-grid svg { color: var(--green); }
 .pro-surface-grid h3 { margin-top: 58px; font-size: 21px; }
 .pro-surface-grid p { min-height: 66px; color: var(--ink-soft); font-size: 14px; }
@@ -805,7 +828,7 @@ h3 { margin-bottom: 10px; font-size: 21px; line-height: 1.25; letter-spacing: -.
   .pro-proof-metrics div { min-height: 82px; }
   .pro-proof-metrics dd { font-size: 28px; }
   .pro-surface-grid { grid-template-columns: 1fr; }
-  .pro-surface-grid > a, .pro-surface-grid > a:nth-child(even) { min-height: 215px; padding: 26px 0; border-right: 0; }
+  .pro-surface-grid > a, .pro-surface-grid > a:not(:first-child) { min-height: 215px; padding: 26px 0; border-right: 0; }
   .pro-surface-grid h3 { margin-top: 34px; }
   .pro-surface-grid p { min-height: 0; }
   .pro-final { margin-bottom: 60px; padding: 26px 22px; align-items: stretch; flex-direction: column; }
diff --git a/apps/web/app/page.tsx b/apps/web/app/page.tsx
index 6418c65..a51bc23 100644
--- a/apps/web/app/page.tsx
+++ b/apps/web/app/page.tsx
@@ -2,32 +2,25 @@ import Link from "next/link";
 import {
   ArrowRight,
   CheckCircle,
-  Command,
   GithubLogo,
   Laptop,
   LockKey,
   Path,
-  ShieldCheck
+  Robot
 } from "@phosphor-icons/react/ssr";
-import { CopyCommand } from "./_components/copy-command";
 import { InteractiveMapStage } from "./_components/interactive-map-stage";
-import { commands, repoUrl, siteStats } from "./_lib/site-data";
+import { repoUrl, siteStats } from "./_lib/site-data";
 
-const workflow = [
-  { number: "01", name: "Plan", detail: "Rank primary context, then map likely impact without pretending every related file must change.", href: "/product#plan" },
-  { number: "02", name: "Context", detail: "Package relevant source ranges inside a visible estimated-token budget.", href: "/product#context" },
-  { number: "03", name: "Graph", detail: "Export the impact relationships as Mermaid or structured JSON.", href: "/product#graph" },
-  { number: "04", name: "Explain", detail: "Ask why a file ranked, missed the cutoff, was excluded, or was never scanned.", href: "/product#explain" },
-  { number: "05", name: "Compare", detail: "Measure whether a clearer task produced a better context map.", href: "/product#compare" },
-  { number: "06", name: "Watch", detail: "See drift and recalculated impact while the working tree changes.", href: "/product#watch" },
-  { number: "07", name: "Verify", detail: "Check the completed diff against the plan that guided the work.", href: "/product#verify" }
+const outcomes = [
+  { number: "01", name: "Files to inspect first", detail: "See the source files most connected to the task, with a plain reason for every suggestion.", href: "/product#plan" },
+  { number: "02", name: "Tests and checks to run", detail: "Find the nearest tests and package commands that can prove the change works.", href: "/product#tests" },
+  { number: "03", name: "Risks worth reviewing", detail: "Spot sensitive areas and nearby files before a focused edit becomes an unexpected regression.", href: "/product#risks" }
 ];
 
 const surfaces = [
-  { icon: Command, name: "Slash command", detail: "Install /fixmap in supported coding agents and open the complete workflow menu.", href: "/get-started#slash-command" },
-  { icon: Laptop, name: "CLI", detail: "Run locally in a terminal with no account or API key.", href: "/get-started#cli" },
-  { icon: ShieldCheck, name: "MCP", detail: "Expose all seven Plan, Context, Graph, Explain, Compare, Verify, and Doctor tools.", href: "/get-started#mcp" },
-  { icon: GithubLogo, name: "GitHub Action", detail: "Post the map or verify a saved plan on every pull request.", href: "/get-started#action" }
+  { icon: Robot, name: "Coding agent", detail: "Add /fixmap to Claude Code, Cursor, GitHub Copilot, or another supported agent.", href: "/get-started#agent" },
+  { icon: Laptop, name: "Terminal", detail: "Run FixMap locally with one command and no account or API key.", href: "/get-started#terminal" },
+  { icon: GithubLogo, name: "Pull requests", detail: "Post a FixMap report automatically whenever a pull request changes.", href: "/get-started#pull-requests" }
 ];
 
 export default function HomePage() {
@@ -35,16 +28,15 @@ export default function HomePage() {
     <main className="pro-home">
       <section className="pro-hero page-shell">
         <div className="pro-hero-copy">
-          <p className="eyebrow">FixMap v{siteStats.version} · open source repo intelligence</p>
-          <h1>Start the change with evidence.</h1>
+          <p className="eyebrow">For developers and coding agents · FixMap v{siteStats.version}</p>
+          <h1>Stop searching the repository blindly.</h1>
           <p className="pro-hero-lede">
-            Give FixMap a task, issue, or diff. It returns primary context, likely impact, reachable
-            checks, and risks—with every recommendation tied to repository evidence.
+            Give FixMap a task. It shows you and your coding agent the files to inspect, the tests
+            to run, and the risks to review before anything is edited.
           </p>
-          <CopyCommand command={commands.publicIssue} />
           <div className="button-row">
-            <Link className="button primary" href="/get-started">Install FixMap <ArrowRight size={17} weight="bold" aria-hidden /></Link>
-            <Link className="button secondary" href="/demo">Open the live demo</Link>
+            <a className="button primary" href="#comparison">Watch the 32-second comparison <ArrowRight size={17} weight="bold" aria-hidden /></a>
+            <Link className="button secondary" href="/demo">Try the live demo</Link>
           </div>
           <div className="pro-trust-line" role="group" aria-label="FixMap trust facts">
             <span><LockKey size={16} aria-hidden /> Local-first</span>
@@ -55,11 +47,12 @@ export default function HomePage() {
         <InteractiveMapStage />
       </section>
 
-      <section className="pro-film page-shell" aria-labelledby="pro-film-title">
+      <section className="pro-film page-shell" id="comparison" aria-labelledby="pro-film-title">
         <div className="pro-section-heading">
           <p className="eyebrow">FixMap in 32 seconds</p>
           <h2 id="pro-film-title">Same issue. Better first move.</h2>
-          <p>Watch two coding agents approach the same task as ranked context, impact evidence, Watch, and Verify change the feedback loop.</p>
+          <p>Watch one coding agent start with the right files and checks while the other searches the repository from scratch.</p>
+          <Link className="text-link" href="/get-started">Install after the film <ArrowRight size={17} weight="bold" aria-hidden /></Link>
         </div>
         <video controls playsInline preload="metadata" poster="/fixmap-launch-poster.jpg" aria-label="FixMap agent comparison launch film">
           <source src="/fixmap-launch.mp4" type="video/mp4" />
@@ -69,12 +62,12 @@ export default function HomePage() {
 
       <section className="pro-workflow page-shell">
         <div className="pro-section-heading">
-          <p className="eyebrow">One workflow</p>
-          <h2>From task to verified diff.</h2>
-          <p>Seven focused steps, each inspectable on its own.</p>
+          <p className="eyebrow">One task. Three useful answers.</p>
+          <h2>Know what to open, run, and review.</h2>
+          <p>FixMap narrows the first investigation without pretending it already knows the fix.</p>
         </div>
         <div className="pro-workflow-list">
-          {workflow.map((item) => (
+          {outcomes.map((item) => (
             <Link href={item.href} key={item.number}>
               <span>{item.number}</span>
               <strong>{item.name}</strong>
@@ -89,22 +82,22 @@ export default function HomePage() {
         <div className="page-shell pro-proof-inner">
           <div>
             <p className="eyebrow">Measured in public</p>
-            <h2>Useful without pretending to be certain.</h2>
-            <p>FixMap publishes the misses, cohort boundaries, and baseline comparisons. You can also backtest BM25, FixMap, and Impact Graph against your own repository history.</p>
-            <Link className="text-link" href="/evidence">Read the benchmark methodology <ArrowRight size={17} weight="bold" aria-hidden /></Link>
+            <h2>See the wins, the misses, and the limits.</h2>
+            <p>FixMap publishes every benchmark case, explains what each number means, and makes uncertainty visible instead of hiding it behind a confidence label.</p>
+            <Link className="text-link" href="/evidence">See every benchmark case <ArrowRight size={17} weight="bold" aria-hidden /></Link>
           </div>
           <dl className="pro-proof-metrics">
-            <div><dt>Held-out Top 3</dt><dd>{siteStats.heldout.top3}/{siteStats.heldout.cases}</dd></div>
-            <div><dt>Adversarial gate</dt><dd>{siteStats.adversarial.passed}/{siteStats.adversarial.cases}</dd></div>
-            <div><dt>Median scan</dt><dd>{siteStats.medianSeconds}s</dd></div>
+            <div><dt>Relevant fix surfaced in the first three suggestions</dt><dd>{siteStats.heldout.top3}/{siteStats.heldout.cases}</dd></div>
+            <div><dt>Misleading or vague tasks handled without false confidence</dt><dd>{siteStats.adversarial.passed}/{siteStats.adversarial.cases}</dd></div>
+            <div><dt>Median time to scan and rank the sample repositories</dt><dd>{siteStats.medianSeconds}s</dd></div>
           </dl>
         </div>
       </section>
 
       <section className="pro-surfaces page-shell">
         <div className="pro-section-heading">
-          <p className="eyebrow">Use it where work starts</p>
-          <h2>One engine. Four entry points.</h2>
+          <p className="eyebrow">Choose your setup</p>
+          <h2>Use FixMap where your work already starts.</h2>
         </div>
         <div className="pro-surface-grid">
           {surfaces.map(({ icon: Icon, ...surface }) => (
@@ -119,7 +112,7 @@ export default function HomePage() {
       </section>
 
       <section className="pro-final page-shell">
-        <div><Path size={22} aria-hidden /><strong>Ready to map a real task?</strong><span>No signup, cloud upload, or API key.</span></div>
+        <div><Path size={22} aria-hidden /><strong>Ready to give the next change a better start?</strong><span>Try it once or install it for your coding agent.</span></div>
         <div className="button-row">
           <Link className="button primary" href="/get-started">Get started <ArrowRight size={17} weight="bold" aria-hidden /></Link>
           <a className="text-link" href={repoUrl}><GithubLogo size={17} weight="fill" aria-hidden /> View source</a>
diff --git a/docs/assets/fixmap-cli-demo.svg b/docs/assets/fixmap-cli-demo.svg
index d30fd1b..140863b 100644
--- a/docs/assets/fixmap-cli-demo.svg
+++ b/docs/assets/fixmap-cli-demo.svg
@@ -26,7 +26,7 @@
   <text class="l" style="animation-delay:5.75s" x="22" y="352" fill="#e6edf3"><tspan>- </tspan><tspan fill="#79c0ff">test/auth/reset-password.test.ts</tspan><tspan> (high confidence, impact 13): this file imports</tspan></text>
   <text class="l" style="animation-delay:6.00s" x="22" y="373" fill="#e6edf3"><tspan>    src/auth/reset-password.ts; routed test for src/auth/reset-password.ts via npm run test</tspan></text>
   <text class="l" style="animation-delay:6.25s" x="22" y="415" fill="#e6edf3"><tspan>Inspection order: </tspan><tspan fill="#79c0ff">src/auth/reset-password.ts</tspan><tspan> → </tspan><tspan fill="#79c0ff">test/auth/reset-password.test.ts</tspan><tspan>.</tspan></text>
-  <text class="l" style="animation-delay:6.50s" x="22" y="436" fill="#e6edf3"><tspan>History evidence: 28 eligible commits.</tspan></text>
+  <text class="l" style="animation-delay:6.50s" x="22" y="436" fill="#e6edf3"><tspan>History evidence: 29 eligible commits.</tspan></text>
   <text class="l" style="animation-delay:7.65s" x="22" y="478" fill="#e6edf3"><tspan fill="#74f0ba" font-weight="bold">## Test Routes</tspan></text>
   <text class="l" style="animation-delay:7.90s" x="22" y="520" fill="#e6edf3"><tspan>- </tspan><tspan fill="#79c0ff">npm run test</tspan><tspan>: repository root script named test. Related:</tspan></text>
   <text class="l" style="animation-delay:8.15s" x="22" y="541" fill="#e6edf3"><tspan>    </tspan><tspan fill="#79c0ff">test/auth/reset-password.test.ts</tspan><tspan>.</tspan></text>
diff --git a/examples/reports/declines-fabricated-identifier.md b/examples/reports/declines-fabricated-identifier.md
index 3281e4f..05f4cda 100644
--- a/examples/reports/declines-fabricated-identifier.md
+++ b/examples/reports/declines-fabricated-identifier.md
@@ -19,7 +19,7 @@ FixMap found 0 context files, 0 impact files, and generated 0 test routes.
 - None found
 
 Inspection order: None.
-History evidence: 28 eligible commits.
+History evidence: 29 eligible commits.
 
 ## Test Routes
 
diff --git a/examples/reports/declines-unmatched-terms.md b/examples/reports/declines-unmatched-terms.md
index e3b68d6..6062385 100644
--- a/examples/reports/declines-unmatched-terms.md
+++ b/examples/reports/declines-unmatched-terms.md
@@ -19,7 +19,7 @@ FixMap found 0 context files, 0 impact files, and generated 0 test routes.
 - None found
 
 Inspection order: None.
-History evidence: 28 eligible commits.
+History evidence: 29 eligible commits.
 
 ## Test Routes
 
diff --git a/examples/reports/declines-vague-task.md b/examples/reports/declines-vague-task.md
index 82247d0..d98ca20 100644
--- a/examples/reports/declines-vague-task.md
+++ b/examples/reports/declines-vague-task.md
@@ -19,7 +19,7 @@ FixMap found 0 context files, 0 impact files, and generated 0 test routes.
 - None found
 
 Inspection order: None.
-History evidence: 28 eligible commits.
+History evidence: 29 eligible commits.
 
 ## Test Routes
 
diff --git a/examples/reports/workspace-api-discount.md b/examples/reports/workspace-api-discount.md
index 6183389..b9d97a6 100644
--- a/examples/reports/workspace-api-discount.md
+++ b/examples/reports/workspace-api-discount.md
@@ -13,7 +13,7 @@ FixMap found 2 context files, 2 impact files, and generated 3 test routes.
 - `packages/utils/test/currency.test.ts` (high confidence, impact 13): this file imports packages/utils/src/currency.ts; routed test for packages/utils/src/currency.ts via pnpm --dir packages/utils run test
 
 Inspection order: `apps/api/src/orders.ts` → `packages/utils/src/currency.ts` → `apps/api/test/orders.test.ts` → `packages/utils/test/currency.test.ts`.
-History evidence: 63 eligible commits.
+History evidence: 64 eligible commits.
 
 ## Test Routes
 
diff --git a/examples/reports/workspace-utils-rounding.md b/examples/reports/workspace-utils-rounding.md
index dc33470..b0d44b9 100644
--- a/examples/reports/workspace-utils-rounding.md
+++ b/examples/reports/workspace-utils-rounding.md
@@ -11,7 +11,7 @@ FixMap found 1 context file, 1 impact file, and generated 2 test routes.
 - `packages/utils/test/currency.test.ts` (high confidence, impact 13): this file imports packages/utils/src/currency.ts; routed test for packages/utils/src/currency.ts via pnpm --dir packages/utils run test
 
 Inspection order: `packages/utils/src/currency.ts` → `packages/utils/test/currency.test.ts`.
-History evidence: 63 eligible commits.
+History evidence: 64 eligible commits.
 
 ## Test Routes
 
diff --git a/package-lock.json b/package-lock.json
index e81f7e1..2a282c8 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -6207,9 +6207,9 @@
       "license": "MIT"
     },
     "node_modules/nanoid": {
-      "version": "3.3.17",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.17.tgz",
-      "integrity": "sha512-xQLf0A3HOMlgHq0n247/LRuAOYmB7dXJ/DvAxGvsSBij45XtBSmQycu+F8ODbHwns/XyFZagyL1+J0Offw1E0g==",
+      "version": "3.3.18",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",
+      "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",
       "funding": [
         {
           "type": "github",
diff --git a/package.json b/package.json
index 55b91ee..0f02336 100644
--- a/package.json
+++ b/package.json
@@ -79,7 +79,7 @@
     },
     "fast-uri": "3.1.4",
     "js-yaml": "4.3.1",
-    "nanoid": "3.3.17",
+    "nanoid": "3.3.18",
     "sharp": "0.35.3",
     "vite": "6.4.3"
   },