SEOVentra — The Bible 🚀
Your single source of truth: build, security, no-bug discipline, growth from 1 week to 5 years, marketing and business. Rebuilt from the actual codebase — 24 D1 migrations, 30 API route files, 42 free tools — not just the founder roadmap docs.
🧭 How to use this tracker
This file is self-contained — no login, no cloud dependency. Everything lives in your browser, with backup/restore to keep it safe across devices.
1
Navigate with the sidebar — grouped by System Map, Product Pillars, Platform Operations, Security/QA, Growth Timeline, and Marketing/Business.
2
Click any task to mark it done (turns green ✓). Click again to unmark.
3
Growth Timeline has horizon tabs — 1 Week, 1 Month, 3/6/12 Months, 2–5 Years — each with its own focus and checklist.
4
Press "💾 Save Progress" (or Ctrl+S) — saves to browser localStorage. Progress persists between sessions.
5
Use "⬇ Backup / Restore" to download a .json file regularly. Re-import on any device to sync progress — treat this like a save file.
Tasks Done
0
of 0 total tracked tasks
Overall Progress
0%
Across every pillar
Current Phase
Phase 0
Public Audit Engine
Product Pillars
3 live + 1 planned
Workspace · Discover · AI Studio + Backlinks Intelligence
Loading…0%
🎯 Today's Mission
Loading…
💸 AI Spend (month)$0
❤️ Platform Health—
🚦 Release Ready0 / 4
🔐 Critical Security Closed0 / 0
🕓 Recent Activity
- No activity yet — tick a task to get started.
The honest position, restated: the codebase is genuinely ahead of both founder roadmap docs. Discover (Product-Hunt-style directory with sponsorship), Content Engine, Brand Intelligence, and real Razorpay Create-Order billing with region-aware pricing are all live — none of that reads as "done" in the old roadmap. Backlinks Intelligence is the one major pillar from the vision doc genuinely not started. Focus here, not on re-building what already works.
✅ Shipped Since Last Roadmap Update — Verified From Code
- Discover Platform — full Product Hunt-style directory: submissions, upvotes, comments, launch calendar, self-serve scheduling, leaderboard, real vote-velocity trending, maker profiles, 3 live editorial pillars (migration 0023)
- Directory Sponsorship — Featured / 3 independently-priced Category Rank tiers / Badge-Only, USD-anchored region-aware pricing with its own GST invoicing (migration 0021, pricing.ts v4.0.0)
- Content Engine — full AI article generation with source provenance tracking (migrations 0018/0019), Content Optimizer, Content Briefs reusing the same proven cascade
- Brand Intelligence — AI auto-detects brand voice from a verified domain (migration 0017)
- Per-account login lockout on top of existing per-IP rate limiting (migration 0024) — closes a real credential-stuffing gap
- Pro-gating security audit closed 6 real money-leaking endpoints (AI Visibility, Keyword Scoring, Content Engine, Discounts admin, GST fallback)
- 42 public free tools + 33 dashboard tool variants, 6 solutions/vertical pages, 3 head-to-head comparison pages
- Referrals, team invites, embeddable badges, weekly digest email, discount codes — all live
📐 The Core Question
Before building any new feature: is this genuinely new capability, or does it already exist somewhere in the 30 route files and just needs frontend surfacing? Check the codebase before writing the roadmap item — this exact mistake (roadmap saying "planned" for things already shipped) is why this tracker needed a full rebuild.
SEOVentra
│
├── Core (auth, orgs, billing, storage — DONE)
├── Public Audit Engine (anonymous audit, claim-on-signup — DONE)
├── SEO Workspace (audits, indexing, keywords, GSC — MOSTLY DONE)
├── Discover Platform (directory, sponsorship — DONE)
├── AI Studio (visibility, brand intel, content engine — MOSTLY DONE)
├── Free Tools Suite (42 public + 33 dashboard tools — DONE)
├── Admin Console (12 pages, operator control plane — DONE)
├── Marketing Site (blog, solutions, comparisons, docs — DONE)
├── Growth Systems (referrals, teams, badges, digest — DONE)
│
└── Backlinks Intelligence (Phase 3 — NOT STARTED)
└── the one major vision-doc pillar still missing
North Star & Strategy
The strategic frame every other decision in this tracker hangs off of.
🧭 The Strategic Shift
SEOVentra is a unified Growth Operating System — 4 pillars that reinforce each other, not 4 separate products bolted together.
SEO Workspace (operational SEO), Discover Platform (traffic + authority via the directory), Backlinks Intelligence (opportunity discovery — not yet built), and AI Studio (content + AI visibility). Each module is meant to generate traffic, authority, data, and revenue for the others — that ecosystem effect is the actual moat, not any single feature.
⚠️ The Open Question This Tracker Answers
Roadmap vs. reality had drifted significantly. Both founder roadmap docs describe Phase 1 features (basic utility tools, directory MVP) as current-state, while the actual code is running a live sponsored directory, a content engine with source provenance, brand intelligence, and real region-aware billing. This tracker is now grounded in the code, not the roadmap docs — treat any future roadmap doc as secondary to what the migrations and route files actually say.
📊 Wrong Metric vs Correct Metric
Track outcomes, not activity. A claimed audit or a published article is the actual unit of value delivered — not a page view or a generation event.
| Instead of tracking | Track this | Why it matters |
|---|---|---|
| Audits started | Audits claimed (signup conversion) | An unclaimed partial report delivered no funnel value |
| Tool page views | Tool → signup conversion rate | Free tools exist to feed the funnel, not rack up traffic for its own sake |
| Directory submissions | Submissions approved + upvoted | Directory quality is the moat, not raw listing count |
| AI content generated | AI content generated AND published | Generation alone isn't the goal — the user shipping it is |
| — | Sponsored listing renewal rate | A sponsor who doesn't renew is telling you the placement didn't work |
| — | Rankings / AI-visibility improved for real customers | The actual promise SEOventra makes to a paying customer |
🏷️ Revenue Model — The Real, Admin-Editable Pricing
USD-anchored, region-aware (INR shown only to India-detected users), fully admin-editable via pricing.ts v4.0.0 — not the placeholder ₹499/₹1499/₹3999 figures in the old roadmap docs.
| Tier | Access | AI Tier | Price |
|---|---|---|---|
| Free | Anonymous audit + basic dashboard | Groq → Gemini → heuristic only | $0 |
| Pro Lite | Full technical audit, AI visibility, basic competitor insights | Same free cascade, higher caps | $10/mo · $7/mo yearly |
| Pro | Deep semantic analysis, bulk audits, content engine | Adds Claude/OpenAI | $29/mo · $19/mo yearly |
| Business | White-label, API access, team seats | Paid cascade, highest ceilings | $79/mo · $59/mo yearly |
Guiding Principles
Every architectural and pricing decision should comply. Re-read before any sprint that touches more than one pillar.
Standing rule for every decision: if a system could be reused by more than one product pillar (Workspace, Discover, Backlinks, AI Studio), it belongs in Core. If it's specific to one pillar's logic, it lives inside that pillar's own routes and tables.
1
One login, one dashboard, one billing system
A user experiences SEOVentra as one product with 4 capability areas, never as separate apps requiring separate accounts.
2
Money earned must always exceed money spent — the Golden Rule
Every AI-cost-bearing endpoint must be Pro-gated with no exceptions. This has already leaked money twice (6 endpoints in one audit) — treat any new AI-calling route as guilty until proven gated.
3
The free tier AI boundary is a hard code boundary, not a convention
source='free' means Groq → Gemini → heuristic only. Claude/OpenAI are never touched even if keys exist — verified in ai-scorer.ts, keep it that literal on every new AI feature.
4
Every org-scoped table is filtered by org_id, with zero exceptions
A single missing filter is a cross-customer data leak. This is the #1 item on the risk register — treat it that way.
5
Pricing is USD-anchored and region-aware everywhere, with no exceptions
Subscriptions and directory sponsorship both follow this model after pricing.ts v4.0.0 — any new revenue stream (Marketplace, API tiers) must follow the same pattern, not reintroduce flat-INR pricing.
6
Admin-editable, not hardcoded — for anything that changes over time
Pricing, plan limits, discount codes, sponsorship rank pricing — all live in D1, editable from the Admin Console without a redeploy.
7
Migration comment blocks explain WHY, not just the SQL
This house style (see 0020–0024) is what made rebuilding this tracker from the actual codebase possible — keep it, it pays for itself repeatedly.
8
If a schema exists but the frontend doesn't, log it in Technical Debt — don't lose it
score_gain, llms.txt display, domain-profile auto-generation are all real, proven backend work sitting unused because the frontend never caught up. This is a recurring pattern here — watch for it.
9
Track claimed audits and published content, not generation events
A completed, real-world outcome is the unit of value — not a prompt sent or an audit started and abandoned.
10
Ahrefs/SEMrush replacement is explicitly out of scope
Compete on workflow, AI visibility, and ecosystem effect — not on out-building a 10-year-old backlink index.
All Systems
Every internal system across SEOVentra. Status, maturity, and dependencies — auto-tracked from your checklists, the rest editable inline.
Identity, Organizations & Core
One login system, org-based multi-tenancy, RBAC, storage, and settings — the foundation every pillar depends on.
Confirmed live: email/password + Google OAuth, JWT sessions, org-scoped RBAC, per-account login lockout (migration 0024), R2 asset storage, KV-backed sessions and rate limits, Cloudflare Cron for scheduled jobs.
🔐 Identity & Authentication
Email/password + Google OAuth, JWT sessions all working in production
RBAC middleware confirmed on every mutating route
Per-account login lockout on top of per-IP rate limiting
🏢 Organizations & Teams
Org creation, personal org auto-created on signup, org suspension enforced at auth middleware
Team invites — org_invites table, email invite flow, accept/decline
🗄️ Storage, Settings & Infra
R2-backed storage for directory logos and generated assets
KV for sessions, rate limits, badge SVG cache (5-min TTL)
Cloudflare Cron Triggers — referral confirmation, weekly digest, health checks
Sane defaults so nothing requires configuration before first use
D1 schema (24 migrations) confirmed matches Drizzle definitions in production
Input validation (packages/validators) confirmed applied on every route boundary, not just the convenient ones
Billing & Subscriptions
Razorpay Create-Order flow (order-based, not subscriptions), USD-anchored region-aware pricing, GST invoicing, discount codes, admin-editable plan limits. billing.ts is on v3.2.0.
Exposes: pricing.ts v4.0.0 (getPricing, getPaisesForPlan, daysForPlanType), plan-limits.ts (getPlanLimits, limitLabelLocal). Directory sponsorship shares the same pricing philosophy via getPaisesForSponsorship.
💳 Core Billing
Razorpay Create-Order flow + webhook signature verification integrated
Plan limits enforced at the API layer, admin-editable via plan_limits_config, -1 = unlimited
USD-anchored pricing, INR shown only to India-detected users, single source of truth (no separate hardcoded INR fields)
GST invoicing on subscriptions AND directory sponsorship (migration 0008, extended in 0021)
Golden Rule — reconfirmed: money earned must always exceed money spent. Every AI-cost-bearing endpoint must be Pro-gated with no exceptions. Pro-gating gaps have clustered in admin routes and GET endpoints twice now — give those extra scrutiny in every future audit.
Critical Build Order
The spine of the platform. Build top to bottom — each layer unlocks the next. Support modules run in parallel alongside it.
🪜 The Spine
🔧 Support Modules (parallel, non-blocking)
Impact & Priority
Score every system on Business Value, Engineering Effort, Reuse, Risk, and Strategic Fit. Click a star to re-rate — it's saved instantly.
🔎 Public Audit Engine ✓ Live
Anonymous domain-in → crawl → partial report flow. No account, no verification, no install. public-audit.ts is on v2.0.0.
Flow: Domain input → crawl (default 10 pages, max 25) → partial results shown immediately → login unlocks full report → domain verification enables monitoring → upgrade unlocks Pro depth. Storage: public_audits table, token-based, 72h expiry, claimed_by_user_id on signup — no re-crawl needed after claim.
🕵️ Anonymous Flow
Zero-signup domain audit — crawl depth default 10 / max 25 pages
public_audits token storage — 72h expiry, claim-on-signup via claimed_by_user_id
Partial results shown instantly — Health/SEO/AI/Performance/Trust scores, top 3-5 issues, benchmark percentile
🧪 Audit Modules
Technical SEO — titles, meta, canonicals, robots.txt, sitemap, headings, links, redirects, HTTPS
AI Visibility — content structure, semantic relevance, entity coverage, FAQ schema, EEAT, AI readability
Performance — LCP, CLS, INP, TTFB, render blocking, image optimisation, JS weight
Trust & Authority — author pages, contact info, privacy/terms/about, org schema
🔓 Locked Sections & Conversion
Free-login unlocks — full 47-check technical audit, EEAT report, recommendations, PDF export, basic competitor insights
Pro unlocks — deep semantic analysis, entity coverage map, bulk audits (up to 500 pages), scheduled audits, white-label PDF, API access
score_gain per audit issue surfaced as a badge in the dashboard UI
🧰 SEO Workspace Mostly Live
Daily operational SEO management — site audits, indexing, keyword tracking, GSC integration. The pillar a paying customer lives in day to day.
Uses These Systems
🩺 Site Audits
10 audit-issue categories — broken links, missing titles/meta, thin content, duplicate titles, image alt issues, internal linking gaps, and more
audit-processor.ts (v1.0.0) — async job queue for full-site crawl audits
score_gain computed per issue at scan time — schema live, UI badge pending
📡 Indexing
4-provider indexing — Google, Bing, IndexNow, GSC URL Inspection API
Sitemap history & coverage tracking (migrations 0012, 0017)
GSC Inspect sweep limits, per-plan caps (migration 0016)
🔑 Keywords & GSC
keyword-scoring.ts — homepage + ai_scores crawl, cluster extraction, AI-scored citation potential, 6h KV cache
Keyword gap analysis vs. competitor domains
GSC OAuth — AES-GCM encrypted tokens, refresh flow
Sitemap validator / robots.txt checker tools wired into Workspace, not just the public tools suite
🚧 Remaining for This Pillar
Domain Profile (Brand Intelligence) auto-generation wired to fire on domain verification
llms.txt + AI-bot-blocked signals displayed on domain settings
Competitor tracking — top pages, keyword overlap, ranking comparisons
Automation — weekly scheduled audits, ranking-drop alerts, new-backlink alerts
🧭 Discover Platform ✓ Live
Product-Hunt-style SEO Apps Directory. The traffic acquisition and authority-generation pillar — genuinely ahead of what either roadmap doc describes.
Uses These Systems
📇 Directory Core ✓ Live
seo-apps.ts — submissions, categories, search/filter, tool detail pages
Upvotes + comments — comment_pins_favorites (migration 0005)
Launch calendar + self-serve scheduling, launch_notified tracking (migration 0006)
Leaderboard — today / week / month / all-time views
Real vote-velocity trending algorithm, not just raw upvote count
Maker profiles — claimed listings, cross-linking
3 live editorial pillar pages — directory_topics + discover_pillars (migrations 0002, 0023)
Abuse reporting on directory listings (migration 0007)
⚖️ Alternatives & Comparisons ✓ Live
Alternatives engine — vs-ahrefs, vs-semrush, vs-product-hunt style pages
Comparison engine — feature matrix, pricing comparison, use cases, recommendation
Tool owner dashboard — claim listing, edit, analytics, verification badge
Admin upvote boost tooling for editorial curation (migration 0022)
📌 Sponsorship & Monetization ✓ Live
directory-billing.ts (v1.0.0) — sponsored/paid placement purchase flow
Featured / 3 independently-priced Category Rank tiers / Badge-Only (migration 0020, priced correctly in pricing.ts v4.0.0)
GST invoicing on directory orders (migration 0021)
Embeddable "Featured on SEOVentra" badge — badge.ts, light/dark theme, 5-min KV cache
This pillar is ahead of the roadmap: both founder docs describe the directory as an MVP with basic submissions. In reality it's a full launch-calendar + trending + sponsorship business with its own GST invoicing. Treat Discover as a proven revenue engine to double down on, not a feature still being validated.
🧠 AI Studio Mostly Live
Visibility scoring, brand intelligence, and content generation — the pillar that turns SEO insight into AI-search-era content.
Uses These Systems
👁️ AI Visibility Scoring ✓ Live
ai-scorer.ts — GEO/AEO/EEAT + citation-potential scoring
Free-tier cascade hard-locked to Groq → Gemini → heuristic, paid tier adds Claude/OpenAI
ai_score_source provenance permanently recorded per score, not inferred from model_used (migration 0018)
🪪 Brand Intelligence ✓ Live
brand-profiler.ts (v1.0.0) — AI auto-detects brand voice from a verified domain
Domain profile schema live (migration 0017)
✍️ Content Engine ✓ Live
article-generator.ts — full article drafts via the proven AI cascade
content_article source provenance tracked (migration 0019)
content-optimizer.ts (v1.1.0) — refresh/optimize existing content
Content Briefs — full brief (title, target/secondary keywords, intent, outline, FAQ questions, word count) reusing generateOutline() from the article-generator cascade
🚧 Remaining for This Pillar
Content generation limits UI polish — content_generation_limits (migration 0013) has thin frontend surfacing
GEO cross-engine visibility monitoring — track brand mentions/citations in ChatGPT, Gemini, Claude, Perplexity directly (today's scoring is single-domain, not cross-engine)
Content Refresh Engine — outdated-content detection + decay alerts as a standalone scheduled feature
🔗 Backlinks Intelligence Not Started
The one major platform pillar from the vision doc with no code yet. Opportunity discovery and authority building — Phase 3.
Uses These Systems
🗄️ Backlink Database
Submit backlink source, DR/DA metrics, spam score
Niche / country / link-type / free-paid / indexed filters
Link types — guest post, directory, forum, SaaS listing, profile link, PR site, web 2.0, community
🔍 Opportunity Finder & Outreach CRM
Competitor link discovery + link gap analysis
Opportunity + difficulty scoring
Outreach CRM — save targets, notes, status (contacted/replied/negotiating/published/rejected)
👥 Community Contributions
Community submissions, moderation queue
Reputation points, verified submitters
This is the real gap. Three of four vision-doc pillars are live; this is the fourth. It's also the pillar most directly requested by SEO-professional users — gate the build on real demand signal (see Business & Revenue), not roadmap momentum alone.
🧪 Free Tools Suite ✓ Live — 42 Tools
The top-of-funnel engine. 42 public tool pages + 33 dashboard variants — far beyond the "5 utility tools" either roadmap doc describes.
🧰 Coverage
42 public /tools/ pages live — meta checker, robots.txt checker, sitemap validator, keyword density, heading analyzer, page speed, schema validator, and more
33 /dashboard/tools/ logged-in variants — richer output, saved history, org-scoped
6 solutions/vertical landing pages — agencies, creators, ecommerce, publishers, SaaS, SEO pros
📈 Funnel Discipline
Every tool page has a unique, non-thin content block mapped to its own keyword — not templated filler
Clear CTA from every free tool back into the full audit / dashboard
Tool → signup conversion rate tracked per tool, not just aggregate traffic
This is the widest funnel in the product. 42 tools means 42 potential ranking pages and 42 separate keyword clusters — treat each as its own small SEO asset, not one generic "tools" section.
🛠️ Admin Console ✓ Live
The operator control plane. admin.ts is on v2.1.0 — central control for every operational lever without a code deploy.
Dev/Prod Parity Rule: all code runs identically in development and production. No environment-specific configs, no dev-only bypasses. Admin routes are protected by role middleware only — never by environment checks.
🎛️ Core Admin Modules
User Management — view/search/suspend/delete, role management, impersonate for debugging
Pricing Manager — plan prices, visibility toggles, promotional pricing, no code deploy needed
Audit Management — view all public + claimed audits, re-run, purge expired, inspect raw data
Domain & Verification — status view, manual verify for support cases, revoke
Feature Flags — per-plan or global toggle, gradual rollout by percentage
Directory & Marketplace moderation — approve/reject submissions, spam scoring, sponsored placement management
Discounts admin router — create/manage discount codes, now correctly Pro-gated after the security audit
Email & Comms — Resend delivery logs, template management, manual triggers
System Health — Worker status, queue depth, DB health, error rate, cron trigger status (health_snapshots, migration 0008)
Analytics Dashboard — active users, audit volume, conversion rates, plan distribution, revenue overview
🚧 Remaining
GSC Token Health — per-user OAuth token health view, force refresh, revoke
API Key Management — view issued keys, revoke, usage/rate-limit monitoring (blocked on Public API Layer, Phase 7)
🌐 Marketing Site
Public-facing pages beyond the app shell — blog, solutions, comparisons, docs. The organic-growth surface.
🏠 Core Pages ✓ Live
Landing page, pricing page, branding & design system
Blog architecture — SEO guides, tool comparisons, "best tools for X", AI SEO tutorials
6 solutions pages — agencies, creators, ecommerce, publishers, SaaS, SEO pros
Comparison pages — vs Ahrefs, vs SEMrush, vs Product Hunt
42 free tool landing pages, each independently indexable
🔍 Technical SEO Foundation
Server-rendered marketing & tool pages — never client-only render for SEO-critical pages
Canonical tags, sitemap.xml, robots.txt, IndexNow submission confirmed live on seoventra.com itself
Structured data (Organization, SoftwareApplication, FAQ schema) on marketing, tool, and directory pages
Core Web Vitals verified using the product's own page-speed tool — dogfood it
📄 Docs & Trust
Docs section for the (future) public API layer and general product help
Privacy policy, terms, GST invoicing details public and current
Changelog / public roadmap page published from real shipped versions
📈 Growth Systems ✓ Live
The built-in retention and expansion levers — referrals, teams, badges, digest emails, discount codes.
🔁 Live Systems
Built but under-instrumented. All six systems above exist in code — referrals.ts is on v1.1.0 with a real cron confirmation job. What's missing isn't more building, it's measuring: is the referral system actually producing confirmed conversions? Is the digest email being opened? See Business & Revenue for the instrumentation checklist.
🔐 Security Checklist
Categorized, severity-tagged, grounded in the actual codebase — including the Pro-gating audit that already found and closed 6 real money-leaking endpoints. Close every CRITICAL item before scaling paid traffic.
The platform's #1 named risk: multi-tenant data isolation. Every org-scoped table must be filtered by org_id with zero exceptions — a single missing filter is a cross-customer data leak. The #2 risk, already proven real twice: Pro-gating gaps on AI-cost-bearing endpoints.
✅ No-Bug / QA Policy
The discipline that keeps production clean. Adopt these as standing practice, not a one-time checklist.
The bar: a feature is not "done" until it works in production, not just locally. Every fixed critical/high bug gets a regression test so it can't silently come back — this is exactly why Pro-gating needs an automated test, not a third manual audit.
⏳ Growth Timeline — 1 Week → 5 Years
Every horizon has its own focus and checklist. Switch tabs to zoom in or out on the plan.
Phase Roadmap (0–7)
Reconciled against actual shipped code, not just the founder docs. Click a phase to expand.
🛰️ Future Modules
Phase 5–8 from the vision doc. Not yet built — sequence these by real demand signal, not roadmap momentum.
📋 Tracked Tasks
Backlinks Intelligence — DR/DA directory, opportunity finder, outreach CRM (Phase 3)
GEO visibility monitoring — track brand mentions across ChatGPT, Gemini, Claude, Perplexity
Chrome Extension — quick SEO metrics, page audit, backlink + schema detection on any page
SEO Marketplace — agencies, freelancers, writers, consultants with verified badges
Public API layer — Audit API, Metrics API, Keyword API on issued API keys
Community features — discussions, growth logs, public SEO experiments
📣 Marketing Channels
How to play reachability — owned content, product-led growth, community, partnerships, and paid (only after PMF signal).
✅ Marketing Action Checklist
🔍 SEO Playbook
Technical foundation, keyword strategy, link building, and measurement — how SEOVentra plays its own game on itself.
The dogfooding test: SEOventra sells SEO tooling — it has zero excuse for its own site to fail Core Web Vitals, miss structured data, or leave a canonical tag unset. Every item below should be visibly true on seoventra.com itself.
✅ SEO Action Checklist
💼 Business & Revenue
Pricing, unit economics, retention, and capital strategy — grounded in the real pricing.ts v4.0.0 model.
💳 Subscription Tiers
📌 Directory Sponsorship Pricing
✅ Business Action Checklist
Ownership Matrix
The most important document. Before building any feature — check this first.
The core question: could more than one pillar (Workspace, Discover, Backlinks, AI Studio) reuse this in the next 12 months? YES → Build in Core. NO → Build inside that pillar's own routes/tables.
Feature Ownership
| Feature | Owner | Location | Notes |
|---|---|---|---|
| Authentication & RBAC | Core | apps/api/routes/auth.ts | Every pillar imports this — v1.2.0 |
| Billing & Pricing | Core | apps/api/services/pricing.ts | v4.0.0 — single source of truth, admin-editable |
| AI Provider Cascade | Core | apps/api/services/ai-scorer.ts | Groq→Gemini→heuristic (free) / +Claude/OpenAI (paid) — only entry point for AI calls |
| Storage (R2/KV) | Core | apps/api routes | Directory logos, badge cache, session store |
| Public Audit Engine | Audit Pillar | apps/api/routes/public-audit.ts | v2.0.0 — feeds Workspace on claim |
| Site Audits, Indexing, Keywords | SEO Workspace | apps/api/routes/* | Domain logic only, calls Core for auth/billing |
| Directory (submissions, upvotes, launches) | Discover | apps/api/routes/seo-apps.ts | Domain logic only |
| Directory Sponsorship | Discover | apps/api/routes/directory-billing.ts | v1.0.0 — reuses Core pricing model, not a separate one |
| Content Engine / Brand Intelligence | AI Studio | apps/api/services/article-generator.ts, brand-profiler.ts | Calls Core AI cascade internally |
| Backlink Database / Outreach CRM | Backlinks (planned) | not yet built | Phase 3 |
| Referrals, Teams, Badges, Digest | Core (Growth) | apps/api/routes/referrals.ts, team.ts, badge.ts | Shared across all pillars |
Cross-Pillar Matrix
Which product pillars consume which internal systems — and how built-out each pairing already is.
🚫 Kill List
Do NOT build any of these before real demand signal. Re-read this before every sprint.
If you find yourself about to build one of these: stop, re-read the Guiding Principles, and ask if there's a simpler path.
Tech Stack
Confirmed choices from the actual codebase.
⚠️ Risk Register
Named risks with their mitigation — revisit quarterly. Two of these are proven-real, not hypothetical.
AI Cost Dashboard
Track AI spend across the real provider cascade — Groq → Gemini → Workers AI (free tier), Anthropic/OpenAI (paid tier). Plug in real numbers as usage logs come in.
Platform Health
A weighted self-assessment across the dimensions that actually predict production pain. Adjust sliders as things change.
Release Readiness
A pillar is marked "Ready" only when its overall score is ≥85%, testing ≥70%, and docs ≥50%. No exceptions — that's the bar that prevents shipping broken things.
Technical Debt
Real schema-built-but-frontend-missing gaps, plus any new shortcuts you take on purpose. Log them here so they get paid down deliberately instead of forgotten.
Title
Severity
Est. hours
Decisions Log
Lightweight Architecture Decision Records. Capture the why, not just the what — future you will thank present you.
Decision
Reason
Alternatives considered
My Notes
Free-form workspace. What you're building today, blockers, ideas.
Current Focus
Blockers
Next 3 Actions
Decisions Made (free-form)
Open Questions
Abandoned / Deprioritized
Ideas Backlog