llms.txt의 기본 형식

마크다운으로 구성하는 기본 골격

llms.txt 제안 문서는 사람이 읽는 설명과 프로그램이 처리할 수 있는 구조를 마크다운 안에 함께 담도록 설명합니다. 사이트 운영자는 문장의 내용부터 정비하기보다 각 부분이 어떤 문법으로 표시되고 어디에 놓이는지 먼저 판단합니다. 파일을 열었을 때 제목, 요약, 설명, 링크 목록의 경계를 가릴 수 있는지가 출발 기준입니다.

표의 순서는 모든 항목을 반드시 채우라는 뜻이 아닙니다. 선택 항목을 생략하면 남은 항목 사이의 순서를 유지합니다. 운영자는 파일의 길이보다 필수 요소의 존재와 선택 요소의 배치 관계를 기준으로 형식을 판단합니다.

선택적 BOM과 필수 H1의 차이

BOM은 파일 맨 앞에 올 수 있는 바이트 순서 표시이며, 사이트 제목이나 요약 문장이 아닙니다. 제안 형식에서는 이를 선택 사항으로 다루므로 BOM이 없다는 이유만으로 필수 요소가 빠졌다고 판단하지 않습니다. 편집 화면에서 BOM 상태를 읽기 어렵다면 기술 담당자에게 파일 시작 부분의 상태를 요청합니다.

H1은 프로젝트나 사이트의 이름을 담는 제목입니다. 마크다운 표기 모양은 ‘# 사이트 제목’처럼 제목 앞에 #을 사용하는 형태입니다. 화면에 크게 표시된 문구만으로 판단하지 말고, 파일 내용에 H1 표기가 있는지 대조합니다.

H1 뒤의 인용문 요약은 ‘> 요약 문장’과 같은 모양으로 표시합니다. 그다음에 추가 설명을 넣을 경우에는 별도 제목 없이 문단이나 목록 등으로 구성합니다. 설명 내용을 묶겠다는 이유로 이 위치에 제목을 추가하면, 제안 문서가 정한 제목 없는 설명 영역과 맞지 않게 됩니다.

H2와 링크 목록의 문법

상세 파일로 연결하는 목록은 H2 제목으로 나누며, 제목 모양은 ‘## 목록 제목’입니다. 각 목록 항목에는 ‘[링크 이름](연결 대상)’ 모양의 마크다운 링크가 필요합니다. 링크 뒤에는 선택적으로 콜론과 파일 설명을 덧붙일 수 있습니다.

링크 목록을 넣는 일 자체는 선택 사항이지만, 넣기로 한 목록의 항목에서는 링크가 필수입니다. 목록 제목만 작성하거나 연결 대상 없이 이름만 기재한 상태를 완성된 링크 항목으로 처리하지 않습니다. 이 판단은 파일의 형식에 관한 것이며, 형식 준수를 AI 서비스의 사용이나 검색 노출·인용·순위 보장으로 해석하지 않습니다.

담당자에게 전달할 검사 자료

운영자는 마크다운 원문과 구성 요소별 표시 자료를 담당자에게 전달합니다. 화면을 이미지로 전달하는 것만으로는 제목 기호나 링크 괄호가 실제 파일에 있는지 가리기 어렵습니다. 파일 내용과 함께 각 부분의 시작 위치를 기재하면 담당자가 같은 범위를 검사할 수 있습니다.

마케팅 담당자는 제목·요약·설명·링크 목록이 어느 부분에 해당하는지 표시하고, 기술 담당자는 실제 기호와 BOM 상태를 검사하는 방식으로 업무를 나눌 수 있습니다. 아래 표는 작성 문구를 결정하는 자료가 아니라 문법과 배치에 관한 요청 목록입니다. ‘연결 대상’은 표기 모양을 설명하기 위한 자리표시자이므로 실제 파일에 그대로 남기지 않습니다.

요청서에는 항목을 넣었는지와 검사 결과를 따로 기재합니다. 선택 항목을 사용하지 않은 상태와 사용했지만 문법이 틀린 상태는 수정 여부가 다릅니다. 담당자가 단순히 ‘없음’이라고 회신하면 운영자는 생략한 것인지 작성 중 빠진 것인지 추가로 묻습니다.

제목에서 링크로 진행하는 검사 순서

검사는 필수 제목부터 시작하고 선택 항목의 순서, 링크 문법으로 진행합니다. 앞 단계의 문제가 남아 있으면 뒤 단계의 개별 문구를 다듬기 전에 해당 구조를 먼저 고칩니다. 다음 순서는 파일 내용의 적절성이 아니라 형식의 완성 상태를 판정하기 위한 절차입니다.

