askbowtie

the playbook directory

Procedures your agent runs right.

Playbooks are indexed procedures your agent pulls at the point of work, each carrying the trap it avoids. Your agent stops guessing and follows the steps that already work. They are the antidote to AI amnesia: the memory a fresh session doesn't have.

19 playbooks, live in the MCP pulled with one call: playbook() jump to the directory

for AI agents & crawlers: the full machine-readable index

What this is. 19 askbowtie playbooks. Each is a named, versioned procedure with the traps it avoids. Call the MCP tool playbook() for the index, or playbook({name}) for a single procedure. Plaintext twin for LLMs: /playbooks/index.md.

triage-errors
Triage errors without chasing ad-block noise. Use when: get_incidents / the Errors count looks alarming, or before you investigate any error surface. START HERE so you don't burn the audit on third-party noise.
investigate-a-metric-drop
Investigate a metric drop (traffic, conversions, signups). Use when: Any 'X is down / something looks off' question: START HERE before digging.
is-this-position-move-real
Is this GSC position move real?. Use when: Before reporting ANY search-position change as good or bad news.
judge-a-single-day-or-hour
Judge a single day / hour (calendar windows). Use when: 'How is today going', 'what happened in the last hour', 'compare to yesterday'.
diagnose-conversion-undercount
Diagnose a conversion undercount. Use when: Owner says 'sales/leads are happening but bowtie shows fewer/none'.
set-up-a-funnel-properly
Set up a funnel (define_flow) properly. Use when: Asked to create/track a funnel, or you're about to call define_flow.
onboard-a-new-domain
Onboard a new domain end-to-end. Use when: A site was just added / 'set up bowtie for X' / data looks empty on a new domain.
send-server-side-events
Send events/conversions from a backend (server-side ingest). Use when: Before POSTing to /api/ingest from a backend, Cloudflare Worker, webhook, or any non-browser sender: ad-block-proof conversions, server-confirmed purchases.
page-roles
Analyze pages by ROLE (page tags), not slug-by-slug. Use when: 'How is my editorial/commercial content doing', 'compare blog vs product pages', or when a site's pages are untagged.
page-actions
Track WHAT visitors do (declared action markers). Use when: 'Which plan do people pick', 'how does the download button convert': a click's MEANING, not its position.
automate-a-recurring-check
Automate a recurring check. Use when: Before building a cloud routine or external cron: askbowtie almost certainly watches it server-side already.
set-up-an-executive-pulse
Set up an executive pulse (daily/weekly business email). Use when: 'Send me the numbers every morning' / 'keep my cofounder in the loop' / a recurring business-status email.
audit-a-site-crawl
Audit a site's health with a crawl. Use when: 'Is anything broken on the site', broken links/images, weak titles, noindex, a pre-launch sweep: the DETERMINISTIC check.
page-engagement
Analyze how a page's viewers USE it (section engagement). Use when: 'What do people click on this page', 'is the hero/nav/CTA working', 'why does this page get traffic but not convert'.
audit-paid-traffic
Audit paid traffic (Google Ads spend to real payback). Use when: 'Is my ad spend working', 'what's my best/worst keyword', 'where's the wasted spend': the full paid sweep.
audit-campaign
Audit a Google Ads campaign, the full structured sweep. Use when: 'Audit campaign X', 'review my campaigns': ends with a prioritized, dollar-ranked action list.
audit-keywords
Audit keywords, negatives, and search terms. Use when: 'Find wasted spend', 'what should I add as a negative': waste lives in the SEARCH-TERM report and conversion RATE.
audit-assets
Audit ad assets (RSA headlines, pinning) + ad-to-lander match. Use when: 'Are my headlines good', 'why is ad relevance low'.
keyword-research
Keyword research grounded in real demand. Use when: 'Find keywords to target', 'what should I bid on': backed by what already converts, not Keyword-Planner volume.

how it works

  1. STEP 1

    Connect the MCP

    Add askbowtie to your agent once, the way you add any MCP server.

  2. STEP 2

    Your agent pulls the index

    One call to playbook() returns all 19, each with when to reach for it.

  3. STEP 3

    It follows the procedure

    Steps and traps in order, grounded in your site's real numbers.

Investigate 5

