docs(discovery): strengthen public entry points

Author: Contentrain

README.md

@@ -3,6 +3,7 @@
 [![npm: @contentrain/mcp](https://img.shields.io/npm/v/%40contentrain%2Fmcp?label=%40contentrain%2Fmcp)](https://www.npmjs.com/package/@contentrain/mcp)
 [![npm: contentrain](https://img.shields.io/npm/v/contentrain?label=contentrain)](https://www.npmjs.com/package/contentrain)
 [![npm: @contentrain/query](https://img.shields.io/npm/v/%40contentrain%2Fquery?label=%40contentrain%2Fquery)](https://www.npmjs.com/package/@contentrain/query)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 **Repo-native content governance for AI agents.**
@@ -22,6 +23,12 @@ npx contentrain serve       # open the local review UI
 
 That's it. You now have a governed content workspace with models, validation, review branches, and a local UI — no account, no cloud, no proprietary content format.
 
+Start here:
+
+- [See the 2-minute demo](https://ai.contentrain.io/demo)
+- [Read the docs](https://ai.contentrain.io)
+- [Open the normalize guide](https://ai.contentrain.io/guides/normalize)
+
 ## What Contentrain is for
 
 - **Rescuing hardcoded strings** from existing apps and turning them into structured, translatable content
@@ -162,7 +169,10 @@ npx contentrain doctor       # setup health check
 
 ## Documentation
 
-**[ai.contentrain.io](https://ai.contentrain.io)** — full docs with guides, reference, and framework integration.
+- **[2-Minute Demo](https://ai.contentrain.io/demo)** — the fastest way to understand the product
+- **[Getting Started](https://ai.contentrain.io/getting-started)** — install, connect an agent, and run the first workflow
+- **[Normalize Guide](https://ai.contentrain.io/guides/normalize)** — the main hardcoded-string rescue flow
+- **[Full Docs](https://ai.contentrain.io)** — guides, package reference, and framework integration
 
 ## Development
 

packages/cli/README.md

@@ -2,9 +2,16 @@
 
 [![npm version](https://img.shields.io/npm/v/contentrain?label=contentrain)](https://www.npmjs.com/package/contentrain)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/cli)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/cli)
 
 CLI for Contentrain.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [CLI docs](https://ai.contentrain.io/packages/cli)
+- [Getting started](https://ai.contentrain.io/getting-started)
+
 `contentrain` is the local operations surface for a Contentrain project:
 
 - initialize `.contentrain/` in an existing repo

packages/cli/package.json

@@ -9,7 +9,7 @@
     "url": "git+https://github.com/Contentrain/ai.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/Contentrain/ai/tree/main/packages/cli",
+  "homepage": "https://ai.contentrain.io/packages/cli",
   "bugs": {
     "url": "https://github.com/Contentrain/ai/issues"
   },

packages/mcp/README.md

@@ -2,9 +2,16 @@
 
 [![npm version](https://img.shields.io/npm/v/%40contentrain%2Fmcp?label=%40contentrain%2Fmcp)](https://www.npmjs.com/package/@contentrain/mcp)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/mcp)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/mcp)
 
 Local-first MCP server and core primitives for Contentrain.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [MCP package docs](https://ai.contentrain.io/packages/mcp)
+- [Normalize guide](https://ai.contentrain.io/guides/normalize)
+
 Contentrain is AI-generated content governance infrastructure:
 
 - agent produces content decisions

packages/mcp/package.json

@@ -10,7 +10,7 @@
     "url": "git+https://github.com/Contentrain/ai.git",
     "directory": "packages/mcp"
   },
-  "homepage": "https://github.com/Contentrain/ai/tree/main/packages/mcp",
+  "homepage": "https://ai.contentrain.io/packages/mcp",
   "bugs": {
     "url": "https://github.com/Contentrain/ai/issues"
   },

packages/rules/README.md

@@ -2,9 +2,15 @@
 
 [![npm version](https://img.shields.io/npm/v/%40contentrain%2Frules?label=%40contentrain%2Frules)](https://www.npmjs.com/package/@contentrain/rules)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/rules)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/rules)
 
 Shared AI-agent rules for Contentrain.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [Rules & skills docs](https://ai.contentrain.io/packages/rules)
+
 This package is the policy layer of the Contentrain ecosystem. It defines how agents should behave when they work with:
 
 - Contentrain MCP tools

packages/rules/package.json

@@ -9,7 +9,7 @@
     "url": "git+https://github.com/Contentrain/ai.git",
     "directory": "packages/rules"
   },
-  "homepage": "https://github.com/Contentrain/ai/tree/main/packages/rules",
+  "homepage": "https://ai.contentrain.io/packages/rules",
   "bugs": {
     "url": "https://github.com/Contentrain/ai/issues"
   },

packages/sdk/js/README.md

@@ -2,9 +2,16 @@
 
 [![npm version](https://img.shields.io/npm/v/%40contentrain%2Fquery?label=%40contentrain%2Fquery)](https://www.npmjs.com/package/@contentrain/query)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/sdk/js)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/sdk)
 
 **Optional** type-safe generated query SDK for Contentrain.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [SDK docs](https://ai.contentrain.io/packages/sdk)
+- [Framework integration guide](https://ai.contentrain.io/guides/frameworks)
+
 Contentrain stores content as plain JSON and Markdown in a git-backed `.contentrain/` directory. Any platform that reads JSON can consume this content directly. This package adds a TypeScript convenience layer that turns content models into a generated JS/TS client with:
 
 - exact TypeScript types from your models

packages/sdk/js/package.json

@@ -9,7 +9,7 @@
     "url": "git+https://github.com/Contentrain/ai.git",
     "directory": "packages/sdk/js"
   },
-  "homepage": "https://github.com/Contentrain/ai/tree/main/packages/sdk/js",
+  "homepage": "https://ai.contentrain.io/packages/sdk",
   "bugs": {
     "url": "https://github.com/Contentrain/ai/issues"
   },

packages/skills/README.md

@@ -2,9 +2,16 @@
 
 [![npm version](https://img.shields.io/npm/v/%40contentrain%2Fskills?label=%40contentrain%2Fskills)](https://www.npmjs.com/package/@contentrain/skills)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/skills)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/rules)
 
 Workflow skills and framework guides for Contentrain-aware AI agents.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [Rules & skills docs](https://ai.contentrain.io/packages/rules)
+- [Framework integration guide](https://ai.contentrain.io/guides/frameworks)
+
 This package follows the [Agent Skills standard](https://agentskills.io) for progressive disclosure: each skill has a `SKILL.md` (loaded on activation) and optional `references/` (loaded on demand).
 
 ## Install