From a3d2db0eeccf0848ae0646dfa7019717f6bb673a Mon Sep 17 00:00:00 2001
From: Dean Stratakos <29683763+dastratakos@users.noreply.github.com>
Date: Wed, 6 May 2026 23:50:21 -0700
Subject: [PATCH 1/2] docs: update README with logo, badges, and cleaner copy

---
 README.md             | 28 +++++++++++++++-------------
 assets/stage-mark.svg |  6 ++++++
 2 files changed, 21 insertions(+), 13 deletions(-)
 create mode 100644 assets/stage-mark.svg

diff --git a/README.md b/README.md
index e60add9..1167aa6 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,18 @@
-# stagereview
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ReviewStage/stage-cli/main/assets/stage-mark.svg" alt="Stage" height="80">
+  <h1>Stage</h1>
+  AI-powered code review tool that organizes local code changes into logical chapters and points out what to review before you dive into the code.
+</p>
 
-AI-powered code review tool that organizes pull requests into logical chapters and surfaces risks before you dive into the code. Run it from your local coding agent of choice.
+<p align="center">
+  <a href="https://www.npmjs.com/package/stagereview"><img src="https://img.shields.io/npm/v/stagereview.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/stagereview"><img src="https://img.shields.io/npm/dm/stagereview.svg" alt="npm downloads"></a>
+  <a href="https://github.com/ReviewStage/stage-cli/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/stagereview.svg" alt="license"></a>
+</p>
 
-Try the full Stage experience with GitHub integration at [https://stagereview.app](https://stagereview.app).
+---
+
+Try the full Stage experience with GitHub integration at [stagereview.app](https://stagereview.app).
 
 ## Install
 
@@ -10,8 +20,6 @@ Try the full Stage experience with GitHub integration at [https://stagereview.ap
 npm install -g stagereview
 ```
 
-This installs the `stagereview` command.
-
 Then add the skill to your agent:
 
 ```bash
@@ -26,14 +34,8 @@ In your AI agent, run:
 /stage-chapters
 ```
 
-This breaks your branch's diff into reviewable "chapters" and opens a local browser window to view the chapters.
-
-## What it does
-
-- Splits a local git branch diff into logical review chapters
-- Opens a local browser to view the chapters
-- Runs entirely on your machine
+This organizes your local changes into reviewable chapters and opens a browser UI. Everything happens on your machine.
 
 ## License
 
-MIT
+[MIT](LICENSE)
diff --git a/assets/stage-mark.svg b/assets/stage-mark.svg
new file mode 100644
index 0000000..d482283
--- /dev/null
+++ b/assets/stage-mark.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" fill="none">
+  <rect x="170.0" y="100.1" width="172.0" height="53.8" rx="26.9" fill="#2d7a4e" opacity="0.9"/>
+  <rect x="127.0" y="186.1" width="258.0" height="53.8" rx="26.9" fill="#2d7a4e" opacity="0.65"/>
+  <rect x="84.0" y="272.1" width="344.1" height="53.8" rx="26.9" fill="#2d7a4e" opacity="0.4"/>
+  <rect x="41.0" y="358.1" width="430.1" height="53.8" rx="26.9" fill="#2d7a4e" opacity="0.2"/>
+</svg>
\ No newline at end of file

From b096695d65d49513210b5e3235798adfa245f420 Mon Sep 17 00:00:00 2001
From: Dean Stratakos <29683763+dastratakos@users.noreply.github.com>
Date: Thu, 7 May 2026 00:05:34 -0700
Subject: [PATCH 2/2] fix: use div instead of p for block-level heading in
 README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

<h1> inside <p> is invalid HTML — browsers auto-close the paragraph,
breaking the centered layout.
---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1167aa6..4507b6b 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
-<p align="center">
+<div align="center">
   <img src="https://raw.githubusercontent.com/ReviewStage/stage-cli/main/assets/stage-mark.svg" alt="Stage" height="80">
   <h1>Stage</h1>
-  AI-powered code review tool that organizes local code changes into logical chapters and points out what to review before you dive into the code.
-</p>
+  <p>AI-powered code review tool that organizes local code changes into logical chapters and points out what to review before you dive into the code.</p>
+</div>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/stagereview"><img src="https://img.shields.io/npm/v/stagereview.svg" alt="npm version"></a>