Llms.txt 편집하기 (부분)

== 파일 형식 및 문법 ==

=== 기본 구조 ===

llms.txt는 '''[[마크다운(Markdown)]]''' 형식으로 작성되며, 구조는 다음과 같은 순서를 따른다. 마크다운을 선택한 이유는 LLM이 기본적으로 마크다운을 잘 이해하기 때문이며, 별도의 파서나 스키마 없이도 처리 가능하다.

<syntaxhighlight lang="markdown">
# 사이트 또는 프로젝트 이름

> 한두 문장의 블록 인용구 형식 요약문. 제3자 시점으로, 에이전트가 읽기 좋게 작성.

선택적 부연 설명 단락. 브랜드명이 모호하거나 카테고리 맥락이 필요한 경우 작성.

## 섹션 이름

- [페이지 제목](https://example.com/page): 해당 페이지에 무엇이 있는지, 에이전트가 왜 이 페이지를 가져가야 하는지 한 문장 설명.
- [다른 페이지](https://example.com/another): 설명.

## 또 다른 섹션

- [페이지 제목](https://example.com/page): 설명.

## Optional

- [우선순위 낮은 페이지](https://example.com/extra): 컨텍스트가 부족할 경우 에이전트가 건너뛰어도 되는 페이지.
</syntaxhighlight>

=== 각 요소 상세 설명 ===

==== H1 헤더 (필수) ====

<code># 사이트명</code>

파일에서 '''유일하게 필수적인 요소'''다. 브랜드명 또는 프로젝트명을 그대로 사용한다. H1은 파일 전체에서 딱 하나만 있어야 한다.

==== 블록 인용구 요약 (강력 권장) ====

<code>> 요약문</code>

한두 문장으로 사이트/프로젝트가 무엇인지, 누구를 위한 것인지 설명한다. '''제3자 시점'''으로 쓰는 것이 좋다("우리 회사는~"보다 "X는 Y를 위한 Z이다" 형태). 에이전트가 URL을 실제로 방문하지 않고도 이 설명만으로 브랜드를 이해할 수 있어야 한다.

==== 부연 설명 단락 (선택) ====

H1과 블록 인용구 이후에 일반 단락으로 추가 맥락을 제공할 수 있다. 브랜드명이 Stripe, Anthropic처럼 카테고리를 유추하기 어려운 경우에 특히 유용하다. Tesla나 Coca-Cola처럼 누구나 아는 브랜드는 생략해도 된다.

==== H2 섹션 (선택) ====

<code>== 섹션명 ==</code>

콘텐츠를 논리적 그룹으로 묶는 역할을 한다. 예를 들어 "Getting Started", "API Reference", "Pricing", "Tutorials" 등. 중요한 점은 '''내부 문서 구조가 아니라 에이전트가 어떤 질문을 할 때 이 섹션이 필요한가'''의 관점에서 섹션을 나눠야 한다는 것이다(Anthropic의 경우 문서가 파일 구조로 정리되어 있지 않고 개발자가 어떤 도움이 필요한지를 기준으로 H2를 구성한다).

==== 링크 목록 (선택) ====

<code>- [페이지 제목](URL): 한 줄 설명</code>

각 링크에는 반드시 '''한 줄 설명'''을 붙이는 것이 좋다. 설명은 구체적일수록 좋다. 에이전트는 실제로 URL을 방문하지 않고도 설명만으로 판단해야 하는 경우가 많기 때문이다.

* 나쁜 예: <code>- [요금제](https://example.com/pricing): 가격 정보</code>
* 좋은 예: <code>- [요금제](https://example.com/pricing): Starter ($500/월), Growth ($2,000/월), Enterprise (맞춤) 상세 비교</code>

==== Optional 섹션 ====

<code>## Optional</code>

이 섹션은 '''특별한 의미를 갖는 예약어'''이다. 컨텍스트가 부족할 때 에이전트가 건너뛰어도 무방한 보조 자료들을 여기에 넣는다.

=== 실제 예시 ===

==== Stripe의 llms.txt ====

<syntaxhighlight lang="markdown">
# Stripe

> Stripe is a technology company that provides financial infrastructure for 
> businesses. Businesses of every size—from new startups to established public 
> companies—use Stripe to accept payments online and in person, embed financial 
> services, and create custom revenue models.

For complete documentation in a single file, see [Full Documentation](https://stripe.com/llms-full.txt).

## Payments

- [Stripe Payments](https://stripe.com/payments): Accept payments online and 
  in person globally with a payments solution built for any business.

## Billing

- [Stripe Billing](https://stripe.com/billing): Automate billing and revenue 
  management.

## Optional

- [Stripe Climate](https://stripe.com/climate): Help businesses contribute to 
  carbon removal.
</syntaxhighlight>

==== FastHTML (제레미 하워드의 정석 예시) ====

<syntaxhighlight lang="markdown">
# FastHTML

> FastHTML is a python library which brings together Starlette,
> Uvicorn, HTMX, and fastcore's `FT` "FastTags" into a library
> for creating server-rendered hypermedia applications.

## Docs

- [FastHTML quick start](https://docs.fastht.ml/path/quickstart.html.md): A brief overview of many FastHTML features
- [HTMX reference](https://docs.fastht.ml/ref/defining_xt_component.html.md): How to use HTMX with FastHTML
</syntaxhighlight>