diff --git a/README.md b/README.md
index 31c8608..1026b94 100644
--- a/README.md
+++ b/README.md
@@ -22,53 +22,23 @@
 
 ## The problem
 
-I was running ~30 Codex agents in parallel and hit a wall: they kept working on the same files at the same time — especially tests — and started overwriting or deleting each other's changes. More agents meant *less* forward progress, not more. Classic de-progressive loop.
+![Parallel agents colliding in the same files](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/problem-agent-collision.svg)
 
-GitGuardex exists to stop that loop. Every agent gets its own worktree, claims the files it's touching, and can't clobber files another agent has claimed. Your local branch stays clean; agents stay in their lanes.
+I was running ~30 Codex agents in parallel and hit a wall: they kept working on the same files at the same time — especially tests — and started overwriting or deleting each other's changes. More agents meant *less* forward progress, not more. Classic de-progressive loop.
 
 ### Solution
 
-```mermaid
-flowchart LR
-    A[Agent A adds assertions in a shared test] --> S[Several agents touch the same files]
-    B[Agent B rewrites the same test flow] --> S
-    C[Agent C updates the shared helper] --> S
-    D[Agent D deletes lines Agent A just added] --> S
-    E[Agent E saves an older snapshot of the file] --> S
-    S --> F[One agent overwrites another agent's edits]
-    F --> G[Another agent deletes code the others just added]
-    G --> H[Lost work, rework, and review confusion]
-    H --> I[Regression risk and flaky fixes grow]
-    I --> S
-```
+![Agent branch/worktree start protocol](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/workflow-branch-start.svg)
 
-<!-- ===================================================================== -->
-<!-- 1) GITHUB ABOUT SIDEBAR DESCRIPTION                                   -->
-<!-- ===================================================================== -->
-<!--                                                                       -->
-<!-- Paste one of these into:                                              -->
-<!--   Repo → Settings → General → Description                             -->
-<!--                                                                       -->
-<!-- The install command is removed — About is plain text, so there's no   -->
-<!-- way to make it copyable. The install lives in the README where the    -->
-<!-- code block gets GitHub's auto copy button on hover.                   -->
-<!-- ===================================================================== -->
+GitGuardex exists to stop that loop. Every agent gets its own worktree, claims the files it's touching, and can't clobber files another agent has claimed. Your local branch stays clean; agents stay in their lanes.
+
+## GitHub About description
 
-Option A — leads with the tagline (matches README h1):
-    Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks,
-    and PR-only merges stop parallel Codex & Claude agents from overwriting
-    each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and
-    Caveman.
-
-Option B — leads with the benefit:
-    Run many Codex & Claude agents in parallel without them overwriting each
-    other. Isolated worktrees, file locks, PR-only merges. Auto-wires Oh My
-    Codex, Oh My Claude, OpenSpec, and Caveman in every worktree.
-
-Option C — punchiest, under 200 chars:
-    Safety layer for parallel Codex & Claude agents. Isolated worktrees +
-    file locks + PR-only merges. Auto-wires Oh My Codex, Oh My Claude,
-    OpenSpec, and Caveman.
+The canonical GitHub About copy lives in [about_description.txt](./about_description.txt):
+
+```text
+Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks, and PR-only merges stop parallel Codex & Claude agents from overwriting each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and Caveman.
+```
 
 
 <!-- ===================================================================== -->
