llms.txt를 Cursor와 Claude Code와 함께 사용하기: 구체적인 플레이북

발행: 1시간 전 (2026년 5월 3일 PM 08:56 GMT+9)

9 분 소요

원문: Dev.to

Source: Dev.to

Location

그곳에 넣으세요

공식 문서 서버

https://example.com/llms.txt (라이브러리/벤더에 의해 유지 관리)

당신의 레포

URL만 (짧은 프로토콜 포함), 에이전트 규칙에 포함—문서 복사는 금지
.cursor/rules/ – 프로젝트 맵, 규칙, 당신의 아키텍처—Next.js 전체 매뉴얼이 아님

업스트림 문서를 수천 토큰씩 규칙에 붙여넣으면, 모든 채팅에서 그 비용을 지불하게 됩니다. 규칙에 포인터만 두고 필요할 때 문서를 로드하면 이를 피할 수 있습니다.

.cursor/rules/external-llms-docs.md와 같은 파일을 생성하세요 (이름은 상관없으며, 범위는 유지). 실제로 스택에서 사용하는 llms.txt URL들의 안정적인 목록을 붙여넣고, 인간과 에이전트가 빠르게 스캔할 수 있도록 그룹화하세요.

Source: (원본 링크가 제공되지 않았으므로 그대로 유지합니다.)

외부 문서 — 필요 시 가져오기

인덱스 URL (먼저 읽어야 할 것)

영역	llms.txt
Next.js	https://nextjs.org/llms.txt
Tailwind	https://tailwindcss.com/llms.txt
Lucide	https://lucide.dev/llms.txt
Google ADK	https://adk.dev/llms.txt

읽는 순서

질문을 담당하는 의존성의 llms.txt 를 가져옵니다.
해당 파일(또는 명확한 /docs/*.md 형제 파일)에서 오직 링크만 따라가며 깊이를 탐색합니다.
마케팅 HTML을 스크래핑하기보다 Markdown 소스를 우선합니다.
로컬에 타입이 존재한다면(node_modules, 스텁) 해당 API 표면을 파악한 뒤 사용합니다(잘못된 심볼 추측을 방지).

범위

우리 레포 레이아웃에 관한 질문 → repo-map 규칙 / 코드베이스 검색을 사용하고, llms.txt는 사용하지 않습니다.
그들의 API/버전/문서에 관한 질문 → 위 표를 사용합니다.

왜 별도 파일인가: 컨텍스트에 따라 규칙을 주입하기 위해; 거대한 전역 규칙 파일은 관련 없는 편집을 무겁게 만든다. 내부와 외부 포인터를 분리한다. 순서를 명시적으로 지정해 모델이 “node_modules를 한 시간 동안 grep한다”는 기본 동작을 하지 않게 한다.

외부 SDK 프로토콜

사용자가 외부 라이브러리 버전이나 API에 의존하는 동작을 요청할 때:

해당 기능을 소유한 의존성을 식별한다(package.json / import).
해당 의존성에 대한 llms.txt 가 목록에 있으면, 코드 작성 전에 이를 가져온다.
≤10줄로 요약한다: 버전 가정, 파일명, 사용할 API — 그런 다음 구현한다.
전체 업스트림 페이지를 그대로 인용하지 말고, 챕터/섹션 또는 URL 경로만 인용한다.

예시 – 기능 구현 (예: App Router 인증 미들웨어)

사용자: “Next.js App Router 로 미들웨어 기반 인증을 추가해 주세요.”
에이전트: https://nextjs.org/llms.txt 를 가져와 middleware.ts / 매처 패턴을 설명하는 페이지를 연다.
가져온 파일의 현재 파일명과 시그니처를 사용해 구현한다—기억에 의존하지 않는다.

디버깅 예시 – Tailwind 클래스 이름이 업그레이드 후 작동 안 함

사용자: “Tailwind v4 클래스 이름이 업그레이드 후 작동하지 않아요.”
에이전트: 먼저 Tailwind의 llms.txt 를 가져와서 파괴 변경 사항과 설정 파일명을 확인하고, 레포의 tailwind.config.* / CSS 진입점을 연다.

단계별 SDK 덤프 (예시 패턴)

일부 사이트는 짧은 인덱스와 긴 번들을 제공한다(이름은 다양). 경험 법칙: 짧은 파일부터 시작하고, 스텁이 답을 못하면 전체 파일로 업그레이드한다.

가상의 문서 호스트 레이아웃

/llms.txt          → 링크 + 개요
/llms-small.txt    → 최소 표면 (저비용)
/llms-full.txt     → 전체 (고비용)

규칙은 엔트리(llms.txt)에 지정하고, 가져온 내용이 *-full 존재 여부를 알려주게 한다.

작업별로 규칙을 편집하지 않고도 행동을 유도할 수 있다:

“편집 전: Next.js llms.txt 를 가져와 미들웨어 파일명과 export 형태를 확인한다.”
“ADK llms.txt 를 사용한다; API 이름에 대해 학습 컷오프에 의존하지 않는다.”
“Tailwind llms.txt 를 가져온 뒤, 사용한 문서 URL(경로만) 목록을 나열한다.”

내부 플랫폼 — LLM 인덱스

인증

개요: https://internal-docs.example.com/auth/overview.md
2026년 주요 변경 사항: https://internal-docs.example.com/auth/changelog.md

데이터 레이어

API 규칙: https://internal-docs.example.com/db/conventions.md

.cursor/rules/external-llms-docs.md에 한 줄 추가:

Internal platform | https://internal-docs.example.com/llms.txt

벤더 문서와 동일한 메커니즘.

Operational notes

에이전트는 HTTPS 텍스트를 가져올 수 있어야 합니다(내장 fetch, 브라우저 도구, MCP fetch 등). 에어갭된 머신은 대체 수단이 필요합니다(규칙에 스니펫을 미러링하거나 로컬 정적 서버, 혹은 벤더 tarball 사용—하지만 토큰 비용을 감수).
인증된 URL에 비밀 정보를 규칙에 넣지 마세요; 공개 문서나 내부 SSO‑인식 도구를 일반 마크다운 외부에서 사용하세요.
전체 업스트림 마크다운을 .cursor/rules에 그대로 넣지 마세요; 토큰 사용량이 급증합니다.
llms.txt를 건너뛰고 무작위 마케팅 페이지를 크롤링하면 토큰이 낭비되고 잡음이 늘어납니다.
docs/vendor/ 아래에 벤더 문서를 복제하고 모두 인덱싱하는 것은 오프라인 접근이 정말 필요하지 않는 한 불필요합니다.
코딩 에이전트의 경우, 이점은 예측 가능한 마크다운 진입점과 더 작고 항상 켜져 있는 컨텍스트이며, SEO 혜택이 아닙니다.

.cursor/rules/external-llms-docs.md 파일을 추가하고, llms.txt URL 목록과 읽기 순서 및 범위(외부 vs 내부 레포 맵)를 표로 정리하세요. 에이전트에게 다음 흐름을 가르칩니다: 인덱스 가져오기 → 연결된 마크다운 따라가기 → 로컬 타입 사용. 제공자가 파일을 계층적으로 제공한다면 얕은 수준부터 차례로 사용하세요. 필요에 따라 내부 플랫폼용 llms.txt를 직접 호스팅할 수 있지만, 규칙은 여전히 포인터 역할만 하도록 유지하세요.