Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/marketing/data/growth-experiment-evidence.csv
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@ experiment_id,status,window_start,window_end,control_page_views,control_cta_clic
2026_q2_landing_page_intent_comparison,pending_evidence,,,,,,,,,,,pending,pending,insufficient_data,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_14_day_window
2026_q2_source_backed_assets_intent_validation,pending_evidence,,,,,,,,,,,pending,pending,insufficient_data,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_14_day_window_and_search_console_query_baseline_and_ai_answer_audit
2026_q2_readme_cards_intent_validation,pending_evidence,,,,,,,,,,,pending,pending,insufficient_data,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_14_day_window_and_search_console_query_baseline_and_ai_answer_audit
2026_q2_cold_start_materials_intent_validation,pending_evidence,,,,,,,,,,,pending,pending,insufficient_data,needs_14_days_of_ga4_page_view_cta_clicked_generation_started_generation_failed_search_console_query_baseline_and_ai_answer_audit_before_deciding
1 change: 1 addition & 0 deletions docs/marketing/data/growth-experiment-registry.csv
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@ experiment_id,status,lifecycle_stage,target_user,control_path,variant_path,prima
2026_q2_landing_page_intent_comparison,active,validation,ai_project_builder,/product/github-repo-to-launch-package,/use-cases/ai-project-launch,generate_launch_card,cta_clicked_per_page_view,generation_failed_per_generation_started,higher_cta_rate_with_no_significant_guardrail_regression,14_days,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed
2026_q2_source_backed_assets_intent_validation,active,validation,product_marketer,/product/github-repo-to-launch-package,/product/source-backed-launch-assets,generate_launch_card,cta_clicked_per_page_view,generation_failed_per_generation_started,higher_cta_rate_with_no_significant_guardrail_regression,14_days,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_and_search_console_query_baseline_and_ai_answer_audit
2026_q2_readme_cards_intent_validation,active,validation,design_lead,/product/github-repo-to-launch-package,/product/readme-marketing-cards,generate_launch_card,cta_clicked_per_page_view,generation_failed_per_generation_started,higher_cta_rate_with_no_significant_guardrail_regression,14_days,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_and_search_console_query_baseline_and_ai_answer_audit
2026_q2_cold_start_materials_intent_validation,active,validation,ai_project_builder,/product/github-repo-to-launch-package,/product/cold-start-launch-materials,generate_launch_card,cta_clicked_per_page_view,generation_failed_per_generation_started,higher_cta_rate_with_no_significant_guardrail_regression,14_days,ga4_page_view_and_cta_clicked_and_generation_started_and_generation_failed_and_search_console_query_baseline_and_ai_answer_audit
2 changes: 2 additions & 0 deletions docs/marketing/data/search-ai-baseline-prompts.csv
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,5 @@ source_backed_assets_control,2026_q2_source_backed_assets_intent_validation,cont
source_backed_assets_variant,2026_q2_source_backed_assets_intent_validation,variant,/product/source-backed-launch-assets,product_marketer,source backed launch assets,source_backed_launch_assets,google_search_console|chatgpt_search|perplexity|google_ai_overview|gemini|claude,QuickFork|GitHub repository|source-backed|launch assets|README|social|deck|outreach,pricing|rankings|revenue|customer_count|conversion_lift|product_hunt_outcome|guaranteed_launch|validated_ai_citation,check whether source-backed asset intent is visible and accurately described
readme_cards_control,2026_q2_readme_cards_intent_validation,control,/product/github-repo-to-launch-package,design_lead,GitHub repo to launch package,github_repo_to_launch_package,google_search_console|chatgpt_search|perplexity|google_ai_overview|gemini|claude,QuickFork|GitHub repository|launch package|source-backed|README|social|deck|outreach,pricing|rankings|revenue|customer_count|conversion_lift|product_hunt_outcome|guaranteed_launch|validated_ai_citation,compare generic launch-package category demand against README card page demand
readme_cards_variant,2026_q2_readme_cards_intent_validation,variant,/product/readme-marketing-cards,design_lead,README marketing cards,readme_marketing_cards,google_search_console|chatgpt_search|perplexity|google_ai_overview|gemini|claude,QuickFork|GitHub repository|README|marketing cards|social preview|launch visuals|source-backed,pricing|rankings|revenue|customer_count|conversion_lift|product_hunt_outcome|guaranteed_launch|validated_ai_citation,check whether README marketing card intent is visible and accurately described
cold_start_materials_control,2026_q2_cold_start_materials_intent_validation,control,/product/github-repo-to-launch-package,ai_project_builder,GitHub repo to launch package,github_repo_to_launch_package,google_search_console|chatgpt_search|perplexity|google_ai_overview|gemini|claude,QuickFork|GitHub repository|launch package|source-backed|README|social|deck|outreach,pricing|rankings|revenue|customer_count|conversion_lift|product_hunt_outcome|guaranteed_launch|validated_ai_citation,compare generic launch-package category demand against cold-start launch-materials demand
cold_start_materials_variant,2026_q2_cold_start_materials_intent_validation,variant,/product/cold-start-launch-materials,ai_project_builder,cold start launch materials,cold_start_launch_materials,google_search_console|chatgpt_search|perplexity|google_ai_overview|gemini|claude,QuickFork|GitHub repository|cold-start|launch materials|README|social|deck|visual|outreach,pricing|rankings|revenue|customer_count|conversion_lift|product_hunt_outcome|guaranteed_launch|validated_ai_citation,check whether full launch-materials intent is visible and accurately described
1 change: 1 addition & 0 deletions docs/marketing/data/semantic-link-inventory.csv
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
status,funnel_stage,buyer_stage,persona,intent_cluster,page_type,slug,canonical_url,primary_keyword,primary_cta,utm_source,utm_medium,utm_campaign,utm_content,crm_campaign,distributed_url
published,top,consideration,open_source_maintainer,github_repo_to_launch_package,product,github-repo-to-launch-package,https://seekersai.com/product/github-repo-to-launch-package,github repo to launch package,generate_launch_card,google,organic,seo_foundation,product_category,2026_q2_seo_foundation,https://seekersai.com/product/github-repo-to-launch-package?utm_source=google&utm_medium=organic&utm_campaign=seo_foundation&utm_content=product_category
published,top,consideration,product_marketer,source_backed_launch_assets,product,source-backed-launch-assets,https://seekersai.com/product/source-backed-launch-assets,source backed launch assets,generate_launch_card,perplexity,ai_search,ai_visibility,source_backed_assets,2026_q2_ai_visibility,https://seekersai.com/product/source-backed-launch-assets?utm_source=perplexity&utm_medium=ai_search&utm_campaign=ai_visibility&utm_content=source_backed_assets
published,top,consideration,ai_project_builder,cold_start_launch_materials,product,cold-start-launch-materials,https://seekersai.com/product/cold-start-launch-materials,cold start launch materials,generate_launch_card,google,organic,cold_start_materials,product_page,2026_q2_cold_start_materials,https://seekersai.com/product/cold-start-launch-materials?utm_source=google&utm_medium=organic&utm_campaign=cold_start_materials&utm_content=product_page
published,top,consideration,design_lead,readme_marketing_cards,product,readme-marketing-cards,https://seekersai.com/product/readme-marketing-cards,readme marketing cards,generate_launch_card,google,organic,readme_assets,product_page,2026_q2_readme_assets,https://seekersai.com/product/readme-marketing-cards?utm_source=google&utm_medium=organic&utm_campaign=readme_assets&utm_content=product_page
published,top,consideration,ai_project_builder,github_repo_visual_explainer,product,github-repo-visual-explainer,https://seekersai.com/product/github-repo-visual-explainer,github repo visual explainer,generate_launch_card,google,organic,visual_explainer,product_page,2026_q2_visual_explainer,https://seekersai.com/product/github-repo-visual-explainer?utm_source=google&utm_medium=organic&utm_campaign=visual_explainer&utm_content=product_page
published,top,consideration,founder,github_repo_to_launch_deck,product,github-repo-to-launch-deck,https://seekersai.com/product/github-repo-to-launch-deck,github repository pitch deck generator,generate_launch_card,google,organic,launch_deck,product_page,2026_q2_launch_deck,https://seekersai.com/product/github-repo-to-launch-deck?utm_source=google&utm_medium=organic&utm_campaign=launch_deck&utm_content=product_page
Expand Down
151 changes: 151 additions & 0 deletions docs/marketing/research/2026-06-02-cold-start-launch-materials-hub.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
# Cold-Start Launch Materials Hub

