How We Got LLMs to Recommend Our Open Source Library — Christopher Burns, Inth

한 줄 핵심

LLM과 에이전트가 문서와 라이브러리를 더 잘 발견하고 이해하도록 하려면, 생성형 SEO보다 문서·마크다운·MCP·노드 모듈까지 포함한 다층적인 컨텍스트 설계가 핵심이다.

시간별 요약

1. 0:00
   과학자보다 직접 해보는 사람 오픈소스 라이브러리 C15T를 LLM이 이해하고 추천하게 만들기 위해 실험적으로 최적화를 진행했고, 이 과정에서 개발자 경험과 토큰 효율이 중요한 목표가 되었다. 실제로 다운로드 수와 사용 사이트가 빠르게 늘면서 이 접근이 이론이 아니라 실효가 있는 문제 해결임을 보여준다.
2. 2:23
   급증한 유입과 유입 경로 온보딩 설문을 통해 유입 출처를 추적한 결과 Claude, ChatGPT, Codex, Gemini 같은 LLM 추천이 가장 큰 유입원이 되었다. 설치 방식도 사람이 직접 하던 단계에서 에이전트가 프롬프트로 설치를 수행하는 단계로 바뀌면서, 기존의 개발자 경험이 에이전트 경험으로 확장되고 있다.
3. 4:20
   단일 해법이 없어 문서 파이프라인을 구축 문제는 하나의 도구로 해결되지 않아서, 여러 작은 최적화를 묶은 문서 파이프라인 Lead Type을 만들었다. .mdx 파일을 입력으로 받아 에이전트 친화적인 출력을 생성하는 방식으로, 특정 제품용 SEO가 아니라 프레임워크에 독립적인 문서 인프라를 지향한다.
4. 5:52
   llms.txt는 자동 생성보다 수작업 페이지가 많은 문서에서는 먼저 llms.txt가 필요하지만, 자동 생성보다 사람이 직접 작성하는 편이 훨씬 효과적이다. 약 40줄 정도의 정제된 내용이 1,000줄의 잡음보다 낫고, 이어지는 llms-full.txt에는 페이지별 링크와 간단한 설명을 담아 탐색과 검색을 돕는다.
5. 7:07
   HTML 대신 Markdown 배포 에이전트에게 HTML은 비용이 크므로 Markdown을 함께 제공하는 방식이 점점 중요해지고 있다. .md 버전, Markdown을 반환하는 리다이렉트, 그리고 mode=agent 같은 URL 쿼리를 통해 다양한 에이전트가 문서를 받을 수 있게 만들어야 한다.
6. 9:17
   웹 MCP로 문서에 질문하게 만들기 에이전트가 웹사이트에 직접 질문할 수 있도록 Web MCP를 노출하면 문서 탐색이 더 자연스러워진다. Search docs, get pages, ask docs 같은 도구를 제공해 필요한 맥락을 뽑아오게 하는 구조가 핵심이다.
7. 10:09
   에이전트는 사이트보다 node_modules를 읽는다 코딩 에이전트는 실제로 웹사이트보다 node_modules와 저장소를 읽는 경우가 많기 때문에, 문서를 거기에 넣어주는 것이 중요하다. agents.md로 문서 위치를 알려주고 번들된 Markdown을 함께 제공하면 토큰 사용량을 거의 절반 수준까지 줄일 수 있다.
8. 12:53
   사이트가 에이전트 준비 상태인지 테스트 Claude 추천이 늘어도 사이트가 에이전트 친화적인지 확인할 테스트 하네스는 아직 부족하므로, Cloudflare나 Aura AI 같은 도구로 점검할 수 있다. 이 영역은 계속 변하므로 완벽함을 목표로 하기보다 작은 개선을 꾸준히 쌓는 것이 더 중요하다.
9. 14:36
   일반 웹사이트는 어디서 시작할까 처음 시작한다면 모든 페이지에 .md 파일을 제공하는 것이 가장 효과적이고, 그다음은 llms.txt를 수작업으로 정리하는 것이다. CMS가 이를 지원하지 않아도 별도 파일을 만들어 대응할 수 있으며, 마크다운 제공과 llms.txt 정리가 가장 우선순위가 높다.

실무 인사이트

• 문서 최적화는 한 번의 변환이 아니라 llms.txt, Markdown, MCP, node_modules까지 이어지는 다층 전략으로 설계해야 효과가 크다.
• 에이전트 친화성은 검색 노출보다 토큰 효율과 직접 질문 가능성에 더 가깝기 때문에, 문서의 양보다 구조와 제공 방식이 더 중요하다.
• 웹사이트가 사람보다 에이전트에게 더 많이 읽히는 상황을 전제로, 모든 핵심 페이지에 기계가 읽기 쉬운 대체 경로를 두는 것이 실무적으로 유리하다.