Skip to main content

Site explains its mechanism

ab-001529 · geo-readiness.content-citability.how-it-works-explanation
Severity: lowactive

Why it matters

When a user asks an AI assistant "how does X work?" the assistant reaches for explanatory process content — step-by-step mechanisms, workflows, and cause-and-effect descriptions. A site with no "how it works" narrative surrenders that entire query class to competitors, and the downstream effect is missed placements in comparison tables, recommendation lists, and tutorial-style answers where intent runs highest.

Severity rationale

Low because explanatory content is complementary rather than foundational for AI citation.

Remediation

Add a "How it works" section with a heading containing the word "how" and at least 100 words of process-oriented explanatory content. Describe concrete steps the user or system takes, not just feature labels. Place it on the homepage or create src/app/how-it-works/page.tsx.

<h2>How It Works</h2>
<p>Pick an audit, paste the prompt into your AI tool, and submit the JSON telemetry for scoring and benchmarking.</p>

Detection

  • ID: geo-readiness.content-citability.how-it-works-explanation

  • Severity: low

  • What to look for: Look for a section or page with a heading containing "how" (e.g., "How it works", "How to use", "How audits work"). Count the number of words in the section's explanatory content (excluding headings and navigation). The section must describe the product's mechanism or process — not just feature labels.

  • Pass criteria: A "how it works" section or page exists with a heading containing "how" and at least 100 words of explanatory content describing the product's process or mechanism. The content must include at least 1 concrete step or action the user or system takes (not just abstract descriptions). Do NOT pass when the section heading says "how" but the content is only feature labels or benefit statements with no process explanation.

  • Fail criteria: No "how it works" content exists anywhere on the site. Only feature lists or benefit statements with no explanation of the underlying process. A heading like "How it works" followed by fewer than 100 words (e.g., only 3 bullet points) also fails. Report: "'How it works' section found but contains only X words — minimum 100 required" or "No 'how it works' section found across X pages scanned".

  • Skip (N/A) when: API-only project with only reference documentation (no product marketing).

  • Detail on fail: "No 'how it works' section found across 6 pages scanned. Site describes what it does but not how." or "'How It Works' section contains only 3 bullet points (28 words) — minimum 100 words required to explain the mechanism"

  • Remediation: AI systems value explanatory content that describes processes. Add a "How it works" section:

    <section>
      <h2>How It Works</h2>
      <p>Pick an audit from the library and paste the prompt into your AI coding
      tool. The audit runs 20-40 automated checks against your codebase — examining
      configuration files, dependencies, and code patterns. It produces a JSON
      telemetry block with pass/fail results and a human-readable report with
      remediation guidance. Submit the JSON to AuditBuffet for scoring and
      community benchmarks.</p>
    </section>
    

Taxons

History