Date: 2026-06-02

## Growth Hypothesis

If QuickFork publishes a product-led hub for `cold start launch materials`, AI project builders and maintainers will better understand the full product value unit: source-backed README, social, deck, visual, and outreach drafts generated from one public GitHub repository URL.

This is a landing-page and measurement slice. It does not validate demand until production behavior, Search Console data, AI-answer observations, and user feedback are collected.

## Lifecycle Stage

P1/P2: High-intent product page validation plus SEO/GEO foundation.

The page connects Discovery and Validation work to the existing Activation surface: generate a free repo brief.

## Target User

- AI project builders preparing a first public launch.
- Open-source maintainers who need README and social-preview clarity.
- Indie technical founders who need launch materials before hiring marketing support.
- DevRel teams that repeatedly turn repositories into public examples, decks, and outreach.

## Primary CTA

Generate free repo brief.

## Metrics

Primary metric:

- `cta_clicked_per_page_view` for `/product/cold-start-launch-materials`.

Supporting metrics:

- `page_view` with `intent_cluster=cold_start_launch_materials`.
- `generation_started` and `generation_failed` after the page visit.
- Artifact copy/download behavior after generation.
- Search Console impressions and clicks for `cold start launch materials`.
- AI-answer audit accuracy across ChatGPT search, Perplexity, Google AI Overview, Gemini, and Claude.