Something looks off. Start here so you rule out the artifact before you chase the ghost.

  • triage-errors

    Triage errors without chasing ad-block noise

    Choose a view for the triage-errors playbook

    Separate your real bugs from third-party and ad-block noise, so you don't burn the audit chasing errors that were never yours.

    use when get_incidents / the Errors count looks alarming, or before you investigate any error surface. START HERE so you don't burn the audit on third-party noise.

    pull the askbowtie playbook "triage-errors" and follow it for your-site.com

    or, directly: playbook({name:"triage-errors"})

  • investigate-a-metric-drop

    Investigate a metric drop (traffic, conversions, signups)

    Choose a view for the investigate-a-metric-drop playbook

    A disciplined first move for any 'something's off' question. Rule out the reporting artifact before you chase a real drop.

    use when Any 'X is down / something looks off' question: START HERE before digging.

    pull the askbowtie playbook "investigate-a-metric-drop" and follow it for your-site.com

    or, directly: playbook({name:"investigate-a-metric-drop"})

  • is-this-position-move-real

    Is this GSC position move real?

    Choose a view for the is-this-position-move-real playbook

    Decide whether a Search Console ranking change is signal or noise before you call it a win or a loss.

    use when Before reporting ANY search-position change as good or bad news.

    pull the askbowtie playbook "is-this-position-move-real" and follow it for your-site.com

    or, directly: playbook({name:"is-this-position-move-real"})

  • judge-a-single-day-or-hour

    Judge a single day / hour (calendar windows)

    Choose a view for the judge-a-single-day-or-hour playbook

    Read a calendar window honestly (today, the last hour, yesterday) without mistaking a partial day for a trend.

    use when 'How is today going', 'what happened in the last hour', 'compare to yesterday'.

    pull the askbowtie playbook "judge-a-single-day-or-hour" and follow it for your-site.com

    or, directly: playbook({name:"judge-a-single-day-or-hour"})

  • diagnose-conversion-undercount

    Diagnose a conversion undercount

    Choose a view for the diagnose-conversion-undercount playbook

    Find out why real sales or leads aren't all showing up in bowtie, then close the gap.

    use when Owner says 'sales/leads are happening but bowtie shows fewer/none'.

    pull the askbowtie playbook "diagnose-conversion-undercount" and follow it for your-site.com

    or, directly: playbook({name:"diagnose-conversion-undercount"})

Set up 5

Wire a new signal or a new site correctly the first time.

  • set-up-a-funnel-properly

    Set up a funnel (define_flow) properly

    Choose a view for the set-up-a-funnel-properly playbook

    Define a funnel with define_flow the right way, so its steps and drop-offs mean what you think they mean.

    use when Asked to create/track a funnel, or you're about to call define_flow.

    pull the askbowtie playbook "set-up-a-funnel-properly" and follow it for your-site.com

    or, directly: playbook({name:"set-up-a-funnel-properly"})

  • onboard-a-new-domain

    Onboard a new domain end-to-end

    Choose a view for the onboard-a-new-domain playbook

    Take a freshly added site from empty to fully tracked, end to end.

    use when A site was just added / 'set up bowtie for X' / data looks empty on a new domain.

    pull the askbowtie playbook "onboard-a-new-domain" and follow it for your-site.com

    or, directly: playbook({name:"onboard-a-new-domain"})

  • send-server-side-events

    Send events/conversions from a backend (server-side ingest)

    Choose a view for the send-server-side-events playbook

    Send conversions and events from a backend, so they're ad-block-proof and server-confirmed.

    use when Before POSTing to /api/ingest from a backend, Cloudflare Worker, webhook, or any non-browser sender: ad-block-proof conversions, server-confirmed purchases.

    pull the askbowtie playbook "send-server-side-events" and follow it for your-site.com

    or, directly: playbook({name:"send-server-side-events"})

  • page-roles

    Analyze pages by ROLE (page tags), not slug-by-slug

    Choose a view for the page-roles playbook

    Analyze pages by their role using page tags. Compare editorial against commercial instead of slug by slug.

    use when 'How is my editorial/commercial content doing', 'compare blog vs product pages', or when a site's pages are untagged.

    pull the askbowtie playbook "page-roles" and follow it for your-site.com

    or, directly: playbook({name:"page-roles"})

  • page-actions

    Track WHAT visitors do (declared action markers)

    Choose a view for the page-actions playbook

    Track what a click means, not where it sits, using declared action markers.

    use when 'Which plan do people pick', 'how does the download button convert': a click's MEANING, not its position.

    pull the askbowtie playbook "page-actions" and follow it for your-site.com

    or, directly: playbook({name:"page-actions"})