1. 담당자는 파일 시작 부분에서 H1 제목을 찾고, 없으면 필수 요소 누락으로 기록합니다. BOM 상태는 별도 항목에 기재합니다.
2. 담당자는 실제로 사용한 선택 항목의 위치를 앞에서 정한 기준과 대조합니다. 순서가 다른 부분과 설명 영역에 추가된 제목을 표시합니다.
3. 담당자는 링크 목록의 각 항목에서 목록 표시와 마크다운 링크를 검사합니다. 선택 설명이 있는 항목은 링크 뒤의 콜론과 설명 위치까지 읽습니다.

운영자는 결과를 받은 뒤 수정할 부분과 그대로 유지할 부분을 결정합니다. 기술 담당자가 수정한 파일에서는 지적된 부분이 해소됐는지 검사하고, 편집 과정에서 주변 항목의 위치가 달라졌는지도 대조합니다. 완료 기록에는 수정 대상과 처리 결과를 짧게 기재합니다.

선택 항목 생략과 작성 오류의 판별

파일을 수정하면서 요약을 삭제했다면, 담당자는 요약이 없어졌다는 사실과 삭제가 승인됐는지를 기록합니다. 추가 설명을 옮겼다면 이동한 위치를 기록하고, 링크 항목을 삭제했다면 목록 전체를 유지하는지 함께 명시합니다. 선택 항목이라는 이유로 모든 변경을 자동 승인하지 않고, 형식 판정과 운영자의 편집 결정을 따로 처리합니다.

마크다운 링크 문법은 파일 안의 텍스트를 기준으로 판정합니다. 편집 도구가 일반 문자열을 클릭 가능한 형태로 표시하더라도, 그 화면 반응만으로 필요한 링크 문법이 작성됐다고 결론내리지 않습니다. 담당자는 변환된 화면과 실제 파일 내용의 차이를 기록하고 실제 파일에서 수정할 부분을 지정합니다.

재검사에 필요한 위치와 수정 기록

오류 기록에는 문제의 위치, 현재 표기, 요청한 수정을 남깁니다. ‘링크가 잘못됨’처럼 넓은 표현 대신 어느 목록의 어떤 항목에서 괄호나 링크 구조가 문제인지 기재합니다. 제목과 목록 이름이 비슷하면 해당 문구 주변의 짧은 내용을 함께 기록해 수정 대상을 특정합니다.

위치가 모호한 요청은 담당자가 의도하지 않은 항목을 고칠 수 있으므로, 운영자는 전달 전에 수정 대상이 명확한지 가립니다. 여러 항목에 같은 문제가 있어도 대표 항목만 기재하고 나머지를 처리했다고 간주하지 않습니다. 각 대상의 처리 상태를 남겨 재검사할 범위를 정합니다.

수정 전후 기록은 파일 전체를 매번 설명하는 문서로 만들 필요가 없습니다. 운영자는 달라진 부분과 아직 결정하지 않은 부분을 나눠 기재하고, 담당자는 각 요청의 처리 여부를 회신합니다. 최종 파일에 남은 문법 문제와 운영자가 보류한 편집 요청을 서로 다른 상태로 관리합니다.

검사 메모와 파일 내용의 분리

담당자에게 보내는 검사 메모는 llms.txt 파일 내용과 따로 관리합니다. ‘제목 수정 필요’, ‘연결 대상 입력 예정’ 같은 작업 문구가 파일에 남아 있으면, 의도한 설명인지 처리 전 메모인지 판정하기 어려워집니다. 운영자는 편집 지시와 공개할 텍스트를 서로 다른 자료로 전달합니다.

자리표시자는 표기 모양을 공유할 때 사용할 수 있지만, 실제 항목을 검사하는 단계에서는 남아 있는 위치를 기록합니다. 괄호가 갖춰졌다는 이유만으로 입력을 마쳤다고 처리하지 않습니다. 담당자는 문법 검사를 통과한 상태와 입력이 완료된 상태를 따로 회신하고, 운영자는 미완료 항목의 처리 여부를 결정합니다.

이어서 읽을 주제

병원 기관 정보 정비는 파일의 형식을 이해한 뒤 실제 기관 정보의 관리 기준을 정하려는 독자가 이어 읽을 주제입니다. 마크다운 문법 검사와 정보 자체의 정비는 담당자에게 요청하는 자료와 판단 범위가 달라 별도로 정리할 필요가 있습니다.