Guardrail metrics:

- `generation_failed_per_generation_started`.
- Unsupported-claim review flags.
- Browser analytics containing raw README text, raw artifact body, email, token, secret, API key, private repo content, or unsupported proof.

## Changed Surfaces

- `/product/cold-start-launch-materials`
- `src/marketing/link-catalog.ts`
- `src/marketing/page-content.ts`
- `docs/marketing/data/semantic-link-inventory.csv`
- `public/sitemap.xml`
- `public/llms.txt`
- `docs/marketing/data/growth-experiment-registry.csv`
- `docs/marketing/data/growth-experiment-evidence.csv`
- `docs/marketing/data/search-ai-baseline-prompts.csv`
- `src/marketing/growth-experiments.ts`
- `src/marketing/growth-experiment-report.ts`
- `src/marketing/search-ai-baseline.ts`
- `src/App.test.tsx`
- `src/seo/semantic-links.test.ts`
- `src/seo/public-growth.test.ts`
- `src/marketing/growth-experiments.test.ts`
- `src/marketing/growth-experiment-report.test.ts`
- `src/marketing/search-ai-baseline.test.ts`

## Research Inputs

- `.agents/product-marketing.md`: QuickFork is a source-backed repository-to-launch asset workflow, not a generic AI landing-page generator.
- `docs/marketing/research/2026-06-01-cold-start-launch-demand-analysis.md`: the product value unit should be a launch package, not a single generated page.
- `docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md`: P1 needs high-intent landing pages and P2 needs free repo launch brief activation.
- GitHub README docs: the README is a key repository explanation surface.
- GitHub social preview docs: repository sharing creates a real visual launch surface.
- Open Source Guides finding users: user discovery and feedback shape open-source launch messaging.
- Product Hunt launch guide: launch preparation includes concise story, media, maker context, and launch-day copy.

## Claim Boundary

Safe claims:

- QuickFork starts from one public GitHub repository URL.
- QuickFork can describe a source-backed launch materials workflow for README, social, deck, visual, and outreach drafts.
- QuickFork requires human review before public publishing.
- Search and AI-answer visibility are pending measurement.

Unsafe claims:

- Validated demand for the new page.
- Exact public pricing.
- Business, search, launch, or adoption outcomes.
- Fully automated publishing or human-free claim approval.

## Experiment Contract

Experiment ID:

- `2026_q2_cold_start_materials_intent_validation`

Control:

- `/product/github-repo-to-launch-package`

Variant:

- `/product/cold-start-launch-materials`

Decision rule:

- Higher `cta_clicked_per_page_view` with no significant guardrail regression after a minimum 14-day window.

Required evidence:

- GA4 page views and CTA clicks.
- Generation starts and failures.
- Search Console query baseline.
- AI-answer audit.

Current decision:

- `insufficient_data`.

## Search And AI Baseline Rows

- `cold_start_materials_control`: query `GitHub repo to launch package`, route `/product/github-repo-to-launch-package`.
- `cold_start_materials_variant`: query `cold start launch materials`, route `/product/cold-start-launch-materials`.

Surfaces:

- Google Search Console.
- ChatGPT search.
- Perplexity.
- Google AI Overview.
- Gemini.
- Claude.

## Validation Status

Hypothesis only.

The route, SEO/GEO assets, and measurement contracts make the growth idea testable. They do not prove that users want this exact page, that the route ranks, or that AI answer systems cite it.

## Next Validation Step

After production deploy:

1. Smoke-check `/product/cold-start-launch-materials`, `sitemap.xml`, and `llms.txt`.
2. Start the 14-day experiment window.
3. Run the Search Console and AI-answer baseline prompts.
4. Compare page CTA and generation behavior against `/product/github-repo-to-launch-package`.
59 changes: 59 additions & 0 deletions docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md
Original file line number Diff line number Diff line change
Expand Up @@ -238,6 +238,65 @@ Growth and retention:

Continue from artifact export tracking into paid-intent CTA tests after users copy or download README, social, deck, outreach, or visual prompt artifacts.

## 2026-06-02 Cold Start Launch Materials Hub Slice

Hypothesis:

- If QuickFork publishes a product-led hub for `cold start launch materials`, AI project builders and maintainers will better understand the full value unit: source-backed README, social, deck, visual, and outreach drafts generated from one public GitHub repository URL.

Lifecycle stage:

- Discovery to Validation, with SEO/GEO foundation.

Target user:

- AI project builders, open-source maintainers, indie technical founders, and DevRel teams preparing first public launches.

Changed surface:

- Added `/product/cold-start-launch-materials` as a published product route.
- Added route narrative, definition, target user, evidence boundary, benefits, workflow, FAQs, source notes, metadata, and schema.
- Added the page to semantic link inventory, sitemap, `llms.txt`, and public-growth tests.
- Added `2026_q2_cold_start_materials_intent_validation` to the experiment registry and evidence report.
- Added Search Console and AI-answer baseline rows for `GitHub repo to launch package` and `cold start launch materials`.
- Added implementation plan at `docs/superpowers/plans/2026-06-02-cold-start-launch-materials-hub.md`.
- Added research handoff at `docs/marketing/research/2026-06-02-cold-start-launch-materials-hub.md`.

Primary CTA:

- Generate free repo brief.

Primary metric:

- `cta_clicked_per_page_view` for `/product/cold-start-launch-materials`.

Guardrail:

- `generation_failed_per_generation_started`.
- No browser analytics payload should include raw README text, raw artifact body, email, token, secret, API key, private repo content, or unsupported proof.

Evidence gap:

- The route and contracts are testable but demand remains unvalidated until a 14-day production window, Search Console baseline, AI-answer audit, and qualitative feedback exist.

Evidence observed:

- RED tests failed first because the route, catalog entry, public assets, experiment row, and baseline rows were missing.
- `npm test -- src/App.test.tsx src/seo/semantic-links.test.ts`: 2 files passed, 37 tests passed.
- `npm test -- src/seo/public-growth.test.ts`: 1 file passed, 6 tests passed.
- `npm test -- src/marketing/growth-experiments.test.ts src/marketing/search-ai-baseline.test.ts src/marketing/growth-experiment-report.test.ts`: 3 files passed, 20 tests passed.
- `npm test`: 24 files passed, 158 tests passed.
- `npm run build`: TypeScript and Vite production build passed.
- `git diff --check`: no whitespace errors.

Decision:

- Treat this as a hypothesis and measurement setup. Do not promote it as validated demand or AI-search visibility until production evidence exists.

Next action:

- Run full verification, ship through PR/CI/Vercel, smoke-check production, then begin the 14-day comparison against `/product/github-repo-to-launch-package`.

## 2026-06-02 Evaluation Slice

Hypothesis:
Expand Down
Loading
Loading