# Cache headers

> 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 cache-header-hygiene, worth 2 weight (AFDocs).

## What it measures and why

Whether cache headers allow timely updates.

Long caching keeps agents reading old versions after you fix a page.

Evidence:

- [Agent-Friendly Documentation Spec: cache-header-hygiene](https://agentdocsspec.com/spec/web/observability/#cache-header-hygiene)

## How it counts

This is an AFDocs check, from the open Agent-Friendly Documentation checks; the description above is AFDocs' own. It has a weight of 2 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.

**Depends on your hosting.** Cache headers are set by your web server or CDN. A local build (`--dir` or a localhost URL) doesn't count this check.

## 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 `cache-header-hygiene` in the report. A failed check comes with the fix worth the most points first. `lensy explain cache-header-hygiene` 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)
