Skip to content

Spec v0.4.0 #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dacharyc merged 9 commits into from
Apr 22, 2026
Merged

Spec v0.4.0 #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
36f91fb
Rename 'llms-txt-freshness' to 'llms-txt-coverage'
dacharyc Apr 22, 2026
7f6a74e
Merge pull request #18 from agent-ecosystem/rename-llms-txt-freshness
dacharyc Apr 22, 2026
385b31e
Generalize away from Claude Code-specific HTML-to-markdown pipeline
dacharyc Apr 22, 2026
5ca21e2
Merge pull request #19 from agent-ecosystem/reflect-turndown-implemen…
dacharyc Apr 22, 2026
ae26e9f
Reflect that llms.txt coverage may be a gap or intentional curation
dacharyc Apr 22, 2026
311c948
Merge pull request #20 from agent-ecosystem/llms-txt-intentional-cura…
dacharyc Apr 22, 2026
c23bbb5
Reflect that markdown parity differences may be a bug or intentional …
dacharyc Apr 22, 2026
00f719e
Merge pull request #21 from agent-ecosystem/markdown-content-parity-c…
dacharyc Apr 22, 2026
f2dc3f5
Fix up remaining 'freshness' references
dacharyc Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ docs agent-friendly. The spec focuses on meeting the technical constraints of
agent platforms (truncation limits, content negotiation, discovery); it does not
consider qualitative evaluation of content.

**Status**: Draft (v0.3.0)
**Status**: Draft (v0.4.0)

**Full spec**: [SPEC.md](SPEC.md) | **Website**: [agentdocsspec.com](https://agentdocsspec.com)

Expand Down Expand Up @@ -38,7 +38,7 @@ The spec defines **22 checks across 7 categories**:
| Page Size | 4 | Rendering strategy (SPA/CSR detection), markdown size, HTML size (pre/post conversion), content start position |
| Content Structure | 3 | Tabbed content serialization blowup, section header quality, code fence validity |
| URL Stability | 2 | Soft 404 detection, redirect behavior |
| Observability | 3 | `llms.txt` freshness, markdown/HTML content parity, cache header hygiene |
| Observability | 3 | `llms.txt` coverage, markdown/HTML content parity, cache header hygiene |
| Authentication | 2 | Auth gate detection, alternative access paths for gated content |

Each check has defined pass/warn/fail criteria, an automation level, and
Expand Down
Loading