Watch & automate 2

Let bowtie keep watching after the agent session ends.

  • automate-a-recurring-check

    Automate a recurring check

    Choose a view for the automate-a-recurring-check playbook

    Check what bowtie already watches server-side before you build a cron or cloud routine you don't need.

    use when Before building a cloud routine or external cron: askbowtie almost certainly watches it server-side already.

    pull the askbowtie playbook "automate-a-recurring-check" and follow it for your-site.com

    or, directly: playbook({name:"automate-a-recurring-check"})

  • set-up-an-executive-pulse

    Set up an executive pulse (daily/weekly business email)

    Choose a view for the set-up-an-executive-pulse playbook

    Stand up a recurring business-status email, so the numbers arrive without anyone opening a dashboard.

    use when 'Send me the numbers every morning' / 'keep my cofounder in the loop' / a recurring business-status email.

    pull the askbowtie playbook "set-up-an-executive-pulse" and follow it for your-site.com

    or, directly: playbook({name:"set-up-an-executive-pulse"})

Site health 2

What's broken, and how each page is really used.

  • audit-a-site-crawl

    Audit a site's health with a crawl

    Choose a view for the audit-a-site-crawl playbook

    Run the deterministic crawl for broken links, images, weak titles and accidental noindex before you launch.

    use when 'Is anything broken on the site', broken links/images, weak titles, noindex, a pre-launch sweep: the DETERMINISTIC check.

    pull the askbowtie playbook "audit-a-site-crawl" and follow it for your-site.com

    or, directly: playbook({name:"audit-a-site-crawl"})

  • page-engagement

    Analyze how a page's viewers USE it (section engagement)

    Choose a view for the page-engagement playbook

    See how visitors actually use a page, section by section, to explain traffic that doesn't convert.

    use when 'What do people click on this page', 'is the hero/nav/CTA working', 'why does this page get traffic but not convert'.

    pull the askbowtie playbook "page-engagement" and follow it for your-site.com

    or, directly: playbook({name:"page-engagement"})

Paid 5

Every dollar of ad spend, matched to the payback it bought.

  • audit-paid-traffic

    Audit paid traffic (Google Ads spend to real payback)

    Choose a view for the audit-paid-traffic playbook

    The full paid sweep. Match Google Ads spend to real payback and find the wasted dollars.

    use when 'Is my ad spend working', 'what's my best/worst keyword', 'where's the wasted spend': the full paid sweep.

    pull the askbowtie playbook "audit-paid-traffic" and follow it for your-site.com

    or, directly: playbook({name:"audit-paid-traffic"})

  • audit-campaign

    Audit a Google Ads campaign, the full structured sweep

    Choose a view for the audit-campaign playbook

    A structured campaign review that ends in a prioritized, dollar-ranked action list.

    use when 'Audit campaign X', 'review my campaigns': ends with a prioritized, dollar-ranked action list.

    pull the askbowtie playbook "audit-campaign" and follow it for your-site.com

    or, directly: playbook({name:"audit-campaign"})

  • audit-keywords

    Audit keywords, negatives, and search terms

    Choose a view for the audit-keywords playbook

    Find wasted spend and the negatives to add, where the search-term report and conversion rate actually hide it.

    use when 'Find wasted spend', 'what should I add as a negative': waste lives in the SEARCH-TERM report and conversion RATE.

    pull the askbowtie playbook "audit-keywords" and follow it for your-site.com

    or, directly: playbook({name:"audit-keywords"})

  • audit-assets

    Audit ad assets (RSA headlines, pinning) + ad-to-lander match

    Choose a view for the audit-assets playbook

    Check RSA headlines and pinning, and whether each ad matches the page it lands on.

    use when 'Are my headlines good', 'why is ad relevance low'.

    pull the askbowtie playbook "audit-assets" and follow it for your-site.com

    or, directly: playbook({name:"audit-assets"})

  • keyword-research

    Keyword research grounded in real demand

    Choose a view for the keyword-research playbook

    Find keywords to target grounded in what already converts, not Keyword-Planner volume.

    use when 'Find keywords to target', 'what should I bid on': backed by what already converts, not Keyword-Planner volume.

    pull the askbowtie playbook "keyword-research" and follow it for your-site.com

    or, directly: playbook({name:"keyword-research"})

one connection

Utilize our playbooks. 1 MCP. Free.

use askbowtie

every playbook, every signal, one connection · early bird: 100% free