From f3a0e28763bd28144fb22d6b8807b81c11b40efb Mon Sep 17 00:00:00 2001
From: Ian Gulliver <git@flamingcow.io>
Date: Wed, 21 Oct 2026 11:50:32 -0700
Subject: [PATCH] Align terminology and documentation with project conventions

---
 internal/agents/snapshots.go | 4 ++--
 site/index.html              | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/internal/agents/snapshots.go b/internal/agents/snapshots.go
index ebbcceb..08087ac 100644
--- a/internal/agents/snapshots.go
+++ b/internal/agents/snapshots.go
@@ -266,12 +266,12 @@ func (m *Manager) takeSnapshotTool(l *live) mcp.Tool {
 			if err != nil {
 				return "", err
 			}
-			return "Snapshot requested. A reviewer reviews it against the default branch, and any findings come to you as a message from byre.", nil
+			return "Snapshot requested. If the project has a review workflow, its reviewers check it against the default branch; their findings come to you together once the workflow finishes.", nil
 		},
 	}
 }
 
-const takeSnapshotDescription = "Snapshot a task's worktree now, uncommitted work included, and start a review of it: a reviewer on the other vendor (or on yours, when the other isn't installed) reviews all of the task's work against the default branch. " +
+const takeSnapshotDescription = "Snapshot a task's worktree now, uncommitted work included. If the project has a review workflow, its reviewers check all of the task's work against the default branch, using each stage's model and instructions; findings arrive together once the workflow finishes. " +
 	"byre already does this at the end of every turn that changes files; call this to review work mid-turn, or to retry a review that failed (it snapshots even when nothing changed since the last snapshot)."
 
 func (m *Manager) dropSnapshots(repo, taskID string) error {
diff --git a/site/index.html b/site/index.html
index 467fac5..576e4ff 100644
--- a/site/index.html
+++ b/site/index.html
@@ -1213,7 +1213,7 @@ footer {
 <div class="fork"><div class="win"><div class="bar"><i></i><i></i><i></i>new task</div><div class="body"><b>search: try SQLite FTS instead</b><div class="muted">forked from #3, conversation included</div></div></div></div>
 </div>
 <div class="win diff">
-<div class="bar"><i></i><i></i><i></i>diff #3 → #5</div>
+<div class="bar"><i></i><i></i><i></i>diff #2 → #3</div>
 <div class="body">
 <div class="row">index/build.go<span class="end"><span class="plus">+48</span> <span class="minus">−12</span></span></div>
 <div class="row">index/query.go<span class="end"><span class="plus">+21</span> <span class="minus">−30</span></span></div>
@@ -1224,7 +1224,7 @@ footer {
 </div>
 <ul class="points">
 <li><strong>Every step kept.</strong> Each turn that changes files leaves a snapshot behind it.</li>
-<li><strong>Diff anything.</strong> Compare any two snapshots to see exactly what each turn did.</li>
+<li><strong>See each step.</strong> See what changed in each snapshot, or compare it with the default branch.</li>
 <li><strong>Fork the past.</strong> Start a new task from any snapshot, conversation included.</li>
 </ul>
 </div>