content-grade 1.0.4 → 1.0.6

package/README.md

@@ -3,39 +3,41 @@
 > AI-powered content quality scoring for developers and content teams. Score any blog post, landing page, ad copy, or email — in under 30 seconds. No API keys. No accounts. Runs on your local Claude CLI.
 
 [![npm](https://img.shields.io/npm/v/content-grade.svg)](https://www.npmjs.com/package/content-grade)
+[![npm downloads/month](https://img.shields.io/npm/dm/content-grade.svg)](https://www.npmjs.com/package/content-grade)
+[![npm downloads/week](https://img.shields.io/npm/dw/content-grade.svg)](https://www.npmjs.com/package/content-grade)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 [![Requires Claude CLI](https://img.shields.io/badge/requires-Claude%20CLI-orange)](https://claude.ai/code)
+[![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-blue?logo=github)](https://github.com/content-grade/Content-Grade/discussions)
+[![Early Adopter seats open](https://img.shields.io/badge/Early%20Adopter-50%20seats%20open-success)](EARLY_ADOPTERS.md)
 
 ---
 
 ## 60-second quickstart
 
 ```bash
-# 1. Verify Claude CLI is installed and logged in
-claude -p "say hi"
-
-# 2. Run instant demo — no file needed, see results in ~30 seconds
+# Step 1: See it in action — instant demo, no file needed
 npx content-grade
 
-# 3. Analyze your own content (grade is an alias for analyze)
+# Step 2: Score your own content
+npx content-grade grade README.md
 npx content-grade grade ./my-post.md
-npx content-grade analyze ./my-post.md
-
-# 4. CI pipeline — get raw JSON or score-only output
-npx content-grade analyze ./post.md --json
-npx content-grade analyze ./post.md --quiet   # prints score number only
 
-# 5. Grade a headline
+# Step 3: Grade a headline
 npx content-grade headline "Why Most Startups Fail at Month 18"
-
-# 6. Unlock Pro (batch mode, 100/day limit)
-npx content-grade activate
 ```
 
-**One requirement:** [Claude CLI](https://claude.ai/code) must be installed and logged in. No API keys, no accounts, no data leaves your machine.
+**One requirement:** [Claude CLI](https://claude.ai/code) must be installed and logged in (`claude login`). No API keys, no accounts, your content never leaves your machine.
 
-**Free tier:** 50 analyses/day, no signup needed. `npx content-grade grade README.md` works immediately.
+**Free tier:** 50 analyses/day. No signup. `npx content-grade grade README.md` works immediately.
+
+```bash
+# More commands
+npx content-grade https://yourblog.com/post    # analyze any URL
+npx content-grade analyze ./post.md --json     # raw JSON for CI pipelines
+npx content-grade analyze ./post.md --quiet    # score number only (for scripts)
+npx content-grade activate                     # unlock Pro: batch mode, 100/day
+```
 
 ---
 
@@ -82,7 +84,7 @@ npx content-grade activate
   1. Why 90% of SaaS Startups Fail at Month 18 (and How to Be the 10%)
   2. The Month 18 Startup Trap: What Kills Growth-Stage Companies
 
-  Unlock team features at contentgrade.dev
+  Unlock team features at content-grade.github.io/Content-Grade
 ```
 
 ---
@@ -139,7 +141,7 @@ Launch with `content-grade start` — opens at [http://localhost:4000](http://lo
 | **EmailForge** | `/email-forge` | Subject line + body copy for click-through optimization |
 | **AudienceDecoder** | `/audience` | Twitter handle → audience archetypes and content patterns |
 
-Free tier: **50 analyses/day per tool**. Pro ($9/mo): **100 analyses/day** + all tools.
+Free tier: **50 analyses/day per tool**. Pro ($19/mo): **100 analyses/day** + all tools.
 
 ---
 
@@ -317,7 +319,7 @@ Stripe variables are entirely optional — all tools work without them; upgrade
 ## Self-hosting / Development
 
 ```bash
-git clone https://github.com/StanislavBG/Content-Grade
+git clone https://github.com/content-grade/Content-Grade
 cd Content-Grade
 npm install
 npm run dev     # hot reload: server at :4000, client at :3000
@@ -348,6 +350,11 @@ tests/
 
 **REST API:** The web dashboard exposes a full REST API at `http://localhost:4000`. See [`docs/api.md`](./docs/api.md) for the complete reference — every endpoint, request shape, response schema, and cURL examples.
 
+**Documentation:**
+- [`docs/getting-started.md`](./docs/getting-started.md) — step-by-step first-run guide
+- [`docs/examples.md`](./docs/examples.md) — real-world examples for all 6 tools, CI/CD workflows, Node.js integration
+- [`docs/api.md`](./docs/api.md) — full REST API reference
+
 **Run tests:**
 
 ```bash
@@ -709,7 +716,7 @@ echo "$DATE,$HEADLINE,$SCORE" >> headline-scores.csv
 
 | | Free | Pro |
 |-|------|-----|
-| Price | Free forever | $9/month |
+| Price | Free forever | $19/month |
 | Analyses/day (CLI) | Unlimited | Unlimited |
 | Analyses/day (web dashboard, per tool) | 3 | 100 |
 | HeadlineGrader (single grade) | ✓ | ✓ |
@@ -736,6 +743,66 @@ The web dashboard works the same way — every tool call goes through `claude -p
 
 ---
 
+## Community
+
+ContentGrade is built in public. The community is the roadmap.
+
+### GitHub Discussions
+
+**[Join the conversation →](https://github.com/content-grade/Content-Grade/discussions)**
+
+| Category | What it's for |
+|----------|--------------|
+| [Q&A](https://github.com/content-grade/Content-Grade/discussions/new?category=q-a) | "Why is my score lower than expected?" — questions get answered here |
+| [Show & Tell](https://github.com/content-grade/Content-Grade/discussions/new?category=show-and-tell) | Share your workflow, integration, or results — early adopters post here |
+| [Ideas](https://github.com/content-grade/Content-Grade/discussions/new?category=ideas) | Feature requests and suggestions before they become issues |
+
+### Early Adopter Program — 50 seats
+
+**[EARLY_ADOPTERS.md](EARLY_ADOPTERS.md)** — The first 50 users who install and share feedback get:
+
+- **Pro tier free for 12 months** ($19/mo value)
+- Direct feedback channel with the maintainer
+- Name in CONTRIBUTORS.md (permanent)
+- Roadmap preview + design input before features ship
+- 30-minute onboarding call (optional)
+
+One action to claim: run ContentGrade, then post in [Show & Tell](https://github.com/content-grade/Content-Grade/discussions/new?category=show-and-tell) with `[Early Adopter]` in the title.
+
+### Champions Program
+
+Power users who go beyond early adoption get early access to `@beta` releases, a private Champions discussion thread, and a SVG badge for their profile. See **[CHAMPIONS.md](CHAMPIONS.md)** for selection criteria and current members.
+
+### Contributing
+
+See **[CONTRIBUTING.md](CONTRIBUTING.md)** for local dev setup, PR guidelines, and how to write good bug reports. The short version: clone → `pnpm install` → `pnpm dev` → file a PR. All contributions get a review within 48 hours.
+
+### Roadmap
+
+**[ROADMAP.md](ROADMAP.md)** — what's built, what's next, what's planned, and what we're deliberately not doing. Open a [Discussion](https://github.com/content-grade/Content-Grade/discussions/new?category=ideas) to challenge or extend it.
+
+### Feedback Loop
+
+**[FEEDBACK_LOOP.md](FEEDBACK_LOOP.md)** — how feedback flows into product decisions. Monthly structured check-ins, 48h triage SLA, and roadmap sync. Use the [monthly feedback template](https://github.com/content-grade/Content-Grade/issues/new?template=monthly_feedback.yml) to share your experience.
+
+### Contributors
+
+**[CONTRIBUTORS.md](CONTRIBUTORS.md)** — everyone who has improved ContentGrade. Code, bug reports, and real-world feedback all count. Early Adopters and Champions are listed here permanently.
+
+### Use ContentGrade in your project
+
+Add a badge to show your content meets the bar:
+
+```markdown
+[![content-grade](https://img.shields.io/badge/content--grade-passing-brightgreen)](https://www.npmjs.com/package/content-grade)
+```
+
+Score-specific badge: `https://img.shields.io/badge/content--grade-{SCORE}%2F100-brightgreen`
+
+See [docs/social-proof/built-with-badge.md](docs/social-proof/built-with-badge.md) for SVG assets and CI integration examples.
+
+---
+
 ## License
 
 MIT