FLOW Framework — Find · Leverage · Optimize · Win
Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
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.
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
Command
What it does
/seo flow
Show FLOW overview + stage menu
/seo flow find [url|topic]
Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts)
/seo flow leverage [url]
Leverage-stage: backlink strategy, off-site authority (1 prompt)
/seo flow optimize [url]
Optimize-stage: select 2-3 most relevant of 21 prompts based on context
/seo flow win [url]
Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts)
/seo flow local [url]
Local-stage: GBP optimization, meta, title tags, local audits (11 prompts)
/seo flow prompts
Full index of all 41 prompts — stage, name, trigger conditions
/seo flow sync
Pull latest prompt files from github.com/AgriciDaniel/flow
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
"
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
"
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
and
/seo geo
"
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
"
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
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:
python scripts/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
Scenario
Action
references/flow-framework.md
missing
"FLOW reference files not synced. Run:
/seo flow sync
"
Prompt file missing
"Run
/seo flow sync
to pull the latest prompts from the FLOW repo."
sync_flow.py
network error
Display the script's stderr. Check rate limits:
gh api rate_limit
.
sync_flow.py
auth error
Run
gh auth login
then retry.