# Headings an agent can navigate

> Part of [Lensy by Perseverance AI](https://perseveranceai.com/). The index of every page for AI agents is at [https://perseveranceai.com/llms.txt](https://perseveranceai.com/llms.txt).

Last updated: 2026-11-12

Coding agents check lensy-headings, worth 4 weight (Lensy).

## What it measures and why

On what an agent receives: exactly one H1 (half the points; more than one, a fifth) and an outline with no skipped heading levels (half; one skip, a quarter), counted only with at least 2 headings.

A URL #fragment never reaches the server, so agents find sections by heading text. AFDocs' section-header-quality only looks inside tabs.

Evidence:

- [How Claude Code eats the web](https://giuseppegurgone.com/claude-webfetch)

## How it counts

This is Lensy's own check, scored alongside the AFDocs checks. It has a weight of 4 in the Coding agents score (critical 10, high 7, medium 4, low 2). A pass earns the full weight and a warning earns part of it. The score is the weight earned over the weight of the checks that ran, out of 100, and with no llms.txt it is at most 59.

## Check it yourself

Scan the page on the [home page](https://perseveranceai.com/#scan), or run `lensy check <url>` from the [command line tool](https://perseveranceai.com/docs/cli) and look for `lensy-headings` in the report. A failed check comes with the fix worth the most points first. `lensy explain lensy-headings` prints what it measures, why it matters and the evidence in your terminal, and [every check](https://perseveranceai.com/docs/checks) lists the rest.

[All checks](https://perseveranceai.com/docs/checks)
