Skip to content

Quick Start

This guide walks you through running your first audit, understanding the results, and fixing the issues found.

Step 1: Run an Audit

Start a Claude Code conversation and tell it which site to audit:

You: Run FAT agent on https://mysite.com

Or use the slash command:

You: /fat-audit https://mysite.com

FAT Agent will:

  1. Ask clarifying questions about your site type and stack
  2. Fetch the page HTML and response headers
  3. Auto-detect which conditional modules to enable
  4. Run all applicable modules
  5. Present a prioritised findings list

Specifying a profile

To skip the questions and jump straight to an audit with a specific profile:

You: Audit https://mysite.com with the quick profile
You: /fat-audit https://mysite.com --profile local

See Profiles for the full list.

Step 2: Understand the Results

FAT Agent produces a structured report with several sections.

Score Summary

Overall Score: 72/100 (C)
  SEO:           78/100 (C)
  Security:      65/100 (D)
  Accessibility: 82/100 (B)
  Performance:   58/100 (F)

Each category is graded: A (90+), B (80+), C (70+), D (60+), F (<60).

Findings List

Findings are grouped by priority:

Priority Meaning Action
P0 Critical Fix immediately -- broken functionality or security vulnerability
P1 High Fix before next release -- significant impact on users or search
P2 Medium Fix soon -- moderate impact, good quick wins
P3 Low Fix when convenient -- minor improvements, best practices

Each finding includes:

  • Title -- one-line summary
  • Description -- what the issue is and why it matters
  • Fix -- step-by-step remediation
  • Effort -- estimated effort (low, medium, high)
  • Module -- which module detected it

Supplementary Module Scores

If conditional modules ran (Local SEO, E-commerce, etc.), their scores appear separately below the core scores.

Step 3: Fix Issues

After reviewing the results, ask FAT Agent to generate fixes:

You: Fix the P0 and P1 issues
You: Show me the code fix for the missing CSP header
You: Fix all SEO issues

FAT Agent will generate platform-specific fixes. It knows about:

  • Platforms: Netlify, Vercel, Cloudflare Pages, Apache, Nginx, WordPress, AWS, Docker
  • Frameworks: Next.js, Astro, SvelteKit, Nuxt, Gatsby, Remix, WordPress, Static HTML

Example fix flow

You: Fix the missing HSTS header

Claude: For your Nginx setup, add this to your server block:

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

  Then reload: sudo systemctl reload nginx

  Shall I also fix the missing CSP header while we're in the security headers?

Step 4: Re-test

After deploying your fixes, ask FAT Agent to verify:

You: Re-test https://mysite.com
You: Check if the security fixes are live

FAT Agent re-runs the audit and highlights what improved, what regressed, and what's still outstanding.

Step 5: Generate Reports

For stakeholders or clients, generate formatted reports:

You: Generate an HTML dashboard for the audit
You: Create a client-facing report
You: Export the results as a Word document

The HTML dashboard is a self-contained file with colour-coded grades, progress bars, and a findings table. Client-facing mode replaces technical jargon with plain English.

What Next?