<!-- Generated by BridgeToAgent (https://bridgetoagent.com) — the standard for agents.json + llms.txt + agent-instructions.md kits. -->

# AI Agent Runbook — BridgeToAgent

This document serves as a systematic manual for autonomous agents navigating BridgeToAgent (bridgetoagent.com). It provides a full mapping of platform traits, transactional workflows, and API interfaces.

## Platform Fingerprint
BridgeToAgent is custom-built and optimized for static delivery and programmatic client interactions. There is no traditional heavyweight CMS backend executing queries on navigation. 

---

## API Endpoints (Prefer Over HTML)

The platform exposes several public resources that should be preferred for state discovery and structural navigation:

- `https://www.bridgetoagent.com/sitemap.xml`: Comprehensive URL mapping of all platform install pillars, documentation pages, tools, and blog posts.
- `https://www.bridgetoagent.com/agents.json`: Ground-truth manifest containing current action definitions and metadata.

Use these files to locate direct content and platform-specific guides without brute-force scraping.

---

## Action Procedures

### 1. Cookie Consent Handling
- **Intent**: `cookie_consent`
- **Location**: `https://www.bridgetoagent.com/` (and all other subpages)
- **Parameters**:
  - `consent_choice`: Options are `accept_all`, `reject_all`, or `customize`.
- **Procedure**:
  1. Detect the GDPR/ePrivacy consent banner on page load.
  2. Map the selection parameters to the banner elements.
  3. Dispatch the appropriate selection click. Upon selecting `customize`, ensure granular toggles are addressed if necessary.
- **Success Indicator**: The consent banner disappears and the content flow remains unblocked.

### 2. Free Site-Readiness Check
- **Intent**: `site_readiness_check`
- **Location**: `https://www.bridgetoagent.com/`
- **Parameters**:
  - `website_url` (url, required): The target website address to evaluate.
- **Procedure**:
  1. Locate the "Website URL" form input near the hero section.
  2. Populate the input with `website_url`.
  3. Submit the form by triggering the "Check my site (free)" action.
- **Success Indicator**: Audit results render inline beneath the input field displaying current agentic readiness signals.

### 3. Purchasing the Agentic Kit
- **Intent**: `product_purchase`
- **Location**: `https://www.bridgetoagent.com/`
- **Parameters**:
  - `website_url` (url, required): The website URL for which the kit will be compiled.
- **Procedure**:
  1. Scroll to the pricing section or trigger the "Get the kit — $49" button.
  2. Ensure the correct target `website_url` is provided in the checkout preparation step.
  3. Progress to the payment portal to fulfill the checkout flow.
- **Success Indicator**: Redirection to a confirmation screen or receipt page.

### 4. Order Confirmation Verification
- **Intent**: `order_confirmation`
- **Location**: `https://www.bridgetoagent.com/` (and post-checkout redirection paths)
- **Parameters**: None.
- **Procedure**:
  1. Monitor the post-payment page states for order completion details.
  2. Confirm receipt of the order details.
- **Success Indicator**: Page displays verification that your purchase was successful and that automated processing has begun.

### 5. Document / Kit Download
- **Intent**: `document_download`
- **Location**: `https://www.bridgetoagent.com/`
- **Parameters**: None.
- **Procedure**:
  1. Navigate to the post-purchase confirmation link provided on the page or in the automated email delivery system.
  2. Kits are typically compiled and delivered within ~2 minutes of payment.
- **Success Indicator**: Automated extraction or trigger of a `.zip` package containing `agents.json`, `llms.txt`, and `agent-instructions.md`.

### 6. Using the ROI Calculator
- **Intent**: `roi_calculator`
- **Location**: `https://www.bridgetoagent.com/`
- **Parameters**:
  - `average_customer_value` (number, required): Dollar value of a typical client transaction.
  - `customers_per_month` (number, required): Volume of sales generated monthly.
- **Procedure**:
  1. Locate the interactive payback calculator in the ROI section of the homepage.
  2. Input numeric values into the corresponding form controls.
- **Success Indicator**: Calculator state changes dynamically, showing payback timeline and customers needed to recover the cost.

### 7. Validating an llms.txt File
- **Intent**: `validate_llms_txt`
- **Location**: `https://www.bridgetoagent.com/tools/llms-txt-validator`
- **Parameters**:
  - `llms_txt_url_or_content` (string, required): Either the raw text of the file or the URL where it is hosted.
- **Procedure**:
  1. Access the validator tool.
  2. Paste the payload or input the URL into the validation textarea/input field.
  3. Submit the validator form.
- **Success Indicator**: Output panel renders a conformance summary with parsed details and rule violations.

### 8. Browsing Platform Guides & Install Matrix
- **Intents**: `browse_guides`, `view_install_matrix`
- **Locations**:
  - Guides: `https://www.bridgetoagent.com/guides`
  - Matrix: `https://www.bridgetoagent.com/install-matrix`
- **Parameters**: None.
- **Procedure**:
  1. Navigate to either target URL to find detailed comparison tables or setup pillars.
- **Success Indicator**: The targeted page layout renders with listing tables or installation guides.

### 9. Reading Journal and Blog Content
- **Intent**: `browse_blog`
- **Location**: `https://www.bridgetoagent.com/blog`
- **Parameters**: None.
- **Procedure**:
  1. Navigate to the blog directory.
- **Success Indicator**: Grid of journal issues containing category indicators (Comparison, Explainer, Audit) is displayed.

### 10. Navigating Documentation and Audit Overviews
- **Intents**: `view_docs_index`, `view_lighthouse_audit_info`, `view_scoring_frameworks`, `view_proof_cases`
- **Locations**:
  - Documentation Index: `https://www.bridgetoagent.com/docs`
  - Lighthouse Audit details: `https://www.bridgetoagent.com/lighthouse`
  - Scoring Frameworks: `https://www.bridgetoagent.com/scoring-frameworks`
  - Proof Case Studies: `https://www.bridgetoagent.com/proof`
- **Parameters**: None.
- **Procedure**:
  1. Directly access the selected URL to fetch schema, file standards, mapping definitions, or real-world comparative results.
- **Success Indicator**: Clean Markdown or HTML rendering of specifications and tables.

### 11. FAQ Accordion Lookup
- **Intent**: `faq_lookup`
- **Location**: `https://www.bridgetoagent.com/` (FAQ Section)
- **Parameters**: None.
- **Procedure**:
  1. Scroll down to the FAQ block on the homepage.
  2. Target and trigger individual accordion handles to expose answers.
- **Success Indicator**: Associated answers expand and become visible.

### 12. Contacting Support
- **Intent**: `contact`
- **Location**: `mailto:hello@bridgetoagent.com`
- **Parameters**:
  - `subject` (string, optional)
  - `body` (string, required)
- **Procedure**:
  1. Construct or dispatch an email targeting `hello@bridgetoagent.com`.
- **Success Indicator**: Transfer or preparation of the email draft with defined payload parameters.

---

## Known Gotchas & Failure Modes

- **Dynamic Check Rendering**: The 5-second readiness check runs asynchronously on submit. Avoid immediate page timeouts. Allow the frontend up to 10 seconds to collect, analyze, and render the results panel.
- **Stale Cache / Cookie Barriers**: If the site fails to accept cookie consent preferences or update the ROI calculator, clear stored cookies or bypass local caching.
- **Post-Purchase Kit Compiling**: Kits are compiled asynchronously server-side. Wait for the ~2 minute build buffer before reporting a missing download link in confirmation flows. If download links are unresponsive, fall back to contacting support at `hello@bridgetoagent.com`.

---

_This runbook was generated by [BridgeToAgent](https://bridgetoagent.com) — the standard for agents.json + llms.txt + agent-instructions.md kits. Regenerate it any time your site changes meaningfully at https://bridgetoagent.com._