docs: add growth & product roadmap

[rubenmarcus]

Adds ROADMAP.md with the combined product + growth plan:

• Part 1 — why aeo.js can go viral (score sharing, zero-friction try-out, distribution loops)
• Part 2 — product priorities: unify remote scoring with check.aeojs.org + npx aeo.js check <url>, badge endpoint + public JSON API on the checker, browser extension rebuild, GitHub Action, SvelteKit/Remix plugins, MCP server, AI crawler analytics, autofix mode
• Part 3 — growth & social plan: launch ladder (Show HN → badges → extension on Product Hunt → Action → MCP), content engine, ecosystem distribution, built-in viral loops, weekly metrics
• Part 4 — suggested 8-week sequence pairing each product milestone with its marketing beat

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
aeo-js	Ready	Preview, Comment	Jun 10, 2026 10:54am

[greptile-apps]

Greptile Summary

This PR adds ROADMAP.md, a combined product and growth planning document for aeo.js. It outlines viral mechanics, prioritised feature work (remote scoring unification, badge/API endpoints, browser extension rebuild, GitHub Action, SvelteKit/Remix plugins, MCP server, crawler analytics, autofix), a social launch ladder, and a suggested 8-week execution sequence.

• No code is changed; all impact is limited to this new documentation file.
• Three occurrences of the local path ~/work/aeochecker (lines 7, 38, and 163) will be publicly visible on GitHub and should be replaced with a repo reference or generic descriptor.

Confidence Score: 4/5

Safe to merge — this is a documentation-only change with no code impact.

The only actionable finding is three occurrences of a local filesystem path (~/work/aeochecker) that will be publicly visible in the repository, which is a minor disclosure concern rather than a code defect.

ROADMAP.md — the three local path references should be replaced with a repo URL or generic name before merging.

Important Files Changed

Filename	Overview
ROADMAP.md	New documentation-only file adding a 4-part growth and product roadmap; contains three references to a local filesystem path (~/work/aeochecker) that will be publicly visible on GitHub.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["npx aeo.js check <url>\n(CLI + shared remote-audit core)"] --> B["check.aeojs.org\n(web checker)"]
    A --> C["Public JSON API\n/api/v1/scan"]
    C --> D["Badge endpoint\n/api/badge?url=…"]
    C --> E["Browser Extension\n(MV3, popup score)"]
    C --> F["GitHub Action\naeo-check"]
    C --> G["MCP Server\naeo.js mcp"]
    D --> H["README Badges\n(viral distribution loop)"]
    E --> I["Product Hunt Launch"]
    F --> J["CI PR Comments\n(team spread)"]
    G --> K["Claude / Agent integration"]
    A --> L["aeo.js fix\n(autofix mode)"]
    B --> M["Leaderboard +\nScore History\n(Supabase)"]
    M --> N["Scheduled Rescans\n(Cloudflare Cron)"]

Loading

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
ROADMAP.md:7
**Local filesystem path leaked in public document**

`~/work/aeochecker` is a local machine path that appears three times in this file (lines 7, 38, and 163). Since `ROADMAP.md` will be publicly visible on GitHub, this leaks information about the developer's local directory structure. Replace with the repository name/URL (e.g. `multivmlabs/aeochecker`) or a generic descriptor like "the companion app repo".

_{Reviews (1): Last reviewed commit: "docs: add growth & product roadmap" | Re-trigger Greptile}

[greptile-apps]

Local filesystem path leaked in public document

~/work/aeochecker is a local machine path that appears three times in this file (lines 7, 38, and 163). Since ROADMAP.md will be publicly visible on GitHub, this leaks information about the developer's local directory structure. Replace with the repository name/URL (e.g. multivmlabs/aeochecker) or a generic descriptor like "the companion app repo".

Prompt To Fix With AI

This is a comment left during a code review.
Path: ROADMAP.md
Line: 7

Comment:
**Local filesystem path leaked in public document**

`~/work/aeochecker` is a local machine path that appears three times in this file (lines 7, 38, and 163). Since `ROADMAP.md` will be publicly visible on GitHub, this leaks information about the developer's local directory structure. Replace with the repository name/URL (e.g. `multivmlabs/aeochecker`) or a generic descriptor like "the companion app repo".

How can I resolve this? If you propose a fix, please make it concise.