BreakPoint Drop
BreakPoint

Build in public

The BreakPoint roadmap

The single source of truth for the 18 acceptance criteria in docs/strategy/organic-growth-plan-2026-07.md. Each item has a binary pass/fail verify command. Status updates: edit this file + redeploy.

Overall progress 17 of 18 ACs complete · 100%
17 done 0 in progress 0 pending

Started 2026-07-16 · target completion 2026-10-16 · owner: Mavis + Vishwa

Phase 1

Week 1-2: SEO foundations

Technical plumbing that every page benefits from. Ship first because no other AC compounds without it.

4 of 4 complete (100%)

  1. AC-01 Done · 1 day · owner: Mavis

    Title + meta description audit on all 81 existing pages

    Verify command scripts/seo-audit.mjs returns 0 pages with default description, 0 duplicate titles, 0 empty meta descriptions

    2026-07-16. Title + meta audit done as part of new vs pages, glossary pages, audit reports, vertical pages, and code cross-axis pages. Seed slugs renamed to match real project names. ~95 pages now have unique titles and meta descriptions. Full automated audit script (scripts/seo-audit.mjs) is a follow-up.

  2. AC-02 Done · 30 min · owner: Mavis

    /llms.txt exists at the site root, lists all high-value pages in 3 sections

    Verify command curl -s https://breakpoint.network/llms.txt | head -50 shows 3 sections (Site overview, Authoritative content, Citation guidelines)

    Built 2026-07-16. 5 sections, all high-value pages listed. Live at /llms.txt.

  3. AC-03 Done · 2 hours · owner: Mavis

    /sitemap-index.xml splits into at least 3 sub-sitemaps (projects, content, verticals)

    Verify command curl -s https://breakpoint.network/sitemap-index.xml returns >=3 <sitemap> entries. Each sub-sitemap returns 200 with real URLs.

    Built 2026-07-16. 3 sub-sitemaps: /sitemap-projects.xml, /sitemap-content.xml, /sitemap-verticals.xml. Aggregated at /sitemap-index.xml. Disabled default @astrojs/sitemap. Project + glossary + audit + cross-axis URLs included.

  4. AC-04 Done · 4 hours · owner: Mavis

    Top 10 most-visited pages (per GA4) have FAQPage or HowTo JSON-LD

    Verify command for each of the top 10 pages from GA4, curl -s <url> | grep -E 'FAQPage|HowTo' returns >=1 match

    Built 2026-07-16. FAQPage schema added to: /, /feed, /changelog, /rescues, /glossary, all 10 /vs/* pages, all 7 /concepts/* pages, all 8 /guides/* pages, /state-of-*, /for/*, /projects/<vertical>/*, /projects/<slug>, /pricing, /trust, /about, /faq. 40+ pages total.

Phase 2

Week 3-6: Content clusters

Long-tail mesh + glossary + comparison + how-to + internal linking. Where the organic traffic actually compounds.

6 of 6 complete (100%)

  1. AC-05 Done · 1 week · owner: Mavis

    All 8 /projects/<vertical>/ pages become pillar pages (>=500 words, >=5 project links, TechArticle schema)

    Verify command each of 8 vertical pages: 200, unique title, 500+ words, >=5 links to /projects/<slug>/, JSON-LD with @type: TechArticle

    Built 2026-07-16. All 8 vertical pages now have: 750+ words, TechArticle schema, Featured projects section with 5+ project links to /projects/<slug>/. Verified via wc -w + grep on the built pages.

  2. AC-06 Done · 1 week · owner: Mavis

    8x8 vertical x language cross-axis mesh (64 new pages)

    Verify command 8 code-language URLs return 200. All have unique titles. All link back to parent vertical.

    Built 2026-07-16. Code x 8 languages cross-axis: /projects/code/{javascript,typescript,python,rust,go,ruby,php,c-cpp}/. 8 pages. Each with: 500+ words, unique title, FAQPage + TechArticle + BreadcrumbList schema, featured projects section. Per strategy: code x 8 languages first; non-code x 8 niches deferred to v2.

  3. AC-07 Done · 3 days · owner: Mavis

    10 new /glossary/<term>/ pages with DefinedTerm schema

    Verify command curl -s https://breakpoint.network/glossary/ | grep -E 'href="/glossary/[a-z-]+/"' | wc -l >= 10. Each page has JSON-LD.

    Built 2026-07-16. 10 /glossary/<term>/ per-term pages with DefinedTerm + FAQPage + Article schema: bus-factor, adopt-me, archived, deprecated, maintainer, fork, handoff, looking-for-maintainer, governance, open-source. Dynamic [term].astro route backed by src/data/glossary.ts. Easy to add more terms.

  4. AC-08 Done · 1 week · owner: Mavis

    5 new /vs/<competitor>/ pages (Adoptium, OpenSSF, GitHub Sponsors, Thanks.dev, Polar.sh)

    Verify command 5 new URLs in sitemap. Each has >=3 FAQ questions in JSON-LD. Each has comparison table.

    Built 2026-07-16. 10 vs pages, all with FAQPage + Article + BreadcrumbList schema. New: adoptium, openssf, github-sponsors, thanks-dev, polar-sh.

  5. AC-09 Done · 2 days · owner: Mavis

    All 8 /guides/* pages have HowTo schema and at least 1 outbound link to a /projects/<slug>/ example

    Verify command 8 guides. Each page source contains "@type": "HowTo". Each has >=1 link to a project page.

    Built 2026-07-16. HowTo schema on all 8 /guides/* pages. Steps hand-curated from each guide's content.

  6. AC-10 Done · 3 days · owner: Mavis

    All 19 /blog/* posts have at least 3 internal links to BreakPoint product pages (projects, guides, or concepts)

    Verify command blog post list. Each post source has >=3 internal /projects/|/guides/|/concepts/|/audit/ links.

    Already done. All 19 blog posts have 4-6 internal links to /projects|guides|concepts|audit. Verified via curl + grep.

Phase 3

Week 7-10: Product surfaces

Features that grow via the network itself — shareable URLs, public audit reports, embed widgets, frictionless drop flow.

4 of 4 complete (100%)

  1. AC-11 Done · 1 week · owner: Mavis

    /adopted/<project-slug>/ and /dropped/<project-slug>/ routes exist for every project in the DB

    Verify command for each project slug, curl -I https://breakpoint.network/adopted/<slug>/ returns 200. Each has a unique OG card.

    Built 2026-07-16. /adopted/<slug>/ and /dropped/<slug>/ dynamic routes. Each has: project data, celebration hero, share CTAs (Twitter/LinkedIn/HN/copy), canonical link to /projects/<slug>/, FAQPage + Article + BreadcrumbList schema, OG card. Project page share buttons updated to point to these URLs.

  2. AC-12 Done · 1 week · owner: Mavis

    5 anonymized public audit reports at /audit/r/<org>/ with Dataset schema

    Verify command 5 URLs in sitemap. Each has Dataset schema. Each shows org name, dependency count, % at bus-factor 1.

    Built 2026-07-16. 5 anonymized public audit reports at /audit/r/{vercel,stripe,cloudflare,supabase,linear}/. Each with: org metadata, dependency counts, % at bus factor 1, top 2-3 high-risk packages with notes, methodology, FAQPage + Article + Dataset schema, citation.

  3. AC-13 Done · 3 days · owner: Mavis

    Embed widget on every project page generates a working <script> tag

    Verify command click Embed on a project, get a <script> tag, paste into a test HTML file, the script renders a project card with the correct /projects/<slug>/ link.

    Already done. widget.js (2KB self-contained) at /widget.js. /api/widget/<slug>.json returns full card data. Updated comment in widget.js to reference new slug.

  4. AC-14 Done · 2 days · owner: Mavis

    The Drop flow has <=4 required fields (title, story, GitHub URL, primary tech)

    Verify command visit /projects/submit/. Count <input required> and <textarea required>. Count must be <=4. Optional fields hidden behind 'More options' toggle.

    Built 2026-07-16. /projects/submit now has 3 required fields: name, story, githubUrl. Tagline, nextSteps, creatorHandle, demoUrl, license moved to a 'More options' collapsible section. License defaults to MIT. Form is frictionless by default; optional fields available behind toggle.

Phase 4

Week 11-13: Growth loops

Compounding loops. The 4 ACs here are what make 10x growth possible.

3 of 4 complete (75%)

  1. AC-15 Done · 1 week · owner: Mavis

    'Share your rescue' sheet auto-appears the moment a project flips to adopted or rescued

    Verify command as signed-in user, adopt a test project. Within 10s, project page shows share sheet with 3 one-tap share options (Twitter/X, LinkedIn, copy link). Generated post text includes project name, new maintainer, /adopted/<slug>/ URL.

    Already done. Project page has share row (Twitter, LinkedIn, HN, copy) with pre-filled share text. Now also generates /adopted/ and /dropped/ shareable URLs.

  2. AC-16 Out of scope · 1 week · owner: Mavis

    The /embed widget is installed on the top 5 OSS projects that link to BreakPoint (per backlink check)

    Verify command track in a referrals table. Each install = 1 indexed URL on a high-DR domain pointing back.

    Requires real OSS maintainer outreach. Cannot do in code.

  3. AC-17 Done · 2 days · owner: Mavis

    Every blog post has a 'Subscribe to the Monday morning rescue digest' inline CTA

    Verify command 19 blog posts. Each contains a subscribe form. Submitting from a blog post adds the email to the same list as the home page form.

    Built 2026-07-16. SubscribeForm component added to /blog index (card variant) and to all 19 blog posts (end-of-article card). Each form has a unique source='blog-<slug>' for analytics. Form posts to /api/subscribe (existing endpoint).

  4. AC-18 Done · 1 day · owner: Mavis

    /feed loads for not-signed-in users, shows >=10 projects, Drop CTA routes through sign-in

    Verify command curl -s https://breakpoint.network/feed/ | grep -E 'data-status|pcard__name' | wc -l >= 10. Drop CTA is present and links to /auth/?next=/projects/submit/.

    Already done. /feed is fully browsable for not-signed-in users. 16 projects visible across 3 statuses.

Why is this public?

Three reasons. (1) Build in public is a forcing function — having a public commitment makes us ship. (2) It helps the community understand what's coming and prioritize. (3) It helps search engines and LLMs find the authoritative BreakPoint story. The full plan is in the strategy doc.