Harness
Last scanned developer.harness.ioGitBook15 pages tested
AI agents can find, read and use these docs well. Harness scores 90 out of 100 (grade A), passing 18 of 27 checks. 9 still need work.
Developer docs
Kind of site
18/27
Checks passed
4
Partly passed
5
Failed
Access
Content discoverability4 passed1 failed2 partly
llms.txt fits in an agent's context
llms.txt is 1,846,533 characters (exceeds 100,000 threshold; will be truncated by most agents)
Your llms.txt is 1,846,533 characters and will be truncated by all major agent platforms. Split into a root index linking to section-level llms.txt files, each under 50,000 characters.
Check your fix:
curl -s https://developer.harness.io/llms.txt | wc -cprints less than 50000.llms.txt follows the standard structure
llms.txt contains parseable links but doesn't fully follow the proposed structure: https://developer.harness.io/llms.txt: No blockquote summary found
Your llms.txt contains parseable links but doesn't follow the standard structure. Add an H1 title as the first line and a blockquote summary (lines starting with >) to improve agent parsing.
Check your fix: llms.txt starts with a
# Title, then a> summaryline, then##sections of links.Pages point agents to llms.txt
llms.txt directive found in HTML of 15 of 15 sampled pages, but buried deep in the page (past 50%)
An llms.txt directive was found in the HTML of some pages but is missing from others, or is buried deep in the page. Ensure the directive appears near the top of every documentation page.
Check your fix:
curl -s https://developer.harness.io/ai-agent-guidance | grep -n llms.txtfinds the link near the top of the HTML.llms.txt exists
llms.txt found at https://developer.harness.io/llms.txt
llms.txt links work
All 15 same-origin sampled links resolve (8730 total links)
llms.txt links point to Markdown
15/15 same-origin sampled links point to markdown content (100%)
Markdown pages point agents to llms.txt
llms.txt directive found in markdown of all 15 sampled pages, near the top of content
Markdown availability2 passed
Pages are available as Markdown
15/15 sampled pages support .md URLs (100%)
Server returns Markdown when asked
15/15 sampled pages support content negotiation (100%)
Page size and truncation2 passed2 failed
HTML pages fit in context
1 of 15 sampled pages convert to over 100K chars (max 1380K HTML → 109K markdown (97% boilerplate))
1 of 15 pages convert to over 100K characters of markdown. Break large pages into smaller units, reduce navigation boilerplate, or provide markdown versions that bypass the HTML conversion overhead.
Content starts near the top
5 of 15 sampled pages have content starting past 50% (worst 92%)
5 of 15 pages have content starting past 50% of the converted output. Agents may never see the documentation content. Reduce navigation, breadcrumb, and sidebar markup that precedes the content area.
Content is in the HTML without JavaScript
All 15 sampled pages contain server-rendered content
Markdown pages fit in context
All 15 pages under 50K chars (median 6K, max 32K)
Content structure2 passed
Headings inside tabs name their variant
1 page(s) with tabs found, but no section headers inside tab panels to evaluate
Tabs don't bloat the page
1 tab group(s) across 1 of 15 sampled pages; all serialize under 50K chars
Code blocks are well-formed
All 35 code fences properly closed across 16 pages
URL stability2 passed
Missing pages return a real 404
All 13 sampled pages return proper error codes for bad URLs; 2 failed to fetch
Redirects stay on the same host
All 1 redirect(s) across 15 sampled pages are same-host HTTP redirects
Content health2 passed1 failed
Markdown matches the HTML page
1 of 15 pages have substantive content differences between markdown and HTML (avg 4% missing)
1 pages have substantive content differences between markdown and HTML (avg 4% missing). If unintentional, agents are getting outdated content; regenerate markdown from source or fix the build pipeline.
llms.txt covers the whole site
llms.txt covers 98% of 8711 sitemap doc pages; 73 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
Cache headers allow timely updates
All 16 endpoints have appropriate cache headers
Authentication and access1 passed1 partly
Docs are readable without logging in
1 of 15 sampled pages require authentication (14 accessible)
Some documentation pages require authentication while others are public. Agents can access public pages but will fall back on training data for gated content. Consider ungating reference docs and API guides.
Check your fix:
curl -sI https://developer.harness.io/ai-agent-guidancereturns 200 without cookies or a token.Gated docs offer another way in
Alternative access detected (public-llms-txt, public-markdown, partial-public-access) for site with 1 auth-gated pages
Crawler access1 passed1 failed
Sitemap lists the docs pages
The sitemap at https://developer.harness.io/sitemap.xml lists 2028 of the 8639 docs pages found through llms.txt and page links.
Generate the sitemap from the same source as the docs, so every page is listed. Agents and crawlers use it to find pages that navigation does not link.
Check your fix:
curl -s https://developer.harness.io/robots.txt | grep -i sitemapnames a sitemap, and that sitemap lists the pages the report names as missing.Crawlers and AI assistants may read the docs
robots.txt lets Googlebot, Bingbot, OAI-SearchBot, PerplexityBot, Claude-SearchBot and Claude-User read the docs.
Freshness
Maintenance2 passed1 partly
Links and section anchors work
1 of 55 references checked on the sampled pages are broken: 0 links and 1 section anchor. 1 more could not be verified (timeouts or blocked requests) and is not counted.
Fix or remove the broken links, redirect moved pages to their new address, and restore or retarget section anchors. Agents follow links to gather context, and a dead link ends that path.
Check your fix: Every link on https://developer.harness.io/cloud-cost-management/cost-optimization/autostopping-rules/autostopping-rules#aws (no such section) linked from https://developer.harness.io/cloud-cost-management/resources/autostopping-guides/rds returns 200, and every
#sectionlink points at an element with that id.Pages say when they were last changed
15 of 15 sampled pages state when they were last changed.
Sitemap entries still exist
All 10 sitemap entries sampled still exist.
Consistency with the API specNot applicable
Endpoints in the docs exist in the API spec
No OpenAPI description was found, so the docs could not be compared with a spec.
CurrencyNot applicable
Deprecated operations are marked as such
No OpenAPI description was found, so deprecation notices could not be compared with a spec.
Additional checks
Not part of the score: optional extras that help agents use your docs.
MCP server is discoverable
An MCP server is described at https://developer.harness.io/.well-known/mcp/server-card.json.
llms-full.txt is available
llms-full.txt found at https://developer.harness.io/llms-full.txt (1,386,634 characters).
Agent skills are published
No agent skills index was found at /.well-known/agent-skills/index.json.
Publish an Agent Skills index at /.well-known/agent-skills/index.json with a SKILL.md for your main tasks, so agents can load task instructions without reading every page.
About this scan
- Scanned
- Oct 21, 2026
- Pages tested
- 15 of 7472 found
- Platform
- GitBook
- Kind of site
- Developer docs
- AFDocs score, on its own
- 90 (A), 15 of 23 checks pass
- Based on 15 sampled pages, chosen deterministically from the sitemap and llms.txt. Pages outside the sample were not read.
- Pages were fetched without running JavaScript, the way most AI agents read the web.
- robots.txt stopped the scanner from reading 1 URL; checks that needed them are unverified.
- Answerability, where an AI agent answers real questions written from these pages, runs in the open-source scanner with your own API key. This web score is made of Access and Freshness.
Methodology 2026-09.6 · AFDocs 0.20.0
Pages we sampled (15)
- https://developer.harness.io/ai-agent-guidance
- https://developer.harness.io/ai-sre/ai-sre-for-administrators/set-up-on-call-management/integrations
- https://developer.harness.io/cloud-cost-management/resources/autostopping-guides/rds
- https://developer.harness.io/continuous-delivery/troubleshooting-and-resources/armory/general/renaming-a-configmap-creates-a-new-copy-and-does-not-delete-the-original
- https://developer.harness.io/continuous-delivery/use-continuous-delivery/deploy-services-on-different-platforms/kubernetes/kubernetes-executions/run-kubernetes-jobs
- https://developer.harness.io/feature-flags/readme
- https://developer.harness.io/harness-ai/troubleshooting-and-resources/tutorials/add-secrets-manager
- https://developer.harness.io/harness-ai/use-harness-platform/triggers/triggers-enforcerbac
- https://developer.harness.io/harness-platform/use-harness-cli/harness-cli/authenticate
- https://developer.harness.io/harness-solutions-factory/use-hsf/created-resources
- https://developer.harness.io/open-source/use-harness-open-source/pipelines-1/variables
- https://developer.harness.io/resilience-testing/chaos-engineering/faults/chaos-fault-categories/linux/permissions
- https://developer.harness.io/sast-and-sca/prezero/deployment
- https://developer.harness.io/software-engineering-insights/use-software-engineering-insights/get-started/enable-the-sei-module
- https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery/installation/platform-agent/kubernetes/annotations-and-labels
Show your score
Add the badge to your docs or README. It updates each time the site is scanned.
Markdown
[](https://documentation.ai/agent-score/harness)HTML
<a href="https://documentation.ai/agent-score/harness"><img src="https://documentation.ai/agent-score/badge/harness.svg" alt="Agent Readiness Score: 90 (A)" height="20"></a>Agent-ready docs by default
Live in under 5 min · No credit card required