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
19 changes: 19 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ Every QuickFork growth iteration must follow this loop:
5. Verify the change with repo tests, production checks, analytics checks, or manual evidence collection as appropriate.
6. Update repo docs and the Obsidian strategy mirror with what changed, what evidence exists, and what remains unvalidated.

If the current evidence is incomplete, stop using strategy reports, SEO/GEO supervisor reports, generated experiment reports, or Obsidian summaries as inputs for the next growth decision. Incomplete reports may only trigger evidence collection, measurement fixes, crawlability fixes, or clearly independent product-foundation work that was already prioritized outside the report.

### Source of Truth

- Start from `.agents/product-marketing.md` before writing copy, planning SEO/GEO pages, changing positioning, or defining paid packaging.
Expand Down Expand Up @@ -164,6 +166,23 @@ Before marking a growth strategy or growth iteration as effective, verify the ap

If evidence is missing, label the strategy as a hypothesis and document the next validation step.

### Evidence-Gated Report Use

Treat SEO/GEO supervisor reports, audit workbooks, generated experiment reports, and Obsidian strategy summaries as decision support only after the evidence completeness gate passes.

A report is complete enough to drive the next growth action only when it includes:

- The exact experiment, route, page family, or product surface being evaluated.
- The evidence window, normally 14 days unless a shorter diagnostic window is explicitly justified.
- Production crawlability checks: public route status, canonical URL, sitemap inclusion, robots policy, and `llms.txt` alignment where relevant.
- GA4 or equivalent activation data for page view, CTA click, generation start, generation completion, and guardrail events.
- Search Console or equivalent query-page evidence for the relevant non-brand and brand queries.
- AI-answer observations across the configured surfaces, including ChatGPT Search, Perplexity, Google AI Overview, Gemini, Claude, and any unavailable surface noted as unavailable.
- Claim hygiene review against `.agents/product-marketing.md`, including forbidden pricing, ranking, revenue, customer, conversion-lift, Product Hunt, and guaranteed-growth claims.
- A decision label: `validated`, `partially_validated`, `insufficient_data`, `blocked`, or `hypothesis`.

If any required evidence is missing, do not use the report to expand landing pages, change SEO/GEO priorities, set pricing, publish product claims, choose productization, or declare demand. Allowed next actions are limited to collecting the missing evidence, fixing measurement/crawl/access problems, documenting the gap, or continuing independent product lifecycle work whose priority does not depend on the incomplete report.

### Obsidian Strategy Log

For growth strategy, SEO/GEO, attribution, lifecycle, or monetization work, use Obsidian as the local strategy mirror:
Expand Down
21 changes: 21 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 @@ -24,6 +24,27 @@ Each growth iteration must state:
- Source-backed claim limits
- Obsidian mirror update

## Evidence-Gated Action Rule

As of 2026-06-04, SEO/GEO supervisor reports, generated experiment reports, audit workbooks, and Obsidian strategy summaries are not allowed to drive the next growth or productization decision until their evidence is complete.

Incomplete reports can only trigger:

- Missing-evidence collection.
- Measurement, crawlability, or access fixes.
- Documentation of the exact gap and next validation step.
- Product lifecycle work that was already prioritized independently of the incomplete report.

They must not trigger:

- New landing-page expansion.
- SEO/GEO priority changes.
- Public pricing, packaging, or revenue claims.
- Productization decisions such as hosted sites, paid tiers, agency packaging, or lifecycle automation.
- Claims that a segment, keyword, page, route, or AI-search surface is validated.

A report becomes action-ready only after it names the evaluated route or product surface, covers the declared evidence window, includes production crawlability checks, GA4 or equivalent activation data, Search Console or equivalent query-page evidence, AI-answer observations across the configured surfaces, and a claim hygiene review against `.agents/product-marketing.md`.

## Lifecycle Model

| Stage | User state | Product job | Primary metric | Guardrail |
Expand Down
Loading