diff --git a/about_description.txt b/about_description.txt
new file mode 100644
index 0000000..aca3383
--- /dev/null
+++ b/about_description.txt
@@ -0,0 +1 @@
+Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks, and PR-only merges stop parallel Codex & Claude agents from overwriting each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and Caveman.
diff --git a/docs/images/problem-agent-collision.svg b/docs/images/problem-agent-collision.svg
new file mode 100644
index 0000000..b8e82b6
--- /dev/null
+++ b/docs/images/problem-agent-collision.svg
@@ -0,0 +1,98 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="760" viewBox="0 0 1600 760" role="img" aria-labelledby="title desc">
+  <title id="title">parallel agent collision loop</title>
+  <desc id="desc">Five agents touch the same files, one overwrite leads to deletion, lost work, and a regression loop.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" x2="0" y1="0" y2="1">
+      <stop offset="0%" stop-color="#0b1220"/>
+      <stop offset="100%" stop-color="#080d18"/>
+    </linearGradient>
+    <marker id="arrow" markerWidth="12" markerHeight="12" refX="9" refY="6" orient="auto" markerUnits="strokeWidth">
+      <path d="M1,1 L11,6 L1,11 z" fill="#cbd5e1"/>
+    </marker>
+    <style>
+      .panel { fill: #252525; stroke: #8f8f8f; stroke-width: 1.5; rx: 12; }
+      .label { fill: #f8fafc; font-family: 'IBM Plex Sans', 'Segoe UI', sans-serif; font-size: 17px; }
+      .muted { fill: #cbd5e1; font-family: 'IBM Plex Sans', 'Segoe UI', sans-serif; font-size: 17px; }
+      .wire { fill: none; stroke: #cbd5e1; stroke-width: 2; marker-end: url(#arrow); }
+    </style>
+  </defs>
+
+  <rect width="1600" height="760" fill="url(#bg)"/>
+  <rect x="18" y="18" width="1564" height="724" rx="18" fill="#0f1623" stroke="#25314a"/>
+
+  <g>
+    <rect class="panel" x="90" y="110" width="220" height="64"/>
+    <text class="label" x="112" y="138">
+      <tspan x="112" dy="0">Agent A adds assertions</tspan>
+      <tspan x="112" dy="22">in a shared test</tspan>
+    </text>
+
+    <rect class="panel" x="90" y="210" width="220" height="64"/>
+    <text class="label" x="112" y="238">
+      <tspan x="112" dy="0">Agent B rewrites</tspan>
+      <tspan x="112" dy="22">the same flow</tspan>
+    </text>
+
+    <rect class="panel" x="90" y="310" width="220" height="64"/>
+    <text class="label" x="112" y="338">
+      <tspan x="112" dy="0">Agent C updates</tspan>
+      <tspan x="112" dy="22">the shared helper</tspan>
+    </text>
+
+    <rect class="panel" x="90" y="410" width="220" height="64"/>
+    <text class="label" x="112" y="438">
+      <tspan x="112" dy="0">Agent D deletes lines</tspan>
+      <tspan x="112" dy="22">Agent A just added</tspan>
+    </text>
+
+    <rect class="panel" x="90" y="510" width="220" height="64"/>
+    <text class="label" x="112" y="538">
+      <tspan x="112" dy="0">Agent E saves</tspan>
+      <tspan x="112" dy="22">an older snapshot</tspan>
+    </text>
+  </g>
+
+  <rect class="panel" x="350" y="310" width="240" height="64"/>
+  <text class="label" x="380" y="338">
+    <tspan x="380" dy="0">Several agents touch</tspan>
+    <tspan x="380" dy="22">the same files</tspan>
+  </text>
+
+  <rect class="panel" x="630" y="290" width="230" height="64"/>
+  <text class="label" x="658" y="318">
+    <tspan x="658" dy="0">One agent overwrites</tspan>
+    <tspan x="658" dy="22">another agent's edits</tspan>
+  </text>
+
+  <rect class="panel" x="900" y="290" width="210" height="64"/>
+  <text class="label" x="926" y="318">
+    <tspan x="926" dy="0">Another agent deletes</tspan>
+    <tspan x="926" dy="22">code the others added</tspan>
+  </text>
+
+  <rect class="panel" x="1150" y="290" width="200" height="64"/>
+  <text class="label" x="1176" y="318">
+    <tspan x="1176" dy="0">Lost work, rework,</tspan>
+    <tspan x="1176" dy="22">and review confusion</tspan>
+  </text>
+
+  <rect class="panel" x="1370" y="290" width="170" height="64"/>
+  <text class="label" x="1395" y="318">
+    <tspan x="1395" dy="0">Regression risk</tspan>
+    <tspan x="1395" dy="22">and flaky fixes grow</tspan>
+  </text>
+
+  <path class="wire" d="M310 142 C345 142 350 180 390 332"/>
+  <path class="wire" d="M310 242 C350 242 360 260 390 332"/>
+  <path class="wire" d="M310 342 L350 342"/>
+  <path class="wire" d="M310 442 C345 442 360 420 390 352"/>
+  <path class="wire" d="M310 542 C345 542 360 500 390 352"/>
+
+  <path class="wire" d="M590 342 L630 322"/>
+  <path class="wire" d="M860 322 L900 322"/>
+  <path class="wire" d="M1110 322 L1150 322"/>
+  <path class="wire" d="M1350 322 L1370 322"/>
+  <path class="wire" d="M1540 330 C1570 360 1568 436 1480 452 L640 452 C590 452 570 424 570 374"/>
+
+  <text class="muted" x="86" y="662">Five agents touch the same files. One overwrite turns into deletion, lost work, and a regression loop.</text>
+</svg>
diff --git a/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/.openspec.yaml b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/.openspec.yaml
new file mode 100644
index 0000000..4b8c565
--- /dev/null
+++ b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-04-21
diff --git a/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/notes.md b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/notes.md
new file mode 100644
index 0000000..db664f7
--- /dev/null
+++ b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/notes.md
@@ -0,0 +1,5 @@
+# T1 Notes
+
+- Handoff: own `README.md`, `about_description.txt`, `docs/images/problem-agent-collision.svg`, and this change note.
+- Replace the README About-options dump with one canonical `about_description.txt` source and a short README section that points to it.
+- Move the collision visual under `## The problem`, move the solution copy under `### Solution`, and add the existing branch-start visual under the solution heading.
diff --git a/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/proposal.md b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/proposal.md
new file mode 100644
index 0000000..8fb2413
--- /dev/null
+++ b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/proposal.md
@@ -0,0 +1,15 @@
+## Why
+
+- The README currently mixes three alternative GitHub About descriptions into the product narrative, which adds noise near the top of the page.
+- The user requested a single canonical `about_description` source and a clearer visual split between the problem statement and the solution.
+
+## What Changes
+
+- Add a root `about_description.txt` file with the canonical GitHub About copy and point the README at it.
+- Move the collision visual under `## The problem` and place the existing branch-start workflow image under `### Solution`.
+- Replace the README option dump with a short "GitHub About description" section that mirrors the canonical copy.
+
+## Impact
+
+- Affected surfaces: top-level `README.md`, one new docs image, one new root copy file, and the matching OpenSpec change record.
+- Risk is low and limited to docs/rendered README structure.
diff --git a/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/specs/readme-about-description/spec.md b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/specs/readme-about-description/spec.md
new file mode 100644
index 0000000..d14e9eb
--- /dev/null
+++ b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/specs/readme-about-description/spec.md
@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: README problem and solution sections use separate visuals
+The README SHALL place the multi-agent collision visual directly under `## The problem` and SHALL place a Guardex solution visual directly under `### Solution`.
+
+#### Scenario: problem visual appears before the collision narrative
+- **WHEN** a reader opens the top-level README
+- **THEN** the `## The problem` heading is followed by the collision visual
+- **AND** the narrative about parallel agents overwriting each other appears below that visual.
+
+#### Scenario: solution visual appears under the solution heading
+- **WHEN** a reader reaches the `### Solution` section
+- **THEN** the README shows a Guardex workflow image directly under that heading
+- **AND** the solution copy appears below the image.
+
+### Requirement: README points to one canonical GitHub About description source
+The repo SHALL keep one canonical GitHub About description in `about_description.txt`, and the README SHALL reference that file instead of listing multiple About-copy options.
+
+#### Scenario: canonical About copy is linked from the README
+- **WHEN** a reader opens the `## GitHub About description` section
+- **THEN** the README links to `about_description.txt`
+- **AND** the section mirrors the same canonical copy in a copyable text block.
diff --git a/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/tasks.md b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/tasks.md
new file mode 100644
index 0000000..0c5707d
--- /dev/null
+++ b/openspec/changes/agent-codex-readme-about-description-2026-04-21-18-05/tasks.md
@@ -0,0 +1,19 @@
+## 1. Specification
+
+- [x] 1.1 Capture the README/about-copy scope in proposal + spec artifacts.
+
+## 2. Implementation
+
+- [x] 2.1 Add the canonical `about_description.txt` source file.
+- [x] 2.2 Update `README.md` so `The problem` and `Solution` each have the intended visual placement.
+- [x] 2.3 Add the static collision visual used by `The problem`.
+
+## 3. Verification
+
+- [x] 3.1 Run `git diff --check`.
+- [x] 3.2 Run `openspec validate agent-codex-readme-about-description-2026-04-21-18-05 --type change --strict`.
+- [x] 3.3 Run `openspec validate --specs`.
+
+## 4. Cleanup
+
+- [ ] 4.1 Branch is ready for `agent-branch-finish --via-pr --wait-for-merge --cleanup` with PR URL + `MERGED` evidence recorded.