<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Daniel Kim on Medium]]></title>
        <description><![CDATA[Stories by Daniel Kim on Medium]]></description>
        <link>https://medium.com/@danielkim-dev?source=rss-ae16cdd0a8b5------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*BnerETNQqxzJtCCi4vdrkg.png</url>
            <title>Stories by Daniel Kim on Medium</title>
            <link>https://medium.com/@danielkim-dev?source=rss-ae16cdd0a8b5------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 23:27:40 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@danielkim-dev/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[AI 에이전트가 읽는 기술 문서, 무엇이 달라야할까 — 5부]]></title>
            <link>https://danielkim-dev.medium.com/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-5%EB%B6%80-a75fd7cab032?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/a75fd7cab032</guid>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Fri, 28 Aug 2026 01:24:31 GMT</pubDate>
            <atom:updated>2026-08-28T01:24:31.336Z</atom:updated>
            <content:encoded><![CDATA[<h4>점수가 매겨지지 않는 계층: AI 에이전트로 문서 콘텐츠를 점검하고 고치기</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*axEZEnn2MROswWatKsxKnQ.jpeg" /></figure><p>앞선 4편에서는 DoveRunner Docs의 인프라 계층을 개선했습니다. 응답 헤더를 추가하고, 에이전트가 요청하면 Markdown 형식으로도 문서를 내려주도록 바꾸고, robots.txt에 Content Signals를 선언했습니다. <a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> 사이트의 점수는 43점에서 86점으로, <a href="https://buildwithfern.com/agent-score">Fern Agent Score 사이트</a>에서는 0점에서 99점으로 올라갔습니다.</p><p>작업하는 내내 문서 본문은 한 글자도 건드리지 않았습니다.</p><p>이것이 ‘에이전트 준비도’(Agent Readiness)를 두 계층으로 나누어 보는 이유입니다. 인프라 계층은 점검 도구가 통과와 실패로 판정해 주고, 무엇을 고쳐야 하는지도 도구가 알려 줍니다. 반면 콘텐츠 계층에는 그런 도구가 없습니다. 에이전트가 문서를 잘 읽어 갈 수 있다는 사실과, 그 문서를 읽고 올바른 연동 코드를 만들어 낸다는 사실은 전혀 다른 문제이기 때문입니다.</p><p>이 글에서는 DoveRunner 문서의 콘텐츠 계층에서 실제로 무엇이 잘못되어 있었는지를 AI 에이전트와 함께 찾아내고 고쳐서 프로덕션까지 반영한 과정과, 그 결과가 남긴 한계에 대해 알아보겠습니다.</p><h3>개요: 작업의 흐름</h3><p>전체 작업은 여섯 단계로 진행되었습니다. 어디까지가 에이전트의 몫이고 어디부터가 사람의 몫이었는지가 이 글의 핵심이므로, 순서부터 정리해 두겠습니다.</p><ol><li>에이전트가 연동 워크플로 단위로 문서의 Markdown 원본을 훑습니다.</li><li>발견한 문제를 유형, 설명, 원본 위치와 함께 목록으로 정리합니다.</li><li>에이전트가 고칠 수 있는 것을 고쳐 원본 파일에 반영하고, 목록에는 처리 결과를 남깁니다.</li><li>제품군별로 PR을 나누어 올립니다.</li><li>각 제품 담당 PO가 자기 제품의 문서 변경을 검토하고 확인합니다.</li><li>프로덕션에 배포합니다.</li></ol><h3>연동 여정 단위로 문제점 찾기</h3><p>문서 점검을 페이지 단위로 하면 페이지 단위의 문제만 나옵니다. 오타, 끊어진 링크, 빠진 파라미터 설명 같은 것들입니다. 이런 문제도 물론 고쳐야 하지만, 에이전트가 연동 코드를 잘못 만들어 내는 원인은 대개 다른 곳에 있습니다.</p><p>그래서 이번에는 제품군별로 고객 입장에서 정리한 엔드투엔드 연동 시나리오를 기준으로 삼았습니다. 개발자가 실제로 밟아 나가는 하나의 여정, 예를 들어 FairPlay 인증서를 발급받는 시점부터 패키징을 거쳐 iOS 플레이어에서 재생이 확인되는 시점까지를 하나의 단위로 놓고, 그 여정에 걸리는 문서들을 함께 읽도록 했습니다.</p><p>이렇게 보면 단일 페이지만 볼 때는 보이지 않던 문제가 드러납니다. 각 페이지는 저마다 정확한데 페이지와 페이지 사이에서 정보가 끊기는 경우입니다. 앞 문서가 넘겨준 값의 형식과 뒤 문서가 기대하는 형식이 어긋나 있거나, 반드시 먼저 처리해야 하는 선행 조건이 정작 그 조건이 필요한 문서가 아니라 다른 제품 문서의 중간에 묻혀 있는 식입니다.</p><p>이번 점검에서 나온 가장 위험한 사례도 이 유형이었습니다. 포렌식 워터마킹을 Transcoding &amp; Packaging(이하 T&amp;P)과 함께 사용하는 여정에서, T&amp;P는 워터마킹된 결과물을 정해진 폴더 구조에 만들어 둡니다. 시청자가 재생을 시작할 때 서버는 이 결과물의 위치를 알아야 하며, 재생 세션을 발급하는 API에 prefix_folder 파라미터로 그 값을 넘겨 주게 되어 있습니다. 세션 발급 API 문서에는 이 파라미터가 정확하게 설명되어 있었습니다. 문제는 T&amp;P 쪽 문서였습니다. 결과물이 어떤 폴더 구조로 만들어지는지, 그리고 그 값을 다음 단계에서 넘겨야 한다는 사실이 적혀 있지 않았습니다.</p><p>두 문서 모두 그 자체로는 틀린 곳이 없습니다. 다만 T&amp;P 문서만 읽고 다음 단계로 넘어가는 개발자나 에이전트는 넘겨야 할 값이 있다는 것 자체를 알 수 없었습니다. 이런 종류의 누락은 오류 메시지로 드러나지 않고 재생이 되지 않는 결과로만 나타나기 때문에 원인을 찾는 데 시간이 오래 걸립니다. 조치는 T&amp;P 문서에 폴더 구조와 파라미터 요구 사항을 주의 블록으로 추가하고 세션 발급 API 문서로 상호 링크를 거는 것이었습니다. 작업 자체는 몇 분이면 끝나지만, 두 문서를 한 여정으로 이어서 읽기 전에는 존재 자체가 보이지 않던 문제입니다.</p><p>이 단계에서 6개 제품군에 걸쳐 <strong>71건</strong>의 콘텐츠 이슈가 나왔습니다. 각 항목은 유형(오류 / 누락 / 위치 문제), 설명, 그리고 해당 원본 파일과 줄 번호까지 함께 기록되었습니다. 이 목록이 이후 모든 작업의 기준선이 되었습니다.</p><h3>에이전트가 고치고, 사람이 검토하고</h3><p>목록이 만들어진 다음에는 에이전트가 손댈 수 있는 항목부터 수정하도록 했습니다. 문서가 이미 Markdown으로 관리되고 있기 때문에 에이전트가 원본 파일을 직접 고치는 데에는 형식 변환 같은 중간 단계가 필요하지 않았습니다. 수정을 마칠 때마다 에이전트는 처음 만든 목록의 비고란에 무엇을 확인했고 어떻게 처리했는지를 남겼습니다. 결과적으로 이슈 목록 자체가 작업 기록이 되었습니다.</p><p>여기서 한 가지 선택을 했습니다. 71건의 수정 사항을 하나의 PR로 묶지 않고, 제품군에 따라 세 개의 PR(Pull Request)로 나눈 것입니다.</p><ul><li><strong>Multi-DRM</strong></li><li><strong>Watermarking / Anti-Piracy</strong></li><li><strong>Mobile App Security</strong></li></ul><p>그리고 각 PR에 해당 제품의 PO(Product Owner)를 리뷰어로 지정했습니다. 이렇게 나눈 이유는 검토의 품질 때문입니다. 문서 수정의 사실 여부를 판단할 수 있는 사람은 그 제품을 아는 사람뿐입니다. 71건이 뒤섞인 PR을 받은 PO는 자기 제품과 무관한 변경까지 함께 훑어야 하고, 그런 상황에서는 검토가 형식적으로 흐르기 쉽습니다. 반면 자기 제품의 변경만 담긴 PR이라면 한 줄씩 확인할 수 있는 분량이 됩니다.</p><p>세 PO 모두 자기 제품의 문서가 의도대로 수정되었음을 확인했고, 그 뒤에 프로덕션으로 배포했습니다.</p><h3>결과, 그리고 남은 9건</h3><p>전수 검토를 마친 결과는 다음과 같습니다.</p><ul><li>수정 완료: 59</li><li>수정 불필요 (확인 결과 문제 아님): 3</li><li><strong>타 조직 확인 대기: 9</strong></li><li><strong>합계: 71</strong></li></ul><p>비율로는 <strong>83%</strong>입니다. 다만 이 작업에서 더 많은 것을 알려 준 숫자는 남은 9건 쪽이었습니다. 막힌 9건에 공통점이 있었기 때문입니다. 전부 <strong>답이 문서 안에 없는 문제</strong>였습니다.</p><p>에이전트는 문서 내용 전체를 읽을 수 있습니다. 그래서 문서 안에 답이 흩어져 있는 문제, 즉 다른 페이지에는 설명되어 있는데 정작 필요한 자리에 없는 정보나, 앞뒤 문서가 서로 다른 형식을 전제하고 있는 불일치는 잘 찾아내고 잘 메웁니다. 41건이 이런 방식으로 수정되었고, 13건은 중간에 이미 해결된 것으로 확인되었습니다.</p><p>하지만 문서 어디에도 존재하지 않는 사실은 에이전트가 만들어 낼 수 없습니다. 남은 9건을 담당 조직별로 묶어 보면 성격이 분명하게 드러납니다.</p><ul><li><strong>제품 팀 확인 필요</strong>: 자동화 연동에 필요한 API의 권장 동작과 일부 응답 규격이 문서화되어 있지 않습니다. 9건 중 절반 가까이가 여기에 몰려 있습니다.</li><li><strong>플랫폼/사업 조직 확인 필요</strong>: 콘솔 화면의 표기, 특정 상품 유형의 지원 범위, 계약과 법무가 얽힌 절차처럼 제품과 사업 쪽의 확인이 있어야 문서로 옮길 수 있는 항목입니다.</li></ul><p>이 가운데 어느 것도 글을 잘 써서 해결되는 문제가 아닙니다. 권장 폴링 주기를 문서에 쓰려면 먼저 담당 팀이 그 주기를 정해야 하고, 토큰 만료 시간을 쓰려면 그 값이 계약된 동작인지 확인되어야 합니다. 문서화 이전에 결정이 필요한 사안이며, DevRel(Developer Relations) 팀이 단독으로 해결할 수 있는 항목이 아닙니다.</p><p>이 구분이 이번 작업에서 얻은 가장 실용적인 결과였습니다. 71건은 처음에 모두 같은 무게의 ‘문서 이슈’로 보였습니다. 그러나 전수 검토를 마치고 나니 그중 62건은 문서를 고치는 것만으로 해결되는 항목이었고, 9건은 애초에 문서 문제가 아니라 전체 조직의 미결정 사항이 문서에 나타난 것이었습니다.</p><h3>에이전트에게 맡길 수 있었던 구간</h3><p>이번 작업의 여섯 단계를 다시 보면, 에이전트가 실제로 담당한 것은 1번부터 3번까지입니다.</p><p>문서 검토, 목록화, 수정이라는 세 구간은 성격이 같습니다. 양이 많고, 판단 기준이 비교적 명확하며, 결과를 사람이 나중에 검증할 수 있습니다. 6개 제품군의 문서를 연동 여정 단위로 교차 확인하는 일은 사람이 하기에는 지루하고 빠뜨리기 쉬운 작업인 반면, 에이전트에게는 잘 맞습니다.</p><p>4번부터 6번까지는 사람의 몫으로 남았습니다. PR을 어떻게 쪼갤지, 누구에게 검토를 맡길지, 무엇을 배포할지는 조직의 맥락에 대한 판단입니다. 특히 5번의 PO 검토는 대체할 방법이 마땅치 않습니다. 에이전트가 수정한 71건 가운데 사실관계가 틀린 것이 있는지를 판별하려면 제품을 실제로 아는 사람이 읽어야 하기 때문입니다.</p><p>문서 개선에 AI를 도입할 때 기대 수준을 어디에 둘지는 이 경계를 기준으로 잡으면 될 것 같습니다.</p><h3>마치며</h3><p>이상으로 DoveRunner 문서의 콘텐츠 계층을 점검하고 수정한 과정에 대해 알아보았습니다.</p><p>다섯 편에 걸쳐 정리한 내용을 한 줄로 줄이면, 에이전트 준비도는 점수가 아니라 두 종류의 서로 다른 작업이라는 것입니다. 인프라 계층은 도구가 문제를 알려 주고 AI 에이전트가 쉽게 해결할 수 있습니다. 콘텐츠 계층은 알려 주는 도구가 없어서 실제 연동 여정을 기준으로 직접 만들어야 하고, 그렇게 만든 목록의 마지막 10% 남짓은 사람이 직접 해결해야 합니다.</p><p>DoveRunner 문서를 연동 작업에 활용하고 계시다면, 이번에 반영된 내용은 <a href="https://docs.doverunner.com/">DoveRunner Docs</a>에서 바로 확인하실 수 있습니다. 문서에서 막히는 지점이 있다면 알려 주시기 바랍니다. 이번 작업에서 확인했듯이, 가장 찾기 어려운 문제는 실제로 그 여정을 걸어 본 사람에게서 나옵니다.</p><p><em>이 시리즈는 </em><a href="https://docs.doverunner.com/"><em>DoveRunner의 개발자 문서</em></a><em>와 AI 코딩 에이전트가 필요로 하는 것 사이의 격차를 정의하고 좁혀 나가는 체계적인 작업을 기록합니다.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a75fd7cab032" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Agent Readiness for Technical Documentation — Part 5]]></title>
            <link>https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-5-813d91e32daa?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/813d91e32daa</guid>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[ai-agent]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Fri, 28 Aug 2026 01:24:17 GMT</pubDate>
            <atom:updated>2026-08-28T01:24:17.710Z</atom:updated>
            <content:encoded><![CDATA[<h4>The Layer Nobody Scores: Auditing and Fixing Documentation Content with an AI Agent</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*axEZEnn2MROswWatKsxKnQ.jpeg" /></figure><p><em>Part 5 of 5 in the DoveRunner Agent Readiness series. If it’s your first time here, find the </em><a href="https://doverunner.com/blogs/agent-readiness-for-technical-documentation/"><em>first blog in the series here.</em></a></p><p><a href="https://doverunner.com/blogs/agent-readiness-infrastructure-fixes/">Part 4</a> covered the infrastructure layer of DoveRunner Docs. We added response headers, made the site serve Markdown to agents that ask for it, and declared Content Signals in robots.txt. Our score on <a href="http://isitagentready.com/">https://isitagentready.com</a> went from 43 to 86 out of 100, and our <a href="https://buildwithfern.com/agent-score">Fern Agent Score</a> from 0 to 99.</p><p>Through all of it, we never touched a word of the documentation itself.</p><p>This is why we treat Agent Readiness as two separate layers. On the infrastructure layer, a scanner tells you what passes, what fails, and what to fix. The content layer has no such tool. An agent being able to read your docs cleanly and an agent producing correct integration code from them are two different things.</p><p>This post covers what was actually wrong in the content layer of DoveRunner’s documentation, how we found and fixed it with an AI agent, what shipped to production, and where the work stopped short.</p><h3>Overview: How the Work Ran</h3><p>The project ran in six steps. The point of this post is where the agent’s half ends and ours begins, so here is the sequence first.</p><ol><li>The agent reads the Markdown sources, following integration workflows rather than individual pages.</li><li>It logs each problem it finds with a type, a description, and the location in the source.</li><li>It fixes what it can, edits the source files, and records the outcome next to each entry in the list.</li><li>We open one pull request per product line.</li><li>The product owner for each line reviews and confirms the changes to their product’s docs.</li><li>We deploy to production.</li></ol><h3>Finding Problems Along the Integration Journey</h3><p>Audit a doc site page by page, and you get page-level findings: typos, broken links, a parameter left undescribed. Those are worth fixing, but they’re rarely why an agent writes the wrong integration code.</p><p>So we used the end-to-end integration scenarios we had written for each product line from the customer’s point of view. A single journey a developer actually walks — from requesting a FairPlay certificate to packaging to confirming playback in an iOS player — became one unit, and the agent read every document that journey touches as a set.</p><p>Read this way, problems appear that no single page reveals. Each page is correct on its own, but information falls through the gap between them. The format one document hands off doesn’t match what the next one expects, or a prerequisite lives buried in the middle of another product’s guide instead of where it is needed.</p><p>The most dangerous finding in this audit was exactly that kind. When Forensic Watermarking is used together with Transcoding &amp; Packaging (T&amp;P), T&amp;P writes the watermarked output into a specific folder structure. When a viewer starts playback, the server needs to know where that output lives, and the session-issuing API takes it through the prefix_folder parameter. The session API doc described that parameter correctly. The T&amp;P doc was the problem: it said nothing about the folder structure it produces, or about the fact that the value has to be passed along at the next step.</p><p>Neither document is wrong on its own. But a developer or an agent working from the T&amp;P doc alone had no way to know a value needed passing at all. Omissions of this kind don’t surface as an error message. They surface as playback that doesn’t work, which makes them slow to diagnose. The fix was a caution block in the T&amp;P doc describing the folder structure and the parameter requirement, cross-linked to the session API section. It took minutes to write, and it was invisible until the two documents were read as one journey.</p><p>Across six product lines, this stage produced <strong>71 content issues</strong>. Each entry carried a type (error, gap, or placement), a description, and the source file and line it came from. That list became the baseline for everything that followed.</p><h3>The Agent Fixes, People Review</h3><p>With the list in place, we had the agent work through the entries it could handle. Because the docs are already managed as Markdown, editing the source needed no format conversion in between. After each fix, the agent wrote what it had checked and what it had changed into the remarks column of the list it had built. The issue list became the work log.</p><p>Here we made one deliberate choice. Rather than bundling 71 fixes into a single pull request, we split them by product line into our three primary products:</p><ul><li><strong>Multi-DRM</strong></li><li><strong>Watermarking / Anti-Piracy</strong></li><li><strong>Mobile App Security</strong></li></ul><p>Each pull request was assigned to that line’s product owner (PO) as reviewer. The reason is review quality. The only people who can judge whether a documentation fix is factually right are the people who know the product. A PO handed 71 mixed changes has to page through edits that have nothing to do with their product, and review in that situation tends to go through the motions. A pull request containing only their own product’s changes is short enough to read line by line.</p><p>All three POs confirmed that their documentation had been corrected as intended, and we deployed.</p><h3>Results, and the Nine That Remain</h3><p>Here is where the full review landed.</p><ul><li>Fixed: 59</li><li>No change needed: 3</li><li>Blocked by human decisions: 9</li><li>Total: 71</li></ul><p>That is <strong>83%</strong>. But the number that taught us more was the nine still open, because they had something in common. In every case, <strong>the answer was not in the documentation at all.</strong></p><p>An agent can read the entire corpus. So it is good at problems where the answer is somewhere in the docs but not where it needs to be: a detail explained on another page, a mismatch between what one document hands off and what the next assumes. The agent fixed 41 issues that way, and another 13 turned out to have been resolved already.</p><p>What an agent cannot do is produce a fact that exists nowhere in the corpus. Group the remaining nine by who has to weigh in, and the pattern is clear:</p><ul><li><strong>Needs the product teams</strong>: recommended API behavior and some response formats required for automated integration aren’t documented. Nearly half of the nine sit here.</li><li><strong>Needs platform team and business stakeholders</strong>: console labels, the supported scope of certain product types, and procedures entangled with contracts and legal review. All of them need confirmation from outside the docs before they can be written down.</li></ul><p>None of these is a writing problem. Before you can document a recommended polling interval, someone has to decide what it is. Before you can document a token expiry, someone has to confirm the value is contractual behavior. These are decisions that have to precede documentation, and a developer relations (DevRel) team cannot resolve them alone.</p><p>That distinction was the most useful thing this project produced. All 71 items looked like documentation issues of equal weight at the start. After a full review, 62 of them were solvable by editing documentation, and nine were never documentation problems at all. They were unsettled organizational decisions showing up in the docs.</p><h3>What the Agent Could Take On</h3><p>Looking back at the six steps, the agent handled steps one through three.</p><p>Reading, cataloging, and fixing share a shape. The volume is high, the criteria are reasonably clear, and a person can verify the result afterward. Cross-checking six product lines’ documentation along integration journeys is tedious work that people skip parts of. It suits an agent well.</p><p>Steps four through six stayed with us. How to split the pull requests, who should review them, and what to ship are judgments about organizational context. Step five in particular has no substitute: deciding whether any of the agent’s 71 edits got a fact wrong requires someone who actually knows the product.</p><p>When you bring AI into documentation work, that boundary is a reasonable place to set expectations.</p><h3>Closing</h3><p>That covers how we audited and fixed the content layer of DoveRunner’s documentation.</p><p>Five posts reduce to one idea: Agent Readiness isn’t a score; it is two different kinds of work. On the infrastructure layer, a tool names the problem and an AI agent can resolve it quickly. On the content layer, nothing names the problem for you, so you have to build the baseline yourself out of real integration journeys, and the last 10% or so of what you build can only be resolved by people.</p><p>If you work with DoveRunner’s documentation, everything described here is live at <a href="https://docs.doverunner.com/">DoveRunner Docs</a>. If something in the docs blocks you, tell us. As this project showed, the hardest problems to find come from the people who have actually walked the journey.</p><p><em>This series documents the ongoing work of defining and closing the gap between </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation </em></a><em>and what AI coding agents need from it.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=813d91e32daa" width="1" height="1" alt=""><hr><p><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-5-813d91e32daa">Agent Readiness for Technical Documentation — Part 5</a> was originally published in <a href="https://medium.com/pallycon">DoveRunner Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AI 에이전트가 읽는 기술 문서, 무엇이 달라야할까 — 4부]]></title>
            <link>https://danielkim-dev.medium.com/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-4%EB%B6%80-6e3518e70fde?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/6e3518e70fde</guid>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[content-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Wed, 26 Aug 2026 05:19:19 GMT</pubDate>
            <atom:updated>2026-08-26T05:19:19.856Z</atom:updated>
            <content:encoded><![CDATA[<h4>Level 1에서 Level 5까지: AI 에이전트 준비도(Agent Readiness) 점수를 끌어올린 인프라 계층 개선</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4S6KrjH6eRGwKItP8dAfZA.jpeg" /></figure><p>이 시리즈의 3편에서는 <a href="https://docs.doverunner.com/">DoveRunner Docs</a> 사이트를 두 가지 ‘에이전트 준비도’(Agent Readiness) 측정 도구로 점검한 결과를 정리했습니다. isitagentready.com에서는 100점 만점에 43점, Fern Agent Score에서는 0점이었습니다. 두 점수 모두 같은 근본 원인을 가리키고 있었는데, AI 에이전트가 이 문서를 최적으로 소비하기 위한 인프라가 아직 갖추어져 있지 않다는 점이었습니다.</p><p>이 글에서는 이 두 점수의 향상을 위해 적용한 개선 작업과, 그 개선의 결과가 무엇을 말해 주는지 알아보겠습니다.</p><h3>시작점: <a href="https://isitagentready.com/">isitagentready.com</a></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*lH-PdCn0JdIzqdjZ" /></figure><p>isitagentready.com은 DoveRunner Docs를 콘텐츠 사이트 기준으로 100점 만점에 <strong>43점, &#39;Level 1: Basic Web Presence&#39;</strong> 등급으로 평가했습니다. 적용 가능한 7개 항목 가운데 4개가 실패한 상태였습니다.</p><p>세 가지 개선 작업으로 네 개의 실패 항목 중 세 개를 해결했습니다. 나머지 하나인 DNS-AID는 의도적으로 건너뛴 항목입니다.</p><h4>개선 1: Link 응답 헤더</h4><p><strong>난이도: 낮음</strong></p><p>Link 헤더(RFC 8288)는 서버가 HTTP 응답에서 리소스 간의 관계를 선언할 수 있게 해 줍니다. 에이전트 준비도 관점에서 중요한 용도는 페이지의 Markdown 버전을 가리키는 것인데, 이 헤더를 읽은 에이전트는 각종 태그와 스크립트로 가득한 HTML을 파싱하는 대신 마크다운 버전을 통해 필요한 콘텐츠만을 가져올 수 있기 때문입니다.</p><p>기존에 DoveRunner Docs는 Link 헤더를 전혀 내보내지 않고 있었습니다. 해당 사이트의 배포 및 호스팅 플랫폼인 <a href="https://vercel.com/">Vercel</a>의 설정을 변경해 모든 페이지 응답에 헤더 하나를 추가했습니다.</p><p><strong>점수: 43 → 57</strong></p><h4>개선 2: Markdown 콘텐츠 협상</h4><p><strong>난이도: 중간</strong></p><p>이 작업은 사이트를 제공하는 방식만이 아니라 빌드하는 방식까지 바꿔야 했기 때문에 가장 손이 많이 가는 개선이었습니다.</p><p>요구 사항은 이렇습니다. 에이전트가 요청에 Accept: text/markdown을 담아 보내면, 서버는 페이지를 HTML이 아닌 순수 Markdown으로 반환해야 합니다. HTML에는 내비게이션 요소, 사이드바, 레이아웃 마크업이 들어 있어 에이전트가 문서를 읽으려 할 때 잡음이 됩니다. 반면 Markdown은 에이전트가 깔끔하게 다룰 수 있는 형식입니다.</p><p>DoveRunner Docs는 정적으로 빌드되는 사이트입니다. 원본 콘텐츠는 Markdown으로 작성되지만 모든 HTTP 응답은 HTML로 나갑니다. 이를 해결하기 위해 빌드 시점에 모든 페이지의 Markdown 버전을 미리 생성하고, Accept 헤더가 일치할 때 CDN이 해당 파일을 투명하게 제공하도록 설정했습니다. 문서 콘텐츠 자체나 원본 파일은 전혀 건드리지 않았고, 전달 계층만 손봤습니다.</p><p>그 결과 Accept: text/markdown을 보내는 에이전트는 이제 깨끗한 Markdown을 받고, HTML을 요청하는 브라우저는 그대로 HTML을 받습니다. 같은 URL이 두 경우를 모두 처리합니다.</p><p><strong>점수: 57 → 71</strong></p><h4>DNS-AID에 대한 판단</h4><p><strong>항목: Discoverability / DNS-AID</strong> <strong>판단: 건너뜀 (적용 대상 아님)</strong></p><p>DNS-AID는 에이전트가 스스로를 에이전트 디렉터리에 등록하기 위한 명세입니다. 다른 에이전트나 오케스트레이터에 의해 발견되어야 하는 소프트웨어, 즉 에이전트를 위해 설계된 규격입니다.</p><p>DoveRunner Docs는 에이전트가 소비할 수 있도록 준비되는 문서 사이트이지, 스스로를 등록하는 에이전트가 아닙니다. 따라서 이 항목은 적용되지 않습니다.</p><p>같은 점검을 돌리는 다른 팀이라면 짚어 둘 만한 구분입니다. 에이전트 준비도 도구의 모든 항목이 측정 대상을 콘텐츠 사이트로 가정하는 것은 아니며, 어떤 항목은 대상 자체가 에이전트라고 가정합니다. 실패 항목을 개선 우선순위로 올리기 전에 항목 설명을 먼저 읽어 보면 불필요한 노력을 줄일 수 있습니다.</p><h4>개선 3: Content Signals</h4><p><strong>난이도: 낮음 (</strong>robots.txt<strong>에 한 줄)</strong></p><p>Content Signals는 사이트가 AI 활용에 대한 선호를 robots.txt 파일에 직접 선언할 수 있게 해 주는 표준입니다. 여기서는 세 가지 선호가 중요합니다.</p><ul><li>ai-train: 이 콘텐츠를 AI 모델 학습에 사용해도 되는가?</li><li>search: 검색 엔진이 색인해도 되는가?</li><li>ai-input: AI 에이전트가 이를 컨텍스트로 사용해도 되는가?</li></ul><p>DoveRunner Docs에서는 각 선택이 모두 의도된 것입니다.</p><ul><li>ai-train=no: DoveRunner의 문서에는 독자적인 연동 패턴과 플랫폼별 구현 세부 사항이 담겨 있습니다. 이를 AI 모델 학습에 사용하면 경쟁사에 이로울 수 있습니다. 이 문서는 DoveRunner 제품을 다루는 개발자를 돕기 위한 것이지, 외부의 학습용 말뭉치로 쓰이기 위한 것이 아닙니다.</li><li>search=yes: 공개된 개발자 문서는 색인되는 것이 맞습니다. 이를 제한할 이유가 없습니다.</li><li>ai-input=yes: 이것이야말로 에이전트 준비도 프로젝트 전체의 목적입니다. 이 문서는 AI 코딩 에이전트가 개발자의 연동을 도울 때 컨텍스트로 활용할 수 있도록 최적화되고 있습니다. 이를 막는다면 프로젝트의 목표와 모순됩니다.</li></ul><p>Content Signals의 실질적 가치는 바로 이 구분에 있습니다. ai-train=no, ai-input=yes라는 조합입니다. Disallow: GPTBot 식의 전면 차단은 정작 도우려던 에이전트에게 문서를 보이지 않게 만듭니다. 반면 Content Signals를 쓰면 더 정밀하게 의사를 밝힐 수 있습니다. 우리 문서를 개발자를 돕는 데에는 쓰되, 모델 학습에는 쓰지 말라는 것입니다.</p><p><strong>점수: 71 → 86</strong></p><h4>결과</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*IWvweWZorypePAbG" /></figure><p><strong>최종 점수: 86/100, Level 5: Agent-Native</strong></p><p>세 가지 개선 작업을 적용하는 동안 문서 콘텐츠는 전혀 손대지 않았습니다. 43점에서 86점으로의 향상은 전적으로 인프라에서 나왔습니다. 사이트를 어떻게 제공하는지, 어떤 헤더를 내보내는지, 자신의 AI 활용 선호를 어떻게 선언하는지가 그것입니다.</p><p>이것이 에이전트 준비도 프레임워크에서 인프라와 콘텐츠를 분리하는 이유입니다. 두 문제는 서로 다른 개선 방식을 요구하며 서로 다른 시간 축으로 움직입니다. 인프라 격차는 며칠이면 좁힐 수 있지만, 콘텐츠 격차는 문서 전체에 걸쳐 실제 연동 여정을 따라가며 점검해야 하는 작업으로 4편에서 다룬 내용입니다.</p><p>2편에서 소개한 3단계 성숙도 모델에 대응시키면 다음과 같습니다.</p><ul><li><strong>Stage 1 (Discoverability): 대체로 완료.</strong> robots.txt, sitemap, Link 헤더가 모두 통과합니다. 한 가지 의미 있는 공백이 남는데, AI 에이전트를 위한 기계 판독용 사이트 색인인 llms.txt입니다. 이는 isitagentready.com이 아니라 Fern Agent Score의 점검 항목으로, 다음 절에서 다룹니다.</li><li><strong>Stage 2 (Governance): 완료.</strong> Markdown 제공, Content Signals, AI 봇 규칙이 모두 통과합니다.</li><li><strong>Stage 3 (Controlled Interaction): 관련 없음.</strong> API Catalog, MCP Server Card, OAuth Discovery는 문서 위주의 콘텐츠 웹사이트에는 불필요한 항목들입니다.</li></ul><h3>두 번째 스캐너: <a href="https://buildwithfern.com/agent-score">Fern Agent Score</a></h3><p>두 번째 도구인 Fern Agent Score는 조금 다른 계층을 측정합니다. 사이트가 AI 에이전트를 위해 모든 페이지를 나열한 색인 파일 하나를 제공하는지, 그리고 그 페이지들을 깨끗한 텍스트 버전으로 제공하는지입니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*d5uHZAmrTl4Qaqw6" /></figure><p>이 도구는 처음에 DoveRunner Docs에 100점 만점에 0점을 매겼습니다. 점수만 보면 충격적이지만 원인은 단순했습니다. 에이전트를 위한 색인 파일이 사이트에 없었던 것입니다. 색인이 없으니 스캐너는 살펴볼 페이지를 단 하나밖에 찾지 못했고, 그 결과 거의 모든 항목이 빈칸으로 돌아오면서 점수가 0점까지 떨어졌습니다. 에이전트에게 깨끗한 콘텐츠를 제공하는 실제 기반은 이미 마련되어 있었습니다(앞의 개선 2번이 그 작업입니다). 단지 그 기반이 존재한다는 사실을 에이전트에게 알려 주는 색인을 한 번도 게시하지 않았을 뿐입니다.</p><h4>파일 하나, 그리고 하나의 선택</h4><p>DoveRunner Docs 와 같은 정적 문서 사이트에 이 색인 파일을 추가하는 일반적인 방법은 이미 만들어진 플러그인을 쓰는 것입니다. 이를 시도해 봤지만 결국 제거했습니다. 다섯 가지 기능이 묶여 있었으나 우리에게 필요한 것은 하나뿐이었고, 이미 쓰고 있던 도구와 버전 충돌까지 일으켰기 때문입니다. 대신 코드베이스에 이미 있던 패턴을 본떠 작은 코드 한 조각을 직접 작성했습니다. 이 코드는 사이트를 빌드할 때마다 색인을 자동으로 다시 생성하기 때문에, 추가 의존성이 없고 색인이 페이지와 어긋날 일도 없습니다.</p><p>기능 다섯 개가 묶인 플러그인은, 그중 하나만 필요하고 나머지 넷은 이미 갖추고 있을 때 좋지 않은 선택입니다.</p><h4>0점에서 99점으로</h4><p>색인을 게시하자 점수는 곧바로 0점에서 91점으로 뛰었습니다. 마지막 몇 점은 사이트를 실제로 배포한 뒤에야 드러난 두 가지 버그에서 나왔는데, 둘 다 같은 교훈을 남겼습니다. 에이전트가 점검하는 방식 그대로 점검해야 한다는 것입니다.</p><ul><li>첫 번째는 에이전트용 안내 표시를 스캐너가 읽지 않는 영역에 둔 것이 문제였습니다. 스캐너가 실제로 들여다보는 위치로 옮기자 해결되었습니다.</li><li>두 번째는 더 미묘했습니다. 우리가 직접 한 테스트는 모두 통과했는데, 끝에 슬래시가 붙은 주소로 점검했기 때문입니다. 스캐너는 슬래시 없는 주소로 점검했고, 그런 주소에서는 서버가 조용히 잘못된 형식을 반환하고 있었습니다. 스캐너가 보낸 요청을 그대로 재현하자 버그는 몇 초 만에 드러났습니다.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*75AL5KSpGyDeyfMA" /></figure><p>최종 Fern Agent Score는 <strong>100점 만점에 99점</strong>입니다. 남은 1점은 인프라가 아니라 콘텐츠 문제로, 분할이 필요한 지나치게 큰 페이지 몇 개 때문이며 이 부분은 의도적으로 그대로 두었습니다. 이 작업 전체에 든 비용은 새 코드 한 조각, 작은 템플릿 수정 한 건, 설정 몇 줄, 그리고 추가 의존성 0개였습니다.</p><p>어떤 점검 결과가 직접 해 본 테스트와 어긋난다면, 그 도구가 틀렸다고 단정하기 전에 도구가 하는 동작을 그대로 재현해 보시기 바랍니다.</p><h3>마치며</h3><p>이제 두 스캐너 모두 대응을 마쳤습니다. 첫 번째는 86점, 두 번째는 99점입니다. 여기까지가 인프라 계층, 즉 에이전트가 문서를 발견하고 소비할 수 있는지에 대한 영역입니다. 다만 이 점수들은 더 어려운 질문, 즉 에이전트가 그 문서로부터 올바른 연동 코드를 만들어 낼 수 있는지에 대해서는 아무것도 말해 주지 않습니다.</p><p>마지막 다섯 번째 파트에서는 이 콘텐츠 계층의 문제를 찾아내고 해결한 과정을 다루겠습니다.</p><p><em>이 시리즈는 </em><a href="https://docs.doverunner.com/"><em>DoveRunner의 개발자 문서</em></a><em>와 AI 코딩 에이전트가 필요로 하는 것 사이의 격차를 정의하고 좁혀 나가는 체계적인 작업을 기록합니다.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6e3518e70fde" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Agent Readiness for Technical Documentation — Part 4]]></title>
            <link>https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-4-8daee46cc5a0?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/8daee46cc5a0</guid>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[content-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Wed, 26 Aug 2026 05:19:02 GMT</pubDate>
            <atom:updated>2026-08-26T05:19:02.987Z</atom:updated>
            <content:encoded><![CDATA[<h4>Improving Documentation for Agents with Infrastructure Fixes: From Level 1 to Level 5</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4S6KrjH6eRGwKItP8dAfZA.jpeg" /></figure><p>Part 3 of this series documented two agent-readiness scan results against <a href="https://docs.doverunner.com/">DoveRunner Docs</a>, our developer documentation site: 43/100 on isitagentready.com and 0/100 on Fern Agent Score. Both pointed to the same root problem: the infrastructure for agents to consume this documentation optimally was not in place.</p><p>This post covers the fixes we applied to the infrastructure layer.</p><h3>The Starting Point: <a href="https://isitagentready.com/">isitagentready.com</a></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*hYiuzPvxt57hGVTY" /></figure><p>isitagentready.com scored DoveRunner Docs at <strong>43/100 — Level 1: Basic Web Presence</strong> on a content-site profile. Of seven applicable checks, four were failing.</p><p>Three fixes addressed three of the four failures. The fourth, DNS-AID, was a deliberate skip.</p><h4>Fix 1: Link Response Headers</h4><p><strong>Effort:</strong> Low</p><p>Link headers (RFC 8288) let a server declare relationships between resources in the HTTP response. For agent readiness, the relevant use is pointing to the Markdown version of a page: an agent that reads the header knows where to find clean content without parsing HTML first.</p><p>DoveRunner Docs was not emitting any Link headers. We solved this with a simple configuration change in <a href="https://vercel.com/">Vercel</a>, the cloud platform hosting the website.</p><p><strong>Score: 43 → 57</strong></p><h4>Fix 2: Markdown Content Negotiation</h4><p><strong>Effort:</strong> Medium</p><p>This was the most involved fix because it required changing how the site is built, not just how it is served.</p><p>The requirement: when an agent sends Accept: text/markdown in its request, the server returns the page as plain Markdown instead of HTML. HTML contains navigation elements, sidebars, and layout markup that add noise when an agent is trying to read documentation. Markdown is what agents work with cleanly.</p><p>DoveRunner Docs is a statically built site. The source content is written in Markdown, but every HTTP response is HTML. The fix required pre-generating a Markdown version of every page at build time and configuring the CDN to serve those files transparently when the Accept header matches. We didn’t change anything in the documentation content itself nor the source files. Only the delivery layer.</p><p>The result: agents sending Accept: text/markdown now receive clean Markdown. Browsers requesting HTML still get HTML. The same URL handles both.</p><p><strong>Score: 57 → 71</strong></p><h4>The DNS-AID Decision</h4><p><strong>Check:</strong> Discoverability / DNS-AID <strong>Decision:</strong> Skipped, not applicable</p><p>DNS-AID is a specification for an agent to register itself in an agents directory. It is designed for agents that need to be discovered by other agents or orchestrators.</p><p>DoveRunner Docs is a documentation site being made ready for agents to consume. It is not an agent registering itself. The check does not apply.</p><p>This distinction is worth flagging for any team running the same scan. Not every check in an agent-readiness tool assumes the target is a content site. Some assume the target is itself an agent. Reading the check description before treating a failure as a fix priority saves effort.</p><h4>Fix 3: Content Signals</h4><p><strong>Effort:</strong> Low, one line in robots.txt</p><p>Content Signals is a standard that lets a site declare its AI usage preferences directly in robots.txt. Three preferences matter here:</p><ul><li>ai-train: can this content be used to train AI models?</li><li>search: can search engines index it?</li><li>ai-input: can AI agents use it as context?</li></ul><p>For DoveRunner Docs, each choice is intentional.</p><ul><li>ai-train=no: DoveRunner&#39;s documentation contains proprietary integration patterns and platform-specific implementation details. Using it to train AI models could benefit competitors. The documentation should help developers who work with DoveRunner&#39;s products, not serve as a training corpus for anyone else.</li><li>search=yes: Public developer documentation should be indexed. No reason to restrict this.</li><li>ai-input=yes: This is the purpose of the entire agent-readiness project. The documentation is being optimized so AI coding agents can use it as context when helping developers integrate. Blocking this would contradict the goal.</li></ul><p>The practical value of Content Signals is this distinction: ai-train=no, ai-input=yes. A blanket Disallow: GPTBot block makes documentation invisible to the agents it was meant to help. Content Signals let a site say something more precise: use our docs to assist developers; do not use them to train your model.</p><p><strong>Score: 71 → 86</strong></p><h4>The Result</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*4T2ZY1s8t8s2Vpd1" /></figure><p><strong>Final score: 86/100 — Level 5: Agent-Native</strong></p><p>Three fixes. No documentation content was touched. The improvement from 43 to 86 came entirely from infrastructure: how the site is served, what headers it emits, and what it declares about its own AI usage preferences.</p><p>That is the point of separating infrastructure from content in the agent readiness framework. The two problems require different remediation approaches and move on different timescales. Infrastructure gaps close in days. Content gaps require tracing actual integration journeys through the documentation which will covered in the next part.</p><p>Mapped to the three-stage maturity model from Part 2:</p><ul><li><strong>Stage 1 (Discoverability):</strong> Substantially complete. robots.txt, sitemap, and Link headers all pass. One meaningful gap remains: llms.txt, the machine-readable site index for AI agents. That is a Fern Agent Score check, not an isitagentready.com check — addressed in the next section.</li><li><strong>Stage 2 (Governance):</strong> Complete. Markdown delivery, Content Signals, and AI bot rules all pass.</li><li><strong>Stage 3 (Controlled Interaction):</strong> Not applicable. API Catalog, MCP Server Card, and OAuth Discovery are not necessary to document-based content websites.</li></ul><h3>The Second Scanner: Fern Agent Score</h3><p>The second tool, Fern Agent Score, measures a different layer. It looks at whether the site publishes a single index file that lists every page for AI agents, and whether it serves clean text versions of those pages.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*lEGgMwgxJv3rEuZk" /></figure><p>That tool scored DoveRunner Docs at <strong>0 out of 100</strong> at the start. The number looked alarming, but the cause was simple: the site had no llms.txt, or index file for agents. Without one, the scanner could only find a single page to look at, so almost every category came back blank and the score collapsed to zero. The machinery for serving clean content to agents was already built (that was Fix 2 above). The site had simply never published the index that tells agents it exists.</p><h4>One file, one decision</h4><p>The popular way to add llms.txt to a static documentation site like ours is a ready-made plugin. We tried it and removed it. It bundled five features when we needed one, and it brought version conflicts with tools we already used. Instead, we wrote a small piece of code, modeled on patterns already in our codebase, that regenerates the index automatically every time the site builds. No extra dependencies, and the index can never fall out of date with the pages.</p><p><strong>A plugin that bundles five features is a bad trade when you need one and already own the other four.</strong></p><h4>From 0 to 99</h4><p>Publishing llms.txt jumped the score from 0 to 91 immediately. The last few points came from two bugs that only showed up once the site was live. Both taught the same lesson: test the way the agent tests.</p><ul><li>The first attempt put the agent-facing pointer in a part of the page the scanner doesn’t read. Moving it to where the scanner actually looks fixed the problem.</li><li>The second was subtler. Our manual tests all passed because we tested page addresses with a trailing slash. The scanner tested them without one. And on those, the server quietly returned the wrong format. Reproducing the scanner’s exact request made the bug obvious in seconds.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/0*2F5Ll3RvVyN9_NTp" /></figure><p>The final Fern Agent Score: <strong>99/100.</strong> The single remaining point is a content problem, a couple of oversized pages that should be split, so we stopped there on purpose. The whole effort cost one new piece of code, one small template change, a handful of config lines, and zero new dependencies.</p><p><strong>When a check disagrees with your own testing, reproduce exactly what the checker does before assuming it is wrong.</strong></p><h3>What’s Next</h3><p>Both scanners are now addressed. 86 on the first, 99 on the second. That covers the infrastructure layer: whether agents can find and consume the documentation. It says nothing about the harder question, whether agents can generate correct integration code from it.</p><p>In the final post (Part 5), I will show you how AI agents help identify and fix issues in the content layer of documents.</p><p><em>This series documents a systematic effort to define and close the gaps between </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation</em></a><em> and what AI coding agents need.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8daee46cc5a0" width="1" height="1" alt=""><hr><p><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-4-8daee46cc5a0">Agent Readiness for Technical Documentation — Part 4</a> was originally published in <a href="https://medium.com/pallycon">DoveRunner Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AI 에이전트가 읽는 기술 문서, 무엇이 달라야할까 — 3부]]></title>
            <link>https://danielkim-dev.medium.com/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-3%EB%B6%80-85dd7a248bb0?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/85dd7a248bb0</guid>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[application-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Mon, 24 Aug 2026 09:40:43 GMT</pubDate>
            <atom:updated>2026-08-24T09:40:43.444Z</atom:updated>
            <content:encoded><![CDATA[<h4>AI 에이전트 문서 스캔 점수, 어떻게 해석해야 할까 — 인프라 준비도 점수가 실제로 의미하는 것</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CYJVXOpHCT4LCQ7YkcqK6A.jpeg" /></figure><blockquote>이 글은 <a href="https://docs.doverunner.com/">DoveRunner 개발자 문서</a>에 체계적인 에이전트 준비 상태 평가를 적용하여 AI 코딩 에이전트가 올바른 통합 코드를 생성할 수 있는지, 아니면 오류 구현을 조용히 생성하는지 평가하는 시리즈의 세 번째 글입니다. 첫 번째 글과 두 번째 글은 여기에서 확인할 수 있습니다.</blockquote><p>2026년 4월, Cloudflare는 <a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> 사이트를 공개했습니다. 웹사이트가 AI 에이전트에게 얼마나 잘 발견되고 이용될 수 있는지를 평가하는 도구입니다. 이 도구에 DoveRunner의 개발자 문서 사이트인 <a href="https://docs.doverunner.com/">DoveRunner Docs</a>를 스캔했습니다. 이 문서 사이트는 콘텐츠 보안 제품군(Multi-DRM, 포렌식 워터마킹 등)과 모바일 앱 보안을 다루고 있습니다.</p><p>DoveRunner Docs는 API 서버나 트랜잭션 웹 앱이 아니라 개발자 문서 사이트이므로, 콘텐츠 사이트 프로파일로 스캔을 실행했습니다. 이 모드는 콘텐츠 사이트에 해당하는 검사 항목만 평가하고 API/Auth/MCP와 Commerce 카테고리는 제외합니다(상세 내용은 아래 참조).</p><p>결과: <strong>43/100. Level 1: Basic Web Presence.</strong></p><p>이 글에서는 해당 스캔 결과를 카테고리별로 분석하고, 이 점수가 실제로 무엇을 의미하는지 설명하며, 두 스캔 도구 모두가 측정하지 않는 것이 무엇인지 알아보겠습니다.</p><h3><a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> 도구가 측정하는 것</h3><p>이 웹사이트 스캔 툴은 다섯 개 카테고리에 걸쳐 19개 항목을 검사합니다. 콘텐츠 사이트는 그중 해당하는 세 카테고리(Discoverability, Content, Bot Access Control)로 채점되며, 활성화되는 검사 항목은 총 7개입니다.</p><ul><li><strong>Discoverability(발견 가능성):</strong> 에이전트가 사이트를 찾고 진입점을 파악할 수 있는가를 확인합니다. 검사 항목: robots.txt, 사이트맵, Link 헤더(RFC 8288), DNS-AID(에이전트 전용 DNS 레코드 표준)</li><li><strong>Content(콘텐츠):</strong> 에이전트가 HTML을 파싱하지 않고 콘텐츠를 소비할 수 있는가를 확인합니다. 검사 항목: Markdown 콘텐츠 협상(Accept: text/markdown 응답)</li><li><strong>Bot Access Control(봇 접근 제어):</strong> 사이트가 AI 봇에 대한 정책을 선언하고 있는가를 확인합니다. 검사 항목: 크롤러별 robots.txt 규칙, Content Signals(AI 학습/입력 선언), Web Bot Auth(봇 요청 서명 검증)</li><li><strong>API, Auth, MCP &amp; Skill Discovery:</strong> 에이전트가 API 구조와 인증 흐름을 자율적으로 파악할 수 있는가를 확인합니다. 검사 항목: API Catalog(RFC 9727), OAuth/OIDC Discovery, MCP Server Card, Agent Skills Index, WebMCP</li><li><strong>Commerce(결제):</strong> 에이전트가 소액 결제 표준(x402, MPP 등)을 처리할 수 있는가를 확인합니다. 이커머스 사이트에 해당하는 항목입니다.</li></ul><p>요약하면, 이 도구는 <strong>웹사이트의 에이전트 준비도 기술 인프라</strong>를 측정합니다. 콘텐츠 품질은 검사하지 않습니다.</p><h3>43/100: 세부 내용</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*1NYyFOn_t12oYrw0" /></figure><p>Cloudflare Is Your Site Agent-Ready? 도구로 DoveRunner Docs를 스캔한 결과 화면입니다. AI 에이전트 문서 스캔 점수 43/100과 Discoverability, Content, Bot Access Control 등 인프라 항목별 결과를 보여줍니다.</p><p>콘텐츠 사이트 프로파일은 도구의 19개 검사 중 7개(아래 세 카테고리)를 활성화하고, <strong>API, Auth, MCP &amp; Skill Discovery</strong>와 <strong>Commerce</strong> 카테고리는 제외합니다. 이들 카테고리의 검사 항목(OAuth Discovery, MCP Server Card, 소액 결제 표준 등)은 콘텐츠 사이트가 아니라 API 서버와 트랜잭션 애플리케이션이 대상이기 때문입니다. 점수는 해당하는 7개 검사 항목을 반영합니다.</p><h4>Discoverability — 4개 중 2개 통과, 카테고리 점수 50</h4><p>DNS-AID는 에이전트가 DNS 수준에서 MCP 서버와 A2A(agent-to-agent) 엔드포인트를 발견할 수 있게 해줍니다. DNSSEC(DNS Security Extensions)가 필요하며 아직 초기 도입 단계에 있습니다. 당장의 우선순위는 아니지만, 이 표준이 존재한다는 사실은 알아두는 것이 좋습니다.</p><h4>Content — 1개 중 0개 통과, 카테고리 점수 0</h4><p>DoveRunner Docs 사이트는 Astro + Starlight 기반으로 구축되었습니다. 소스 콘텐츠는 전부 Markdown으로 작성되어 있지만, HTTP 응답은 항상 HTML입니다. Accept: text/markdown을 요청한 에이전트는 HTML을 받습니다. Markdown을 직접 소비하려면 에이전트가 HTML을 파싱하거나 소스 파일을 별도로 가져와야 합니다. 이 카테고리에는 검사 항목이 하나뿐이므로 결과는 0점입니다.</p><h4>Bot Access Control — 2개 중 1개 조건부 통과, 카테고리 점수 50</h4><p>AI 봇 통과는 조건부입니다. User-agent: * / Allow: /는 모든 크롤러를 허용하지만, AI 크롤링에 대해서는 아무것도 명시하지 않습니다. AI 학습, 검색 색인, 프롬프트 입력 허용 여부를 robots.txt에 직접 선언하는 표준인 Content Signals는 없습니다. 한 줄 추가로 해결할 수 있는 항목입니다.</p><blockquote>이 카테고리의 세 번째 검사 항목인 Web Bot Auth(/.well-known/http-message-signatures-directory로 봇 요청 서명을 검증)는 콘텐츠 사이트 프로파일에서 제외됩니다. DoveRunner Docs의 문서는 읽는 데 인증이 필요 없으므로 에이전트가 서명해 인증할 대상 자체가 없기 때문입니다. 따라서 여기서 채점되는 항목은 3개가 아니라 2개입니다.</blockquote><h4>채점 제외: API, Auth, MCP &amp; Skill Discovery와 Commerce</h4><p>콘텐츠 사이트 프로파일은 두 카테고리를 채점에서 제외합니다. <strong>API, Auth, MCP &amp; Skill Discovery</strong>(API Catalog(RFC 9727), OAuth/OIDC Discovery, OAuth Protected Resource Metadata, Auth.md agent registration, MCP Server Card, Agent Skills Index, WebMCP)는 에이전트가 사이트의 API 구조와 인증 흐름을 자율적으로 파악할 수 있는지를 평가합니다. <strong>Commerce</strong>(x402, MPP 같은 소액 결제 표준)는 에이전트 주도 결제를 평가합니다. 둘 다 문서 사이트를 설명하는 항목이 아니므로 도구가 점수에서 제외합니다.</p><p>다만 DoveRunner와 무관한 것은 아닙니다. 이들은 <em>향후</em> MCP 서버와 직접 연결됩니다. MCP 서버가 구축되면 MCP Server Card를 게시하는 것이 에이전트 오케스트레이터가 서버를 발견하고 연결하는 방법이 되고, API Catalog는 에이전트가 어떤 API가 존재하는지 찾는 방법이 됩니다.</p><h3>이 점수의 의미</h3><p>43/100은 여전히 Level 1에 머무는 점수이지만, 에이전트가 DoveRunner Docs를 이용할 수 없다는 의미는 아닙니다. Claude와 Codex는 지금 상태로도 HTML을 파싱해 URL에서 콘텐츠를 추출할 수 있습니다.</p><p><strong>에이전트가 이 사이트를 최적으로 소비하기 위한 인프라가 갖춰져 있지 않다는 의미입니다.</strong> Markdown 콘텐츠 협상 없이는 에이전트가 레이아웃 노이즈를 통과해 작업해야 합니다. API Catalog 없이는 에이전트가 어떤 API가 존재하는지 자율적으로 파악할 수 없습니다. MCP Server Card 없이는 에이전트 오케스트레이터가 향후 MCP 서버가 제공하는 것을 선언적으로 파악할 수 없습니다.</p><p>2편에서 소개한 3단계 성숙도 모델에 매핑하면 다음과 같습니다.</p><ul><li><strong>Stage 1 — 발견 가능성: 부분 달성.</strong> robots.txt와 사이트맵은 통과했습니다. Link 헤더와 llms.txt는 없습니다. llms.txt 파일은 즉시 적용할 수 있는 가장 효과가 높은 개선 조치입니다. public/ 디렉토리에 정적 파일 하나를 추가하면 이 검사를 통과할 수 있으며, Fern Agent Score의 콘텐츠 발견 가능성 실패 세 항목도 동시에 해결됩니다.</li><li><strong>Stage 2 — 거버넌스: 미달성.</strong> Markdown 콘텐츠 협상, Content-Signal, 크롤러별 AI 규칙 모두 없습니다. Content-Signal과 크롤러 규칙은 robots.txt 편집만으로 해결됩니다. Markdown 제공은 Astro/Starlight 설정 작업이 필요하지만, 한 번 완료되면 에이전트가 HTML 파싱 노이즈 없이 구조화된 Markdown을 직접 소비할 수 있게 됩니다.</li><li><strong>Stage 3 — 제어된 상호작용: 미시작.</strong> API Catalog, MCP Server Card, OAuth Discovery 모두 없습니다. 이 항목들은 콘텐츠 사이트 스캔이 채점하지 않는 카테고리에 속하지만, 더 넓은 성숙도 관점에서는 여전히 중요합니다. MCP 서버와 함께 개발해야 할 중장기적인 아키텍처 작업입니다.</li></ul><h3>두 번째 스캔: 보완적 관점</h3><p>12일 후, 같은 사이트에 Fern의 <a href="https://buildwithfern.com/agent-score">Agent Score</a>를 실행했습니다.</p><p>결과: <strong>0/100. Grade F. </strong>해당 스캔 툴에서 가장 중요시하는 다섯 개 검사 항목 모두 실패했습니다.</p><p>두 스캔은 서로 다른 계층을 측정합니다.</p><ul><li><strong>Is Your Site Agent-Ready?</strong> (43/100) : 에이전트가 이 사이트를 찾고 콘텐츠를 잘 읽을 수 있는가?</li><li><strong>Fern Agent Score</strong> (0/100) : 에이전트가 이 콘텐츠를 기계 친화적인 형식으로 읽을 수 있는가?</li></ul><p><a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a>는 “진입 및 탐색” 경로를 검사합니다. 봇 접근 권한, API 카탈로그, MCP 서버 카드, OAuth Discovery가 그 대상입니다. Fern <a href="https://buildwithfern.com/agent-score">Agent Score</a>는 크게 두 가지 영역을 확인합니다. 에이전트가 사이트에 어떤 페이지가 있는지 파악하기 위해 사용하는 표준 진입점인 <strong>llms.txt</strong> 파일의 존재 여부, 그리고 사이트가 HTML 대신 <strong>Markdown</strong>으로 콘텐츠를 제공할 수 있는지 여부입니다.</p><p>두 스캔 사이에 겹치는 실패가 하나 있습니다. Markdown 콘텐츠 협상입니다. Is Your Site Agent-Ready?의 Content 카테고리 실패와 Fern Agent Score의 Markdown 제공 실패는 같은 근본 원인을 가리킵니다.</p><p>0/100은 43/100과 같은 방식으로 읽어야 합니다. “에이전트가 이 문서를 읽을 수 없다”는 의미가 아니라, “에이전트가 레이아웃 노이즈 없이, 자율적으로, 대규모로 이 사이트를 소비하기 위한 표준화된 인프라가 갖춰져 있지 않다”는 의미입니다. 두 점수를 함께 보면 그 인프라 공백의 전체 윤곽이 드러납니다.</p><h3>마치며</h3><p>두 스캔에서 도출된 인프라 체크리스트는 명확하고 실행 가능합니다. 하지만 에이전트가 올바른 통합 코드를 생성할 수 있게 하려면 콘텐츠 계층을 별도로 평가해야 합니다.</p><p>다음 편에서는 그 작업을 다루겠습니다. Claude를 활용해 DoveRunner 문서에서 23개의 엔드투엔드 통합 시나리오를 도출하고, 각 시나리오가 드러낸 에이전트 실패 지점을 직접 분석한 내용입니다. 이 결과는 스캔 도구가 아닌, 문서를 통해 실제 통합 여정을 직접 따라가는 방식으로 얻어졌습니다.</p><p><em>이 시리즈는 </em><a href="https://docs.doverunner.com/"><em>DoveRunner의 개발자 문서</em></a><em>와 AI 코딩 에이전트가 필요로 하는 것 사이의 간극을 체계적으로 정의하고 좁혀나가는 과정을 기록합니다.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=85dd7a248bb0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Agent Readiness for Technical Documentation — Part 3]]></title>
            <link>https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-3-725e818d97b0?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/725e818d97b0</guid>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[content-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Mon, 24 Aug 2026 09:40:22 GMT</pubDate>
            <atom:updated>2026-08-24T09:40:22.867Z</atom:updated>
            <content:encoded><![CDATA[<h4>Two Agent-Readiness Scans: What Our Infrastructure Scores Actually Mean</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CYJVXOpHCT4LCQ7YkcqK6A.jpeg" /></figure><blockquote><em>This is the third post in a series applying a systematic Agent Readiness Assessment to DoveRunner’s developer documentation, evaluating whether AI coding agents can generate correct integration code, or silently produce broken implementations. Here’s post one and post two.</em></blockquote><p>In April 2026, Cloudflare launched “<a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a>” a tool that evaluates how well a website can be discovered and consumed by AI agents. We scanned <a href="https://docs.doverunner.com/">DoveRunner Docs</a>, DoveRunner’s developer documentation site covering both its Content Security and Mobile App Security product lines.</p><p>Because DoveRunner Docs is a developer documentation site rather than an API server or transactional web app, we ran the scan in its content-site profile — the mode that evaluates the checks relevant to content sites and sets aside the API/Auth/MCP and Commerce categories, which are designed for API servers and transactional applications rather than documentation sites.</p><p>Result: <strong>43/100. Level 1: Basic Web Presence.</strong></p><p>This post breaks down the scan results by category, explains what that score actually means, and identifies what neither scan tool measures.</p><h3>What “Is Your Site Agent Ready?” Measures</h3><p>The scanning site runs 19 checks across five categories. A content site is scored against the three that apply to it — Discoverability, Content, and Bot Access Control — for seven enabled checks in total.</p><ul><li><strong>Discoverability</strong>: Can an agent find the site and locate entry points? Checks: robots.txt, sitemap, Link headers (RFC 8288), DNS-AID (an agent-specific DNS record standard).</li><li><strong>Content</strong>: Can an agent consume content without parsing HTML? Check: Markdown content negotiation (Accept: text/markdown response).</li><li><strong>Bot Access Control</strong>: Does the site declare its intent toward AI bots? Checks: Per-crawler robots.txt rules, Content Signals (AI training/input declarations), Web Bot Auth (bot request signature verification).</li><li><strong>API, Auth, MCP &amp; Skill Discovery</strong>: Can an agent autonomously identify the API structure and authentication flows? Checks: API Catalog (RFC 9727), OAuth/OIDC Discovery, MCP Server Card, Agent Skills Index, WebMCP.</li><li><strong>Commerce</strong>: Can an agent handle payments using micropayment standards (x402, MPP, etc.)? Not applicable to a developer documentation site.</li></ul><p>In short: the tool measures <strong>the technical infrastructure of a site’s agent readiness</strong>. It does not examine content quality.</p><h3>43/100: The Detail</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*O3Z6tw8tX8H4hBxf" /></figure><p>The content-site profile enables seven of the tool’s 19 checks — the three categories below — and sets aside the API, Auth, MCP &amp; Skill Discovery and Commerce categories, whose checks, including OAuth Discovery, MCP Server Card, micropayment standards, and the like, describe API servers and transactional applications, not content sites. The score reflects those seven applicable checks.</p><h4>Discoverability: 2 of 4 Passing, Category Score 50</h4><p>DNS-AID enables agents to discover MCP servers and A2A (agent-to-agent) endpoints at the DNS level. It requires DNSSEC (DNS Security Extensions) and is still in early adoption. DNS-AID is in early adoption and not an immediate remediation priority — but it maps to Stage 3 infrastructure when DoveRunner builds out its MCP server.</p><h4>Content — 0 of 1 Passing, 0 Points</h4><p><a href="https://docs.doverunner.com/">DoveRunner Docs</a> runs on Astro + Starlight. The source content is written entirely in Markdown. HTTP responses are always HTML. An agent sending Accept: text/markdown receives HTML. To consume Markdown directly, the agent must parse HTML or separately retrieve source files. This is the only check in the category, hence the 0.</p><h4>Bot Access Control — 1 of 2 Passing (Conditional), Category Score 50</h4><p>The AI bot pass is conditional. User-agent: * / Allow: / permits all crawlers, but says nothing about AI crawling specifically. Content Signals, the standard for declaring AI training, search indexing, and prompt input permissions directly in robots.txt, are absent. This is a single-line addition.</p><blockquote>The category’s third check, Web Bot Auth (verifying bot request signatures via a /.well-known/http-message-signatures-directory ), is skipped in the content-site profile: DoveRunner Docs requires no authentication to read, so there is nothing for an agent to sign in to. That leaves two scored checks here, not three.</blockquote><h4>Not Scored: API, Auth, MCP and Skill Discovery, and Commerce</h4><p>The content-site profile leaves two categories unscored.</p><ul><li><strong>API, Auth, MCP and Skill Discovery</strong>: covers API Catalog (RFC 9727), OAuth/OIDC Discovery, OAuth Protected Resource Metadata, Auth.md agent registration, MCP Server Card, Agent Skills Index, and WebMCP. This category evaluates whether an agent can autonomously identify a site’s API structure and authentication flows.</li><li><strong>Commerce</strong>: covers micropayment standards like x402 and MPP, evaluating agent-driven payments. Neither category describes a documentation site, so the tool excludes them from the score.</li></ul><p>They are not irrelevant to DoveRunner, though. They map directly onto the <strong>future</strong> MCP server: when it is built, publishing an MCP Server Card is how agent orchestrators will discover and connect to it, and an API Catalog is how agents will find what APIs exist. Those are Stage 3 concerns, which are out of scope for measuring this documentation site today but on the roadmap.</p><h3>What This Score Means</h3><p>43/100 still lands at Level 1, but the score doesn’t mean agents cannot use DoveRunner Docs. Claude and Codex parse HTML and extract content from a URL.</p><p><strong>The infrastructure for agents to consume this site optimally is not in place.</strong> Without Markdown content negotiation, agents work through layout noise. Without an API Catalog, agents cannot autonomously discover what APIs exist. Without an MCP Server Card, agent orchestrators cannot declaratively identify what a future MCP server offers.</p><p>Mapped to the three-stage maturity model introduced in Part 2:</p><ul><li><strong>Stage 1 — Discoverability: Partial</strong> <br>robots.txt and sitemap pass. Link headers and llms.txt are absent. An llms.txt file is the highest-leverage immediate fix: adding a static file to the public/ directory resolves this check and clears all three Fern Agent Score content-discoverability failures simultaneously.</li><li><strong>Stage 2 — Governance: Not achieved</strong> <br>Markdown content negotiation, Content-Signal, and per-crawler AI rules are all absent. Content-Signal and crawler rules require only robots.txt edits. Markdown delivery requires Astro/Starlight configuration work, but once done, agents consume structured Markdown directly without HTML parsing noise.</li><li><strong>Stage 3 — Controlled Interaction: Not started</strong> <br>API Catalog, MCP Server Card, and OAuth Discovery are all absent. These sit in the categories the content-site scan leaves unscored, but they remain part of the broader maturity picture: medium-to-long-term architecture work that should be developed alongside the MCP server.</li></ul><h3>A Second Scan: A Complementary Lens</h3><p>Twelve days later, we ran <a href="https://buildwithfern.com/agent-score">Fern’s Agent Score</a> against the same site.</p><p>Result: <strong>0/100. Grade F.</strong> All five of the most important inspection items in the scan tool failed.</p><p>These two scans measure different layers.</p><ul><li><strong>Is Your Site Agent-Ready?</strong> (43/100) : Can agents find the site and access its contents well?</li><li><strong>Fern Agent Score</strong> (0/100) : Can agents read this content in a machine-friendly format?</li></ul><p>Is Your Site Agent-Ready? examines the &quot;entry and navigation&quot; path: bot access permissions, API catalog, MCP server cards, OAuth Discovery. Fern Agent Score checks two things: whether an <strong>llms.txt</strong> file exists (the standard entry point agents use to discover what pages a site contains) and whether the site can serve content as <strong>Markdown</strong> rather than HTML.</p><p>One failure overlaps between the two scans: Markdown content negotiation. The Content category failure in Is Your Site Agent-Ready? and the markdown-availability failures in Fern Agent Score point to the same root cause.</p><p>The remainder are distinct. Is Your Site Agent-Ready? caught bot access governance, API catalog, and MCP server cards. Fern caught llms.txt — a check Is Your Site Agent-Ready? does not run at all.</p><p>Read the 0/100 the same way as 43/100: not “agents cannot read this documentation,” but “the standardized infrastructure for agents to consume this site without layout noise, autonomously, at scale, is not in place.” Together, the two scores map the full shape of that infrastructure gap.</p><h3>What’s Next</h3><p>The infrastructure checklist from these two scans is clear and actionable. But enabling agents to generate correct integration code requires evaluating the content layer separately.</p><p>The next post covers that work: a direct analysis of DoveRunner documentation using Claude to produce 23 end-to-end integration scenarios, and the agent failure points each scenario surfaced. The findings come from following actual integration journeys through the documentation — not from scanning tools.</p><p><em>Each post in this series moves closer to that answer: defining and closing the gaps between </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation</em></a><em> and what AI coding agents need to generate correct integration code.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=725e818d97b0" width="1" height="1" alt=""><hr><p><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-3-725e818d97b0">Agent Readiness for Technical Documentation — Part 3</a> was originally published in <a href="https://medium.com/pallycon">DoveRunner Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AI 에이전트가 읽는 기술 문서, 무엇이 달라야할까 — 2부]]></title>
            <link>https://danielkim-dev.medium.com/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-2%EB%B6%80-d69515a72d2e?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/d69515a72d2e</guid>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Sun, 23 Aug 2026 04:48:21 GMT</pubDate>
            <atom:updated>2026-08-23T04:48:21.390Z</atom:updated>
            <content:encoded><![CDATA[<h4>에이전트 준비도를 측정하는 방법: 2계층 프레임워크</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WAxL2OUdcCIFDscmihjBmQ.jpeg" /></figure><blockquote>이 글은 DoveRunner의 <a href="https://doverunner.com/content-security/">콘텐츠 보안</a> 및 <a href="https://doverunner.com/blogs/application-security-a-comprehensive-guide/">모바일 앱 보안</a> 관련 개발자 문서에 체계적인 에이전트 준비 상태 평가를 적용하여 AI 코딩 에이전트가 올바른 통합 코드를 생성할 수 있는지, 아니면 오류 구현을 조용히 생성하는지 평가하는 시리즈의 두 번째 글입니다. 첫 번째 글은 <a href="https://medium.com/@danielkim-dev/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-1%EB%B6%80-fedbceabae06">여기에서</a> 읽으실 수 있습니다.</blockquote><p>AI 코딩 에이전트는 문서에 <strong>명시된</strong> 내용을 바탕으로 코드를 생성합니다. 문서에 없는 내용, 암묵적으로 가정된 제약, 다른 문서에 흩어진 의존성, 불투명한 오류 응답은 에이전트가 스스로 판단하고 채울 수 없습니다. 특히 B2B SaaS 개발자 문서는 이런 공백으로 가득 차 있는 경우가 많습니다.</p><p>이 공백을 측정하려면 기준이 필요합니다. 이 글에서는 <strong>‘에이전트 준비도’(Agent Readiness)를 평가하는 2계층 프레임워크</strong>와 각 계층을 측정하는 두 가지 방법론에 대해 알아보겠습니다.</p><h3>에이전트 준비도의 2계층</h3><p><strong>‘에이전트 준비도’(Agent Readiness)</strong> 는 두 개의 계층으로 나뉩니다.</p><h4>인프라 계층(Infrastructure Layer)</h4><p>에이전트가 문서를 발견하고 접근할 수 있는가를 묻는 계층입니다. 웹 크롤러의 접근이 허용되어 있는가, 콘텐츠가 Markdown 형식으로 제공되는가, AI 사이트맵에 해당하는 llms.txt 파일이 존재하는가, MCP(Model Context Protocol) 서버 카드가 있는가 — 이 계층의 항목들은 자동화 도구로 측정할 수 있습니다.</p><h4>콘텐츠 계층(Content Layer)</h4><p>문서의 내용 자체가 에이전트가 올바른 코드를 생성하기에 충분한가를 묻는 계층입니다. 선행 조건이 그것이 필요한 단계 앞에 명시되어 있는가, 문서 간 의존성이 의존이 발생하는 시점에 드러나 있는가, 보안 제약이 위반 시 발생하는 결과와 함께 경고로 표시되어 있는가, 외부 승인이나 프로비저닝이 필요한 조건이 연동 워크플로우 안에 명시되어 있는가. 이 계층의 항목들은 자동화 도구만으로는 검증할 수 없습니다.</p><p>두 계층은 측정하는 대상이 다릅니다. 인프라 항목을 모두 통과한 문서 사이트라도 에이전트를 실패하게 만드는 암묵적 제약과 누락된 교차 참조가 있을 수 있습니다. 반대로 콘텐츠 품질이 뛰어나더라도 인프라 계층이 갖춰지지 않으면 에이전트에게 구조적으로 보이지 않는 사이트가 됩니다.</p><p>인프라 계층은 자동화 도구로 평가합니다. 콘텐츠 계층은 전체 통합 흐름을 직접 추적하는 방식으로만 평가할 수 있으며, 그 방법론은 4편에서 자세히 다루도록 하겠습니다.</p><h3>인프라 성숙도 모델</h3><p>인프라 계층은 단계적 성숙도 모델을 따릅니다. 에이전트 친화적인 기술 표준은 발견 가능성부터 제어된 상호작용까지 세 단계를 거치며 발전하며, 각 단계는 서로 다른 실패 유형을 나타냅니다. Stage 1에 도달하지 못한 사이트와 Stage 1~2 사이에 머무는 사이트는 다른 방식으로 실패합니다.</p><h4>Stage 1 — 발견 가능성(Discoverability)</h4><blockquote><em>llms.txt, sitemap.xml, Link 헤더(RFC 8288)가 이 단계에 해당합니다.</em></blockquote><p>Stage 1은 에이전트가 문서를 읽기 전에 사이트에 무엇이 있는지 알 수 있게 해줍니다. 이 단계가 없으면 URL만 가지고 접근한 에이전트는 사이트를 처음부터 무작위로 크롤링해야 하며, 어떤 페이지가 있고 서로 어떻게 연결되는지 구조적으로 파악하기 어렵습니다. llms.txt는 검색 엔진에게 sitemap.xml이 하는 역할을 AI 에이전트에게 해줍니다. 주요 페이지와 설명을 담은 기계가 읽을 수 있는 색인으로, 에이전트가 전체를 크롤링하지 않고도 사이트의 범위를 파악할 수 있게 합니다.</p><h4>Stage 2 — 거버넌스(Governance)</h4><blockquote><em>AI 전용 robots.txt 규칙, Content-Signal 선언, Markdown 콘텐츠 제공이 이 단계에 해당합니다.</em></blockquote><p>에이전트가 콘텐츠를 소비하는 방식을 제어하는 계층입니다. Markdown 제공이 중요한 이유는, HTML을 받은 에이전트가 실제 문서 내용을 추출하기 위해 내비게이션 요소, 사이드바, 레이아웃 구조를 통과해야 하기 때문입니다. 이 과정에서 노이즈가 생기고, 부수적인 요소에 묻혀 있는 제약 조건이 누락될 가능성이 높아집니다. Content-Signal은 AI 학습, 검색 색인, 프롬프트 입력 허용 여부를 robots.txt에 직접 선언하는 새로운 표준으로, 자신의 콘텐츠가 AI 시스템에 의해 어떻게 활용되는지 명시적으로 제어할 수 있게 해줍니다.</p><h4>Stage 3 — 제어된 상호작용(Controlled Interaction)</h4><blockquote><em>API Catalog(RFC 9727), MCP Server Card, OAuth 메타데이터가 이 단계에 해당합니다.</em></blockquote><p>Stage 3은 에이전트가 사람의 지시 없이 API에 자율적으로 연결하고 인증을 처리할 수 있게 합니다. MCP 서버를 구축하는 조직에게 이 단계는 에이전트 오케스트레이터(여러 AI 에이전트의 작업을 순서에 맞게 조율하는 프레임워크)가 해당 서버를 발견하고 연결하는 방법입니다. 이 단계를 건너뛰면 표준 발견 메커니즘에 의존하는 에이전트 프레임워크에서 MCP 서버는 보이지 않는 존재가 됩니다.</p><p>단계 구분은 개선 계획을 세울 때 중요합니다. Stage 1 실패는 정적 파일 몇 개와 설정 변경으로 해결됩니다. Stage 2에 대한 개선에는 콘텐츠 제공 방식의 변경이 필요합니다. Stage 3은 중장기적인 아키텍처 작업입니다. 이 세 단계를 구분하지 않고 단일한 체크리스트로 다루면 노력이 잘못된 곳에 집중되는 결과로 이어집니다.</p><h3>콘텐츠 계층 평가에서 찾는 것</h3><p>인프라 스캐닝은 점수를 산출합니다. 콘텐츠 계층 평가는 다른 종류의 결과를 산출합니다. 기술 문서 내용의 오류 또는 공백으로 인해 API 연동 과정의 어느 지점에서 에이전트가 실패하게 될지를 찾는 것입니다.</p><p>평가 방법은 <strong>엔드투엔드 시나리오 감사(end-to-end scenario auditing)</strong> 입니다. 평가자는 문서를 통해 완전한 고객 여정을 단계별로 추적하며, 각 단계를 그것을 뒷받침해야 하는 특정 문서 페이지에 매핑합니다. 기준은 개별 문서가 잘 작성되어 있는가가 아닙니다. 통합 순서대로 따라갔을 때, 문서 세트 전체가 에이전트에게 올바른 결과를 만들어 낼 수 있는 모든 것을 제공하는가입니다.</p><p>DoveRunner의 Content Security와 Mobile App Security 문서를 감사한 결과, 다섯 가지 실패 유형이 반복적으로 나타났습니다.</p><ul><li><strong>문서 간 인계 공백:</strong> 통합 단계가 다른 문서에서 생성되거나 설정된 정보를 필요로 하는데, 어느 문서도 그 의존성을 명시하지 않는 경우입니다. 에이전트는 해당 단계를 단독으로 완료하고, 의존성은 건너뛰어집니다.</li><li><strong>조용한 실패(silent failure):</strong> 위반 시 유효해 보이지만 실제로는 그렇지 않은 출력이 생성되는 제약 조건입니다. 예를 들면 토큰이 잘못된 인코딩으로 생성되거나, 스트림이 잘못된 암호화 방식으로 패키징되는 등의 경우입니다. 형식은 모든 단계에서 올바르게 보이고, 실패는 런타임에서야 드러나며 원인으로 거슬러 올라갈 수 없는 불투명한 오류와 함께 나타납니다.</li><li><strong>연동 개발 외적인 선행 조건:</strong> 연동 작업을 시작하기 전에 계정 프로비저닝, 인증서 등록, 또는 서드파티 승인이 필요한데, 통합 가이드의 상단이 아닌 별도 튜토리얼, 각주, 절차 중간의 노트로만 문서화된 경우입니다. 에이전트는 선행 조건 없이 통합을 시작합니다.</li><li><strong>플랫폼·환경 제약:</strong> 클라우드 리전, 디바이스 인증 등급, SDK 호환성 같은 런타임 조건이 시작 부분의 선행 조건 경고가 아닌 절차 중간 단계 안에 등장하는 경우입니다. 에이전트는 해당 단계를 읽고 따르며, 결과적으로 한 환경에서는 작동하지만 목표 환경에서는 실패하는 설정을 만들어 냅니다.</li><li><strong>오류 처리 가이드 누락:</strong> API가 의도적으로 불투명한 오류 응답을 반환합니다. 일반적인 오류 뒤에 있는 서로 다른 실패 유형을 열거한 문서가 없으면, 에이전트는 토큰 만료, 인증서 불일치, 파라미터 오류를 구분하는 코드 대신 포괄적인 오류 처리기와 재시도 루프를 생성합니다.</li></ul><p>이 다섯 가지 유형 중 어느 것도 인프라 스캐닝으로는 탐지할 수 없습니다. 문서의 실제 통합 경로를 직접 따라가는 방식으로만 발견할 수 있습니다.</p><h3>두 가지 평가 방법론</h3><p>두 가지 방법론은 함께 작동합니다.</p><p>첫 번째는 <strong>인프라 스캐닝</strong>입니다. 전문 도구가 문서 사이트를 스캔하여 구조적 준비도에 대한 점수화된 평가를 제공합니다. Cloudflare의 <a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> 사이트는 봇 접근 제어, API 카탈로그, MCP 서버 카드, OAuth Discovery를 검사하며, Fern의 <a href="https://buildwithfern.com/agent-score">Agent Score</a>는 llms.txt 존재 여부와 Markdown 제공 여부를 검사합니다. 하나만 실행하면 불완전한 그림이 나오는데, isitagentready.com은 llms.txt를 전혀 확인하지 않습니다.</p><p>두 번째는 <strong>엔드투엔드 시나리오 기반 감사</strong>입니다. 감사자가 문서를 통해 완전한 고객 여정을 추적하며, 문서에 작성된 내용만으로 에이전트가 각 통합을 재현할 수 있는지 검증합니다. 모든 단계가 특정 문서 페이지에 매핑되고, 각 단계에서 묻는 질문은 하나입니다. 이 문서가 다음 단계에 필요한 모든 것을 넘겨주고 있는가?</p><p>기능 경로 분석(문서를 하나씩 읽으며 해당 기능을 다루는지 평가하는 방식)은 문서 경계에서 발생하는 공백을 놓칩니다. <strong>대부분의 에이전트 실패는 문서 내부에서 발생하지 않습니다. 문서 간 인계 지점에서 발생합니다.</strong></p><h3>마치며</h3><p>두 방법론 모두 Content Security와 Mobile App Security를 다루는 DoveRunner의 개발자 문서 사이트인 <a href="https://docs.doverunner.com/">DoveRunner Docs</a>에 적용되었습니다.</p><p>다음 편에서는 Is Your Site Agent-Ready?와 Fern Agent Score의 인프라 스캔 결과를 살펴보겠습니다. 두 점수는 같은 사이트의 서로 다른 항목을 측정하며, 두 결과를 함께 읽을 때 어느 하나만으로는 얻을 수 없는 보다 완전한 그림이 나타납니다.</p><p><em>이 시리즈는 </em><a href="https://docs.doverunner.com/"><em>DoveRunner의 개발자 문서</em></a><em>와 AI 코딩 에이전트가 필요로 하는 것 사이의 간극을 체계적으로 정의하고 좁혀나가는 과정을 기록합니다.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d69515a72d2e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Agent Readiness for Technical Documentation — Part 2]]></title>
            <link>https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-2-4ef6092ff3cb?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/4ef6092ff3cb</guid>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[b2b-saas]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[ai-agent]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Sun, 23 Aug 2026 04:47:46 GMT</pubDate>
            <atom:updated>2026-08-23T04:47:46.926Z</atom:updated>
            <content:encoded><![CDATA[<h4>Measuring Agent Readiness: A Two-Layer Framework for Docs Evaluation</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WAxL2OUdcCIFDscmihjBmQ.jpeg" /></figure><blockquote><em>This is the second post in a series applying a systematic Agent Readiness Assessment to </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation</em></a><em> across </em><a href="https://doverunner.com/content-security/"><em>Content Security</em></a><em> and </em><a href="https://doverunner.com/blogs/application-security-a-comprehensive-guide/"><em>Mobile App Security</em></a><em>, evaluating whether AI coding agents can generate correct integration code or silently produce broken implementations. You can read the first article </em><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-1-ca68d72c1241"><em>here</em></a><em>.</em></blockquote><p>Agents generate code from what the documentation explicitly states. B2B SaaS documentation is full of implicit constraints, cross-document dependencies, and opaque error responses that agents cannot navigate on their own.</p><p>Measuring those gaps requires a framework, which this post introduces: two layers of Agent Readiness and the two methodologies for evaluating them.</p><h3>Two Layers of Agent Readiness</h3><p>Agent Readiness has two layers.</p><h4><strong>Infrastructure Layer</strong></h4><p>Can an agent discover and access the documentation? Are web crawlers permitted? Is content served as Markdown? Is an llms.txt file present (the AI-equivalent of a sitemap)? Is there an MCP (Model Context Protocol) server card? This layer is measurable with automated tools.</p><h4><strong>Content Layer</strong></h4><p>Is the documentation content itself sufficient for an agent to generate correct code? Are prerequisites stated before the steps that require them? Are cross-document dependencies surfaced at the point where the dependency matters? Are security constraints marked as warnings, with the consequence of violation stated? Are multi-party coordination requirements, or steps that require external approval or delayed provisioning, identified as such within the integration flow?</p><p>These layers measure different things. A documentation site can pass every infrastructure check and still contain implicit constraints and missing cross-references that cause agent failures. Conversely, a site with excellent content can be structurally invisible to agents if the infrastructure layer is absent.</p><p>Automated tools evaluate the infrastructure layer. For the content layer, no tool can substitute for tracing a complete integration, a methodology covered in detail in Part 4.</p><h3>The Infrastructure Maturity Model</h3><p>The infrastructure layer follows a staged maturity model. Agent-friendly technical standards progress through three stages, from discovery to controlled interaction. Each stage represents a distinct failure mode: a documentation site that hasn’t reached Stage 1 fails differently than one stuck between Stage 1 and Stage 2.</p><h4>Stage 1: Discoverability</h4><blockquote><em>llms.txt, sitemap.xml, Link headers (RFC 8288, an internet standard for typed links between web resources)</em></blockquote><p>Stage 1 tells an agent what the site contains before it reads anything. Without it, an agent approaching the documentation from a URL starts blind; it has to crawl the site opportunistically, with no structured view of what pages exist or how they relate to each other. An llms.txt file resolves this: it is to AI agents what a sitemap is to search engines, a machine-readable index of key pages with descriptions, so an agent can understand the site&#39;s scope without crawling it entirely.</p><h4>Stage 2: Governance</h4><blockquote><em>AI-specific robots.txt rules, Content-Signal declarations, Markdown delivery</em></blockquote><p>This layer controls how agents consume content. Markdown delivery matters because agents that receive HTML must work through navigation elements, sidebars, and layout chrome to extract the actual documentation content, introducing noise and increasing the likelihood that constraints buried in secondary elements are missed. Content-Signal is an emerging standard that declares directly in robots.txt whether AI training, search indexing, and prompt input are permitted, giving the site explicit control over how its content is used by AI systems. Most documentation sites don’t implement it yet, which means the majority of AI systems consuming their content are operating without any declared permission boundaries.</p><h4>Stage 3: Controlled Interaction</h4><blockquote><em>API Catalog (RFC 9727), MCP Server Card, OAuth metadata</em></blockquote><p>Stage 3 enables agents to connect to APIs autonomously and handle authentication without human direction. For organizations building MCP servers, this stage is how agent orchestrators (frameworks that coordinate multiple AI agents working in sequence) discover and connect to those servers. Skipping it makes the MCP server invisible to any agent framework that relies on standard discovery mechanisms.</p><p>The distinction between stages matters for remediation planning. Stage 1 failures are a few static files and configuration changes. Stage 2 failures require content delivery configuration. Stage 3 is medium-to-long-term architecture work. Treating them as an undifferentiated checklist leads to misallocated effort.</p><h3>What Content Layer Evaluation Actually Looks For</h3><p>Infrastructure scanning produces a score. Content layer evaluation produces a different kind of result: a set of specific, documentable gaps at the exact points in an integration flow where an agent would fail.</p><p>The methodology is end-to-end scenario auditing. The evaluator traces a complete customer journey through the documentation, step by step, mapping every action to the specific documentation that must support it. The criterion is not whether an individual document is well-written. It is whether the documentation set as a whole, followed in integration order, gives an agent everything it needs to produce a correct result. Most agent failures don’t originate inside a single document, but instead originate at the handoffs between documents, where one step assumes context that was never explicitly passed forward.</p><p>Across DoveRunner’s documentation, covering both <a href="https://doverunner.com/content-security/">Content Security</a> and <a href="https://doverunner.com/blogs/application-security-a-comprehensive-guide/">Mobile App Security</a>, five failure categories emerged consistently:</p><ul><li><strong>Cross-document handoff gaps: </strong>An integration step requires information produced or configured in a different document, but neither document states the dependency. The agent completes the step in isolation and the dependency is skipped.</li><li><strong>Silent failures</strong>: A constraint whose violation produces output that looks valid but isn’t. The token generates with the wrong encoding. The stream packages with the wrong encryption scheme. The format looks correct at every step, and the failure surfaces only at runtime with an opaque error that doesn’t trace back to the cause.</li><li><strong>Prerequisites outside the integration flow: </strong>Account provisioning, certificate registration, or third-party approval is required before integration work can begin, but it is documented somewhere other than the top of the integration guide as a separate tutorial, footnote, or note mid-procedure. The agent starts the integration without it.</li><li><strong>Platform and environment constraints:</strong> A runtime condition, such as cloud region, device certification tier, or SDK compatibility, appears mid-step inside a procedure rather than as a prerequisite warning at the start. The agent reads the step, follows it, and produces configuration that works in one environment but fails in the target environment.</li><li><strong>Missing error handling guidance:</strong> APIs return intentionally opaque error responses. Without documentation enumerating the distinct failure modes behind a generic error, an agent generates a catch-all handler and a retry loop rather than code that can distinguish between a token expiry, a certificate mismatch, and a parameter error.</li></ul><p>None of these categories are detectable by infrastructure scanning. They require following the actual integration path through the documentation.</p><h3>The Two Evaluation Methodologies</h3><p>Two methodologies work in combination.</p><p>The first is <strong>infrastructure scanning</strong>. Specialized tools scan a documentation site and produce a scored assessment of its structural readiness. Cloudflare’s <a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> tests bot access controls, API catalog, MCP server cards, and OAuth Discovery. <a href="https://buildwithfern.com/agent-score">Fern’s Agent Score</a> tests llms.txt presence and Markdown availability. Running only one produces an incomplete picture: <a href="https://isitagentready.com/">Is Your Site Agent-Ready?</a> does not check for llms.txt at all.</p><p>The second is <strong>end-to-end scenario-based auditing</strong>. The auditor traces complete customer journeys through the documentation to verify whether an agent could reproduce each integration using only what is written. Every step maps to specific documentation pages. At each step, the question is: does the documentation hand off everything the next step requires?</p><p>Feature-path analysis, reading one document at a time and assessing whether it covers its feature, will miss the gaps at document boundaries. Most agent failures don’t originate inside a document. They originate at the handoffs between documents.</p><h3>What’s Next</h3><p>Both methodologies were applied to <a href="https://docs.doverunner.com/">DoveRunner Docs</a>, DoveRunner’s developer documentation covering Content Security and Mobile App Security.</p><p>The next post covers the infrastructure scan results from Is Your Site Agent-Ready? and Fern Agent Score. The two scores measure different layers of the same site. Reading them together produces a more complete picture than either in isolation.</p><p><em>This series documents a systematic effort to define and close the gaps between </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation</em></a><em> and what AI coding agents need.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4ef6092ff3cb" width="1" height="1" alt=""><hr><p><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-2-4ef6092ff3cb">Agent Readiness for Technical Documentation — Part 2</a> was originally published in <a href="https://medium.com/pallycon">DoveRunner Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AI 에이전트가 읽는 기술 문서, 무엇이 달라야할까 — 1부]]></title>
            <link>https://danielkim-dev.medium.com/ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%9D%BD%EB%8A%94-%EA%B8%B0%EC%88%A0-%EB%AC%B8%EC%84%9C-%EB%AC%B4%EC%97%87%EC%9D%B4-%EB%8B%AC%EB%9D%BC%EC%95%BC%ED%95%A0%EA%B9%8C-1%EB%B6%80-fedbceabae06?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/fedbceabae06</guid>
            <category><![CDATA[saas]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[content-security]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[application-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Fri, 21 Aug 2026 07:22:05 GMT</pubDate>
            <atom:updated>2026-08-21T07:22:05.366Z</atom:updated>
            <content:encoded><![CDATA[<h4>기술 문서의 ‘에이전트 준비도’란 무엇인가 그리고 왜 지금 중요한가</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DMrmKYWMsgWjmEceXkLLdQ.jpeg" /></figure><p>AI 코딩 에이전트의 등장은 단순한 기술 트렌드가 아닙니다. Claude Code, Codex, GitHub Copilot 같은 도구를 활용해 에이전트가 문서를 읽고, 통합 코드를 작성하고, Pull Request를 열고, 사람이 각 단계를 직접 검토하지 않는 워크플로우가 이미 일부 팀에서 현실이 되고 있으며, 이는 API 또는 SDK를 제공하는 모든 사업자가 주목해야 할 방향입니다.</p><p>이 흐름은 API 제공자에게 하나의 질문으로 귀결됩니다. <strong>우리 문서는 에이전트가 소비할 수 있는 형태로 작성되어 있는가?</strong></p><p>이 글에서는 그 질문을 <a href="https://docs.doverunner.com/">DoveRunner 개발자 문서</a>에 직접 적용한 결과를 소개하겠습니다. <a href="https://doverunner.com/">DoveRunner</a>는 두 개의 주요 제품군을 운영하는 B2B SaaS 플랫폼으로, <strong>콘텐츠 보안</strong>(멀티 DRM, 포렌식 워터마킹, Distributor Watermarking, Anti-Piracy)과 <strong>모바일 앱 보안</strong>으로 구성됩니다. 두 제품군 모두 개발자용 API 또는 SDK를 제공하며, 이 글에서 다루는 실패 패턴의 영향을 직접 받습니다.</p><p>이 시리즈는 DoveRunner 문서와 AI 코딩 에이전트가 필요로 하는 것 사이의 간극을 <strong>‘에이전트 준비도’</strong>(Agent Readiness)라는 관점으로 측정하고 개선하는 과정을 기록합니다.</p><h3>에이전트가 문서를 읽는 방식</h3><p>기술 문서는 사람을 위해 작성되었습니다. 사람은 문서를 읽으며 맥락을 추론하고, 도메인 지식으로 모호함을 해소하며, 경험으로 빈틈을 채웁니다. “A를 하고 나서 B를 하라”는 지시에서 A의 전제 조건이 다른 문서에 묻혀 있더라도, 사람은 그 문서를 찾아 확인합니다.</p><p><strong>에이전트는 다르게 작동합니다.</strong> 에이전트는 문서에 명시적으로 기술된 내용을 바탕으로 코드를 생성합니다. 제약 조건이 문서에 없으면 에이전트는 그 제약이 존재하지 않는다고 가정하며, “A 다음에 B”를 수행하기 위해 먼저 C가 필요한데 C가 다른 문서에 있다면 C 없이 B를 생성합니다.</p><p>더 심각한 문제는 에이전트가 실패를 조용히 처리한다는 점입니다. 오류 메시지를 마주한 사람 개발자는 누락된 단계를 인식하지만, 에이전트는 오류를 받으면 재시도 로직을 생성하거나, 대안적 접근법을 추론하거나, 겉으로는 올바르게 보이지만 실제로는 잘못된 우회 코드를 자신 있게 작성합니다.</p><p>이는 예외 상황이 아니라, 문서가 제약 조건을 암묵적으로 남겨둘 때 나타나는 기본 동작입니다. 이 시리즈의 후속 글에서는 시나리오 기반 테스트를 통해 이 패턴이 DoveRunner 문서에서 어떻게 나타나는지 직접 확인해보겠습니다.</p><h3>B2B SaaS 문서가 특히 어려운 이유</h3><p>B2B SaaS API 문서는 일반 소비자용 API 문서와 성격이 다릅니다.</p><p>날씨 API나 지도 API처럼 단일 엔드포인트에 몇 가지 파라미터와 응답 스키마로 구성된 소비자용 API는 에이전트가 비교적 잘 처리합니다. 하지만 B2B SaaS는 다른 범주입니다. DRM 통합을 예로 들면, 패키저(영상 암호화·패키징) → CDN(전송) → 플레이어(기기 재생) → 라이선스 서버(재생 인가)로 이어지는 전체 체인을 연결해야 하며, 서로 다른 문서에 분산된 설정값들이 각 단계에서 정확히 맞아떨어져야 합니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*5dC7Xts-lCJCvarI.png" /></figure><p>DRM 유형에 따라 요구하는 암호화 방식도 다릅니다. FairPlay(Apple), Widevine(Google), PlayReady(Microsoft)는 각각 다른 암호화 방식을 사용하는데, <strong>FairPlay는 HLS 네이티브 암호화 방식인 CBCS만 지원하며 Widevine과 PlayReady가 사용하는 CENC와는 호환되지 않습니다.</strong></p><p>이 제약이 문서에 명시되지 않으면 어떤 일이 벌어지는지 살펴보겠습니다. 에이전트는 패키저 문서를 읽고 encryption_scheme 파라미터가 CENC와 CBCS를 모두 지원한다는 것을 확인한 뒤, Widevine에서 동작하는 것으로 학습된 CENC로 패키징 코드를 생성합니다. 문서에는 경고가 없고 패키징 작업은 성공합니다. 단위 테스트와 CI 파이프라인도 통과됩니다. 스트림이 운영 환경에 배포됩니다.</p><p>그런데 iOS 사용자는 스트림을 재생하지 못합니다.</p><p>운영팀이 원인을 조사하기 시작합니다. CDN 설정인지, 플레이어 버전인지, 라이선스 서버인지, 패키징 파라미터인지 알 수 없는 일반적인 DRM 복호화 오류입니다. 수 시간의 디버깅 끝에 패키저 설정의 파라미터 값 하나로 귀결됩니다.</p><p><strong>제약 조건을 위반해도 겉으로는 올바른 결과물이 생성되는 유형의 장애가 B2B SaaS 연동에서 가장 위험한 패턴입니다.</strong> 패키징은 성공하고 테스트도 통과하며, 일부 사용자에게만 운영 환경에서 장애가 드러납니다. 이것이 배포 전에 잡기 어려운 이유입니다.</p><p>B2B SaaS는 실제 통합 작업 전에 선행되어야 하는 설정 항목들도 있습니다. 계정 설정, 인증서 등록, 멀티 서비스 의존성이 그것입니다. FairPlay 인증서 등록을 예로 들면, Apple Developer Program 내 계정 소유자(Account Holder) 권한이 필요한데, 이는 일반 개발자 계정에는 없는 특정 권한 등급입니다. 또한 Apple의 처리 기간으로 3~7 영업일이 소요됩니다. 문서가 통합 플로우의 시작 부분에서 이 의존성을 명시하지 않으면, 에이전트는 이 단계 없이 그대로 진행합니다.</p><h3>마치며</h3><p>이 글에서 다룬 장애들은 공통적인 구조를 가집니다. 제약 조건이 존재했지만 명시적으로 문서화되지 않았고, 에이전트는 그 제약이 없는 것처럼 코드를 생성했습니다. <strong>이는 문서의 문제로, 측정 가능하고 개선할 수 있습니다.</strong></p><p>다음 글에서는 이를 측정하기 위한 프레임워크를 소개합니다. ‘에이전트 준비도’(Agent Readiness)는 두 가지 계층으로 구성되며, 각각을 평가하는 방법론이 다릅니다. DoveRunner 문서에 두 방법론을 모두 적용한 결과를 단계적으로 살펴보겠습니다.</p><p>DoveRunner의 ‘에이전트 준비도’ 개선 과정에 관심이 있으시다면 이 시리즈의 후속 글을 통해 자세히 알아보시기 바랍니다.</p><p><em>이 시리즈는 </em><a href="https://docs.doverunner.com/"><em>DoveRunner 개발자 문서</em></a><em>와 AI 코딩 에이전트가 필요로 하는 것 사이의 간극을 정의하고 해소하기 위한 체계적인 노력을 기록합니다.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fedbceabae06" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Agent Readiness for Technical Documentation — Part 1]]></title>
            <link>https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-1-ca68d72c1241?source=rss-ae16cdd0a8b5------2</link>
            <guid isPermaLink="false">https://medium.com/p/ca68d72c1241</guid>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[technical-documentation]]></category>
            <category><![CDATA[saas]]></category>
            <category><![CDATA[application-security]]></category>
            <category><![CDATA[content-security]]></category>
            <dc:creator><![CDATA[Daniel Kim]]></dc:creator>
            <pubDate>Fri, 21 Aug 2026 07:11:37 GMT</pubDate>
            <atom:updated>2026-08-21T07:26:33.551Z</atom:updated>
            <content:encoded><![CDATA[<h3>Agent Readiness for Technical Documentation — Part 1</h3><h4>What Agent Readiness Means for Technical Documentation (And Why It Matters Now)</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DMrmKYWMsgWjmEceXkLLdQ.jpeg" /></figure><p>A developer types a prompt. An AI coding agent reads the documentation, generates integration code, opens a pull request. This is already happening in agentic coding workflows, where every API provider’s documentation is heading.</p><p>For API and SDK providers, this shift has one implication: <strong>Is our documentation built for agents to consume?</strong></p><p>This post is the first in a series applying that question to <a href="https://docs.doverunner.com/">DoveRunner’s developer documentation</a>. <a href="https://doverunner.com/">DoveRunner</a> is a B2B SaaS platform with two major product lines: <a href="https://doverunner.com/content-security/">Content Security</a> and <a href="https://doverunner.com/blogs/application-security-a-comprehensive-guide/">Mobile App Security</a>. Content Security covers Multi-DRM (Digital Rights Management for protecting video content), forensic watermarking, distributor watermarking, and anti-piracy. Both product lines expose complex developer-facing APIs and are subject to the failure modes described here.</p><h3>What “An Agent Reads” Actually Means</h3><p>Technical documentation was written for humans. Humans read it while inferring subtext, resolving ambiguity with domain knowledge, and filling gaps with experience. They understand “do A, then B” even when the prerequisite for A is buried in a different document.</p><p>Agents operate differently. An agent generates code from what is explicitly stated in the documentation. If a constraint isn’t written, the agent assumes it doesn’t exist. If “A then B” requires completing C first, where C is documented elsewhere, the agent generates B without C.</p><p>Agents also handle failures silently. A human encountering an error message will recognize the missing step. An agent receiving an error will generate retry logic, infer an alternative approach, or, worse still, confidently produce a workaround that appears correct but isn’t.</p><p>This is the expected default behavior when documentation leaves constraints implicit. Later in this series, scenario-based testing will put that expectation to the test and show whether it holds in practice.</p><h3>Why B2B SaaS API Documentation Is Especially Challenging</h3><p>B2B SaaS API documentation differs from consumer API documentation.</p><p>Consumer APIs, such as weather APIs and maps APIs, are straightforward. A single endpoint, a few parameters, a response schema. Agents handle these well.</p><p>B2B SaaS is another category. <a href="https://docs.doverunner.com/content-security/multi-drm/">DRM integration</a>, for example, requires connecting a complete chain: packager (encrypts and packages video) → CDN (delivers it) → player (plays it on the user’s device) → license server (authorizes each playback request).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*tiJ9fR7vqgn15Ndt.png" /></figure><p>Configuration values scattered across different documents must align at every stage. The three major DRM systems — FairPlay (Apple), Widevine (Google), and PlayReady (Microsoft) — each require different encryption schemes. FairPlay only works with CBCS (the HLS-native encryption scheme), not CENC, which Widevine and PlayReady use.</p><p>Consider what happens when that constraint is not documented explicitly. An agent reads the packager documentation, notes that encryption_scheme accepts both CENC and CBCS, and generates packaging code using CENC, the same scheme it observed working for Widevine. Nothing in the documentation warned otherwise. The packaging job succeeds. Unit tests pass. The CI pipeline clears. Streams are deployed to production.</p><p>But iOS users cannot play them.</p><p>The DevOps team investigates. The error is a generic DRM decryption failure; it could be the CDN configuration, the player version, the license server, or the packaging parameters. Hours of debugging led back to a single wrong parameter value in the packager config.</p><p>This category of failure — a constraint whose violation produces output that looks valid but isn’t — is the most dangerous pattern in B2B SaaS integration. The packaging succeeds, the tests pass, and the break surfaces only for a subset of users in production, which is exactly what makes it so hard to catch before it ships.</p><p>B2B SaaS also imposes setup overhead before any integration work begins. Account setup, certificate registration, and multi-service dependencies must be completed first. In our experience, FairPlay certificate registration requires Apple Developer Account Holder credentials (a specific permission tier within the <a href="https://developer.apple.com/programs/">Apple Developer Program</a>, not available to standard developer accounts) and three to seven business days of Apple processing time. If the documentation doesn’t surface this dependency at the start of the integration flow, the agent proceeds without it.</p><h3>What Comes Next</h3><p>These failures share a common structure: a constraint existed, was not documented explicitly, and an agent generated code as though the constraint didn’t apply. The failures described here are documentation problems that are measurable and fixable.</p><p>The next post introduces the framework for measuring it: two distinct layers of Agent Readiness, along with methodologies for evaluating each.</p><p><em>This series documents a systematic effort to define and close the gaps between </em><a href="https://docs.doverunner.com/"><em>DoveRunner’s developer documentation</em></a><em> and what AI coding agents need.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ca68d72c1241" width="1" height="1" alt=""><hr><p><a href="https://medium.com/pallycon/agent-readiness-for-technical-documentation-part-1-ca68d72c1241">Agent Readiness for Technical Documentation — Part 1</a> was originally published in <a href="https://medium.com/pallycon">DoveRunner Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>