docs(readme): top-of-page Quickstart with three audience paths

Author: amacsmith

README.md

@@ -12,14 +12,15 @@ Point AI agents at any indexed repo and they get a current, schema-validated gra
 
 > **Status:** private MVP under [`amacsmith/understand-quickly`](https://github.com/amacsmith/understand-quickly). Will move to a public org once core flows are battle-tested. Live registry at <https://amacsmith.github.io/understand-quickly/>.
 
-[**Browse the registry →**](https://amacsmith.github.io/understand-quickly/) · [**Add your repo**](#add-your-repo) · [**Agent quickstart**](#agent-quickstart) · [**Design spec**](docs/superpowers/specs/2026-05-07-understand-quickly-registry-design.md)
+[**Browse →**](https://amacsmith.github.io/understand-quickly/) · [**Add your repo (wizard)**](https://amacsmith.github.io/understand-quickly/add.html) · [**Agent quickstart**](#quickstart) · [**Design spec**](docs/superpowers/specs/2026-05-07-understand-quickly-registry-design.md)
 
 </div>
 
 ---
 
 ## Contents
 
+- [Quickstart](#quickstart)
 - [Why](#why)
 - [How it works](#how-it-works)
 - [Zero cost](#zero-cost)
@@ -32,6 +33,27 @@ Point AI agents at any indexed repo and they get a current, schema-validated gra
 - [Roadmap](#roadmap)
 - [License](#license)
 
+## Quickstart
+
+**I'm an AI agent / SDK user.**
+```bash
+curl -fsSL https://amacsmith.github.io/understand-quickly/registry.json
+```
+Pick entries with `status: "ok"`. Fetch `entry.graph_url`. Cache by `last_sha`. That's the whole API.
+
+**I want to register my repo.** Pick the path that fits:
+- 🖱️ **30-second wizard:** [Add your repo →](https://amacsmith.github.io/understand-quickly/add.html). Fills the issue for you; the bot opens the PR.
+- 💻 **From your terminal:** `npx @understand-quickly/cli add` — auto-detects everything.
+- ✍️ **Manual PR:** see [Add your repo](#add-your-repo) below.
+
+**I'm a developer / contributor.**
+```bash
+git clone https://github.com/amacsmith/understand-quickly
+cd understand-quickly
+npm install && npm test
+```
+Then read [`CONTRIBUTING.md`](./CONTRIBUTING.md).
+
 ## Why
 
 Tools like [Understand-Anything](https://github.com/Lum1104/Understand-Anything), [GitNexus](https://github.com/abhigyanpatwari/GitNexus), and [code-review-graph](https://github.com/tirth8205/code-review-graph) turn a codebase into a queryable knowledge graph. The graph is JSON. Today there is no shared, current, machine-readable index of which public repos publish one.
@@ -109,6 +131,8 @@ Schemas: [`schemas/`](./schemas/). Each `format` value (e.g. `understand-anythin
 
 ## Add your repo
 
+> **Want the easy path?** Use the [wizard](https://amacsmith.github.io/understand-quickly/add.html) or `npx @understand-quickly/cli add`. The instructions below describe the manual-PR flow.
+
 1. Run [Understand-Anything](https://github.com/Lum1104/Understand-Anything) (or any supported tool) locally; commit `.understand-anything/knowledge-graph.json` to your repo.
 2. Fork this repo.
 3. Append an entry to `registry.json`. Use whichever format your tool emits: