FLOW Framework: Find · Leverage · Optimize · Win

FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO

integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can

be driven by structured, evidence-backed AI prompts rather than improvised queries.

Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow

Runtime context: Load references/flow-framework.md on every /seo flow activation.

Load prompt files on demand, only for the stage the user requests.

Commands

Orchestration Logic

On /seo flow (no sub-command)

• Read references/flow-framework.md

• Show the FLOW stage overview with a one-line description of each stage

• Ask: which stage matches the user's current situation?

On /seo flow find [url|topic]

• Read all files in references/prompts/find/

• Apply each prompt to the URL or topic

• Cross-reference: "For deeper SERP clustering, see /seo cluster <seed-keyword>"

On /seo flow leverage [url]

• Read the file in references/prompts/leverage/

• Apply to the URL's current backlink context

• Cross-reference: "For raw backlink data, see /seo backlinks <url>"

On /seo flow optimize [url]

• Read all file names in references/prompts/optimize/

• Read prior analysis context (URL, industry vertical, any prior skill output in conversation)

• Select 2-3 most relevant prompts; load only those files

• Apply selected prompts; note the others are accessible via /seo flow prompts

• Cross-reference: "For full content quality analysis, see /seo content <url> and /seo geo <url>"

On /seo flow win [url]

• Read all files in references/prompts/win/

• Apply each prompt to the URL's conversion and BOFU context

• Cross-reference: "For SXO persona scoring, see /seo sxo <url>"

On /seo flow local [url]

• Read all files in references/prompts/local/

• Apply to the URL's local SEO context

• Cross-reference: "For full local SEO analysis, see /seo local <url> and /seo maps [command]"

On /seo flow prompts

• Read references/prompts/README.md

• Display the full index: all 41 prompts with stage, name, trigger conditions

On /seo flow sync

• Run: claude-seo run sync_flow.py

• Display the JSON summary (files added, updated, unchanged)

• Show attribution notice after sync completes

Context Matching (Optimize stage)

The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:

• Industry vertical (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)

• Prior skill output (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)

• URL signals (product pages → conversion; blog → freshness + authority)

Always surface exactly 2-3 prompts. State which prompts you chose and why.

Reference Files

Load on-demand, do NOT load all at startup:

• references/flow-framework.md: FLOW operating model (load on every /seo flow activation)

• references/bibliography.md: Evidence sources; load when citing studies or statistics

• references/prompts/README.md: Prompt index; load for /seo flow prompts

• references/prompts/find/: 5 prompts; load for /seo flow find

• references/prompts/leverage/: 1 prompt; load for /seo flow leverage

• references/prompts/optimize/: 21 prompts; load selectively for /seo flow optimize

• references/prompts/win/: 3 prompts; load for /seo flow win

• references/prompts/local/: 11 prompts; load for /seo flow local

Attribution

Every /seo flow activation (any sub-command) outputs before analysis:

Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow

Do not omit or modify the attribution.

Error Handling