For engineers and contributors. User-facing documentation lives at /docs.

v1.9 Product Plan

Core promise: One report, evidence-backed, low friction. No broken promises in copy (either allow one run without sign-up or state sign-in required).


In scope for v1.9

2.1 Auth and first-run experience

  • Current state: app/page.tsx requires sign-in to submit; copy says "Free core report. No signup required." app/api/analyze/route.ts requires non-anonymous user. app/crawl/page.tsx redirects to / if not signed in.
  • Decision: See decisions.md. Either (A) one analysis without account then prompt sign-up, or (B) sign-in required and all copy updated.
  • If (A): Anonymous/guest flow; 1-run cap (session or IP); CTA after report: "Save your reports and get 5 free per month—sign up."
  • If (B): Remove "No signup required" from homepage; update all social/docs that say "no signup for first analysis."

2.2 Single report as default

  • Current state: Result page shows full CMO view plus optional Report 2 (Benchmarks) and Report 3 (Strategic Plan). app/components/roles/CmoFirstReportView.tsx exists as one consolidated report.
  • Decision: See decisions.md. CMO First Report as default (or only) experience; Report 2/3 hidden or behind "Get deeper insights."
  • Touchpoints: app/result/page.tsx — default view, nav visibility, optional plan-gate for Report 2/3.

2.3 Crawl and enrichment

  • Current state: lib/discovery.ts returns 3–8 pages. lib/enrichment/data-enricher.ts defaults ENABLE_EXTERNAL_ENRICHMENT to true.
  • Decisions: (1) Optional cap via env MAX_PAGES (e.g. 5) — implemented in lib/discovery.ts. (2) For MVP production, set ENABLE_EXTERNAL_ENRICHMENT=false in env if desired; brand analysis still runs from page evidence with lower confidence when enrichment is off.
  • Document: Choices in decisions.md.

2.4 Copy and free-tier consistency

  • Current state: lib/billing/plan.ts free plan = 5 analyses/month. Some docs say 10.
  • Tasks: (1) Choose 5 or 10; document in decisions.md. (2) Audit and fix: app/page.tsx, docs/social/*.md, pricing page, README. (3) "Copy and messaging" section in distribution-plan.md as single source for tagline, first-run message, free-tier line.

2.5 CDO and optional features

  • Decision: CDO remains off for v1.9 (ENABLE_CDO_MODE not set). No new analysis modes. No Crunchbase/Product Hunt/Ahrefs/DataForSEO for MVP. No dashboard requirement for first-run.

Out of scope for v1.9

  • CDO mode; new analysis modes.
  • External integrations (Crunchbase, Product Hunt API, Ahrefs, DataForSEO).
  • Dashboard as required path; optional for "save history."
  • Backend change to three-report system; only UI default and gating.
  • Detailed multi-channel CAC; DRL and qualitative distribution assessment suffice for MVP.