diff --git a/docs/graph-atlas.md b/docs/graph-atlas.md
index 9fb678d3d7..92953d9fe7 100644
--- a/docs/graph-atlas.md
+++ b/docs/graph-atlas.md
@@ -18,7 +18,7 @@ The process decision behind this index is recorded in [the documentation graph R
 | [event producer/consumer matrix](event-producer-consumer.md) | `hybrid generated` |
 | [agent turn and step lifecycle](agent-lifecycle.md) | `curated` |
 | [tool execution pipeline](tool-execution-pipeline.md) | `curated` |
-| [ACP snapshot replay](acp/snapshot-replay.md) | `curated` |
+| [ACP snapshot replay](../packages/ui/acp/snapshot-replay.md) | `curated` |
 
 Regenerate with `pnpm run gen-doc-graphs`; verify freshness with `pnpm run verify-doc-graphs`.
 
diff --git a/docs/rfc/implemented/process/2026-07-03-documentation-graph-atlas.md b/docs/rfc/implemented/process/2026-07-03-documentation-graph-atlas.md
index 0cf93a8f6e..11b14a4902 100644
--- a/docs/rfc/implemented/process/2026-07-03-documentation-graph-atlas.md
+++ b/docs/rfc/implemented/process/2026-07-03-documentation-graph-atlas.md
@@ -39,7 +39,7 @@ The first index links ten relationship surfaces. Package topology and tool-packa
 | [event producer/consumer matrix](../../../event-producer-consumer.md) | hybrid generated | Cordis event declarations, AST-scanned `ctx.on/emit/parallel/serial/waterfall` sites, and explicit dynamic dispatch overrides |
 | [agent turn and step lifecycle](../../../agent-lifecycle.md) | curated | architecture.md loop lifecycle, Cordis catalog links, and session event semantics |
 | [tool execution pipeline](../../../tool-execution-pipeline.md) | curated | tool pipeline semantics and the `tools/execute` waterfall |
-| [ACP snapshot replay](../../../acp/snapshot-replay.md) | curated | snapshot harness behavior |
+| [ACP snapshot replay](../../../../packages/ui/acp/snapshot-replay.md) | curated | snapshot harness behavior |
 
 ### Why generators own the docs
 
diff --git a/docs/acp/snapshot-replay.md b/packages/ui/acp/snapshot-replay.md
similarity index 100%
rename from docs/acp/snapshot-replay.md
rename to packages/ui/acp/snapshot-replay.md
diff --git a/scripts/gen-doc-graphs.ts b/scripts/gen-doc-graphs.ts
index 183f8ca62a..4f90b79e8e 100644
--- a/scripts/gen-doc-graphs.ts
+++ b/scripts/gen-doc-graphs.ts
@@ -695,7 +695,7 @@ function renderDocs(): GraphDoc[] {
     { rel: 'docs/event-producer-consumer.md', content: renderEventRelations(pkgs) },
     { rel: 'docs/agent-lifecycle.md', content: renderLifecycle() },
     { rel: 'docs/tool-execution-pipeline.md', content: renderToolPipeline() },
-    { rel: 'docs/acp/snapshot-replay.md', content: renderSnapshotReplay() },
+    { rel: 'packages/ui/acp/snapshot-replay.md', content: renderSnapshotReplay() },
   ]
   docs.unshift({ rel: 'docs/graph-atlas.md', content: renderIndex(docs) })
   return docs
@@ -710,7 +710,7 @@ function renderIndex(docs: GraphDoc[]): string {
     'docs/event-producer-consumer.md': 'event producer/consumer matrix',
     'docs/agent-lifecycle.md': 'agent turn and step lifecycle',
     'docs/tool-execution-pipeline.md': 'tool execution pipeline',
-    'docs/acp/snapshot-replay.md': 'ACP snapshot replay',
+    'packages/ui/acp/snapshot-replay.md': 'ACP snapshot replay',
   }
   const modes: Record<string, string> = {
     'docs/capability-seams.md': 'hybrid generated',
@@ -720,7 +720,7 @@ function renderIndex(docs: GraphDoc[]): string {
     'docs/event-producer-consumer.md': 'hybrid generated',
     'docs/agent-lifecycle.md': 'curated',
     'docs/tool-execution-pipeline.md': 'curated',
-    'docs/acp/snapshot-replay.md': 'curated',
+    'packages/ui/acp/snapshot-replay.md': 'curated',
   }
   const rows = [
     '| [module dependency graph](module-graph.md) | `generated` |',