에이전트 준비도: 기계가 읽을 수 있는 문서 쓰기

오랫동안 기술 문서는 사람만을 위한 것이었습니다. 그런데 그 전제가 조용히 무너지고 있습니다. 이제 문서를 가장 빠르게 읽어 내려가는 독자는 사람이 아니라, 내용을 검색하고 해석해 행동으로 옮기는 AI 에이전트인 경우가 점점 늘고 있습니다.

‘에이전트 준비도’(Agent Readiness)란 문서가 이 과정을 얼마나 잘 견뎌 내는지를 뜻합니다. 모델이 올바른 페이지를 찾아내고, 정확한 단계를 추출하며, 글쓴이가 암묵적으로 비워 둔 맥락을 임의로 지어내지 않을 수 있는지의 문제입니다. 숙련된 엔지니어라면 무리 없이 따라올 수 있는 문서라도 에이전트에게는 실패할 수 있는데, 에이전트는 행간을 읽지 못하기 때문입니다.

차이를 만드는 지점은 몇 가지로 정리됩니다.

• 당연한 것을 명시하기. 암묵적인 전제 조건은 검색하는 입장에서는 보이지 않습니다.
• 하나의 사실은 한 곳에만 두기. 페이지마다 내용이 어긋나면 검색 품질이 무너집니다.
• 산문보다 구조. 제목과 목록, 안정적인 앵커는 기계가 읽기에 좋습니다.

미디어테크 분야에서 DRM과 스트리밍 문서를 다루며, 모호한 한 줄이 얼마나 비싼 대가로 돌아오는지를 배웠습니다. 에이전트는 그 대가를 한층 키울 뿐입니다.

앞으로 실험을 이어 가며 더 자세히 다루어 보겠습니다.