# Agent front-face overhaul (website UI)

Front-face only: shift public focus to **Reactopia Agent** (multi-provider: Claude, Gemini). Existing Browse, Discover, SVG, and docs stay available. Tag agent surfaces **Alpha**.

## Status legend

- `[ ]` not started
- `[~]` in progress
- `[x]` done

---

## Phase 1 — Foundation

- [x] **1.1** This task list (`public/docs/AGENT_FRONTFACE_OVERHAUL.md`)
- [x] **1.2** Shared copy + SEO constants (`src/components/site/agentContent.ts`)
- [x] **1.3** `AlphaBadge` component (`src/components/site/AlphaBadge.tsx`)

## Phase 2 — Routes & SEO

- [x] **2.1** Register `/agent`, `/agent/studio` in `src/utils/routes.ts`
- [x] **2.2** Sitemap priorities for agent routes (`src/app/sitemap.ts`)
- [x] **2.3** Root layout default metadata + JSON-LD (`src/app/layout.tsx`)
- [x] **2.4** Agent layout metadata + canonical (`src/app/agent/layout.tsx`)
- [x] **2.5** `/agent` page metadata (title, description, OG, keywords)
- [x] **2.6** `/agent/studio` metadata (`robots: noindex` until live API — optional)

## Phase 3 — Agent pages (UI only)

- [x] **3.1** `/agent` marketing page (hero, features, providers, CTAs)
- [x] **3.2** `/agent/studio` shell (provider select, instructions, mock run trace)
- [x] **3.3** `/agent/docs` architecture page (provider abstraction diagram)
- [x] **3.4** Waitlist / email capture block on `/agent` (landing `#waitlist` + mailto)

## Phase 4 — Home & navigation

- [x] **4.1** `NAV_LINKS` + footer product links (`siteContent.ts`)
- [x] **4.2** Header primary CTA to Agent studio (`Header.tsx`)
- [x] **4.3** Home hero agent-first (`HomeHero.tsx`)
- [x] **4.4** Home sections: agent strip + “Also on Reactopia” (`HomeSections.tsx`, `page.tsx`)
- [x] **4.5** Site footer blurb (`SiteFooter.tsx`)

## Phase 5 — Secondary surfaces

- [x] **5.1** `/ai` page points to `/agent` (roadmap, not duplicate story)
- [x] **5.2** `/about` one paragraph on Agent alpha
- [x] **5.3** Changelog entry for front-face launch
- [ ] **5.4** Browse home card or banner “Agent UI primitives” (optional)

## Phase 6 — SEO polish

- [x] **6.1** `SoftwareApplication` JSON-LD on `/agent`
- [x] **6.2** BreadcrumbList JSON-LD for agent section
- [x] **6.3** Internal links from home → agent → studio (crawl path)
- [x] **6.4** Review `robots.ts` (allow `/agent`)

## Phase 7 — Backend (out of scope for front-face)

- [ ] **7.1** `POST /api/agent/run` provider adapter (Anthropic)
- [ ] **7.2** Google Gemini adapter
- [ ] **7.3** Run persistence + auth
- [ ] **7.4** Remove `noindex` on studio when live

---

## Pick order (recommended)

1. Phase 1 → 2 → 3.1–3.2 → 4 → 5.1 → 3.3 → 6.1–6.3

## Phase 8 — Startup landing restructure (2026-10-08)

- [x] **8.1** Unified `StartupLanding` for `/` and `/agent`
- [x] **8.2** Product demo panel, how-it-works, pillars, early access CTA
- [x] **8.3** Nav: Product · Studio · Docs · Developers · About
- [x] **8.4** Home SEO: page metadata + Organization + SoftwareApplication JSON-LD

## Phase 9 — Anti-slop pass (2026-10-08)

- [x] **9.1** Remove violet gradients, fake window chrome, pillar/how-it-works templates
- [x] **9.2** Honest `ALPHA_BUILD` checklist instead of marketing pillars
- [x] **9.3** Alpha badge aligned with site amber status chips
- [x] **9.4** Plain contact strip (no “early access” band)

Update checkboxes in this file as tasks complete.