Agent-Friendly Documentation Spec

Agent-Friendly Documentation Spec은 AI 코딩 에이전트(Claude Code, GitHub Copilot 등)가 문서 사이트를 효율적으로 접근하고 활용할 수 있도록 23가지 점검 항목을 7개 카테고리로 정의한 표준이다. 주요 권장사항으로는 llms.txt 파일 생성, 마크다운(.md) 버전 제공, 페이지 크기 제한, URL 안정성 유지 등이 포함된다. afdocs라는 CLI 도구와 라이브러리를 통해 문서 사이트의 에이전트 친화성 검사를 자동화할 수 있으며, 이 스펙은 커뮤니티 참여를 통해 지속 개선 중이다.

https://agentdocsspec.com/

#documentation #aiagents #markdown #llms.txt #afdocs

"Test your documentation site against the Agent-Friendly Documentation Spec.

Agents don't use docs like humans. They hit truncation limits, get walls of CSS instead of content, can't follow cross-host redirects, and don't know about quality-of-life improvements like llms.txt or .md docs pages that would make life swell. Maybe this is because the industry has lacked guidance - until now.

afdocs runs 21 checks across 8 categories to evaluate how well your docs serve agent consumers. 10 are fully implemented; the rest return skip until completed."

https://www.npmjs.com/package/afdocs

#TechnicalWriting #SoftwareDocumentation #AI #AIAgents #Afdocs #Markdown #DocsAsCode #LLMSTXT