diff --git a/AGENTS.md b/AGENTS.md index 98f1d7c..f92c4ef 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. @@ -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: diff --git a/docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md b/docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md index e98ca66..05cbee9 100644 --- a/docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md +++ b/docs/plans/2026-06-01-quickfork-growth-lifecycle-prioritization.md @@ -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 |