Remediation Engine

Actionable Code Patches

Don't just find issues — fix them. Get before/after code comparisons with effort estimates and priority scoring.

How Patches Work

Every issue found in an Agent-Ready Audit gets a matching code patch.

Issue Found

A detection function finds a problem

Patch Generated

Template-based fix with context

Before/After

See exactly what changes

Effort/Impact

Prioritize what to fix first

Patch Categories

Common fixes organized by type.

Add ARIA Labels to Buttons

Generic text like "Submit" or "Click" doesn't tell AI agents what the button does. Add clear aria-label attributes instead.

Before

<button class="submit-btn">
  Submit
</button>

After

<button
  class="submit-btn"
  aria-label="Submit order and proceed to payment"
>
  Submit
</button>

Effort:Low

Impact:High

llms.txt as Remediation

Missing llms.txt is a common audit issue. The remediation engine can auto-generate one from your site structure.

# Generate llms.txt as part of remediation

npx cbrowser agent-ready-audit https://example.com --patches --generate-llms-txt

# Output includes generated llms.txt content

{
  "patches": [
    {
      "issue": "missingLlmsTxt",
      "severity": "medium",
      "fix": {
        "type": "create_file",
        "path": "/llms.txt",
        "content": "# Example Site\n\n> Your site description...\n\n## Sections\n..."
      }
    }
  ]
}

Effort/Impact Matrix

Sort fixes by effort and impact on your AI-friendliness score.

Priority	Issue	Effort	Impact
P1	Add missing button labels	Low	High
P1	Associate form labels	Low	High
P2	Add llms.txt file	Low	Medium
P2	Add JSON-LD structured data	Medium	Medium
P1	Convert custom dropdowns to ARIA	Medium	High
P2	Add stable IDs to elements	Low	Medium
P3	Fix heading hierarchy	Low	Low
P3	Add skip links	Low	Low

Priority scoring: P1 = Low effort + High impact (do first), P2 = Medium combinations, P3 = Low impact (do last)

Integration with Audit

Add the --patches flag to get fix suggestions inline with each audit issue.

# Audit with patches

npx cbrowser agent-ready-audit https://example.com --patches

# Output includes patches for each issue

{
  "score": {
    "overall": 84,
    "grade": "B",
    "findability": 91,
    "stability": 78,
    "accessibility": 85,
    "semantics": 72
  },
  "issues": [
    {
      "detection": "genericButtonText",
      "severity": "medium",
      "element": "button.submit-btn",
      "patch": {
        "before": "<button class=\"submit-btn\">Submit</button>",
        "after": "<button class=\"submit-btn\" aria-label=\"Submit order\">Submit</button>",
        "effort": "low",
        "impact": "high"
      }
    }
  ]
}

Start Fixing Issues

Run an Agent-Ready Audit with patches. See what needs fixing and how to fix it.

Run an Audit Compare to Competitors