Skip to content

LLM과 함께 읽기 — llms.txt 퀴즈

  1. 이 가이드북이 제공하는 llms.txt 파일의 내용과 용도로 옳은 것은?
    • A) 한국어 전체 본문을 마크다운으로 담은 파일로, 컨텍스트에 통째로 넣는 용도
    • B) 본문 문서의 제목·요약·순수 Markdown URL 색인으로, LLM이 필요한 페이지만 골라 읽게 하는 용도
    • C) 퀴즈 정답지만 모아 둔 파일로, 채점 자동화 용도
    • D) 다이어그램 이미지(PNG)만 모아 둔 파일로, 슬라이드 제작 용도
정답 보기

정답: B) 본문 문서의 제목·요약·순수 Markdown URL 색인으로, LLM이 필요한 페이지만 골라 읽게 하는 용도

설명: 엔드포인트 표에서 llms.txt는 본문 문서의 그룹·제목·요약과 순수 Markdown URL 색인이며, LLM이 필요한 페이지만 골라 읽게 할 때 쓰는 파일입니다. 각 본문 링크는 /llms/<언어>/<원본 경로>.md 형식이므로 렌더링된 웹페이지의 사이드바나 스크립트 없이 문서 원문만 읽을 수 있습니다. 전체 본문은 별도의 llms-full-ko.txt / llms-full-en.txt가 담당합니다. 퀴즈와 랩은 페이지 단위로 나열되지 않고, ## Optional에 목록 페이지 링크가 언어별로 하나씩 들어갑니다.

  1. 전체 본문(full) 파일은 어떤 언어로 제공되나요?
    • A) 한국어 하나만 (llms-full-ko.txt)
    • B) 한국어와 영어 두 개 (llms-full-ko.txt, llms-full-en.txt)
    • C) 한국어·영어·중국어·일본어·스페인어 다섯 개
    • D) 언어 구분 없이 하나의 llms-full.txt에 모든 언어가 합쳐져 있음
정답 보기

정답: B) 한국어와 영어 두 개 (llms-full-ko.txt, llms-full-en.txt)

설명: 언어별 full 파일은 llms-full-ko.txtllms-full-en.txt입니다. 별도로 llms.txt 색인, manifest, 섹션 번들과 문서별 Markdown도 제공됩니다. 모두 https://www.atomai.click/kubernetes-docs/ 아래에서 제공되며, 한국어 파일은 "컨텍스트에 통째로 넣거나 RAG 인덱싱", 영어 파일은 "영어 기반 도구/파이프라인" 용도로 안내됩니다.

  1. 성공한 사이트 배포의 llms.txt와 full 파일은 어떻게 생성되나요?
    • A) 문서 작성자가 문서를 고칠 때마다 수동으로 세 파일을 다시 업로드하기 때문에
    • B) 매주 실행되는 뉴스 다이제스트 워크플로가 파일을 갱신하기 때문에
    • C) 사이트 빌드에서 문서와 같은 소스로 파일을 생성하고 함께 배포하기 때문에
    • D) LLM이 요청할 때마다 서버가 실시간으로 문서를 변환하기 때문에
정답 보기

정답: C) 사이트 빌드에서 문서와 같은 소스로 파일을 생성하고 함께 배포하기 때문에

설명: 색인·manifest·원문·번들은 사이트 빌드에서 생성되며 성공한 배포 이후 공개됩니다. 로컬 수정이나 배포되지 않은 main 변경이 실시간으로 반영되는 것은 아닙니다. 수동 업로드나 요청 시점의 실시간 변환이 아니라, 배포 파이프라인의 산출물로 생성되는 방식입니다.

  1. 퀴즈 문서는 llms.txt와 full 파일에서 어떻게 다뤄지나요?
    • A) 모든 퀴즈 페이지가 색인과 full 파일 모두에 정답 포함 전문으로 실린다
    • B) llms.txt## Optional에 퀴즈 목록 페이지 링크(언어별 하나)만 들어가고, 개별 퀴즈 페이지와 정답은 색인과 full 파일 어디에도 들어가지 않는다
    • C) 개별 퀴즈 페이지가 모두 색인에 나열되지만 full 파일에서는 빠진다
    • D) 퀴즈 페이지가 full 파일에는 있지만 색인에서는 제외된다
정답 보기

정답: B) llms.txt## Optional에 퀴즈 목록 페이지 링크(언어별 하나)만 들어가고, 개별 퀴즈 페이지와 정답은 색인과 full 파일 어디에도 들어가지 않는다

설명: 문서는 "퀴즈는 llms.txt## Optional 절에 퀴즈 목록 페이지 링크(언어별 하나)로만 등장하고, 개별 퀴즈 페이지(정답 포함)는 색인과 full 파일 어디에도 들어가지 않습니다 — LLM 컨텍스트에 정답지를 섞지 않기 위해서입니다"라고 명시합니다. 즉 퀴즈가 존재한다는 사실과 언어별 목록 페이지 URL은 색인으로 알 수 있지만, 평면 색인에도 본문을 통째로 넣는 full 파일에도 개별 퀴즈 페이지나 정답은 들어가지 않습니다. 랩 가이드는 다릅니다 — 색인에는 마찬가지로 목록 링크로만 나타나지만, full 파일에는 본문이 포함됩니다.

  1. full 파일의 크기와 관련해 문서가 권장하는 LLM 활용 방식은 무엇인가요?
    • A) 수 MiB 규모의 full 파일을 매 프롬프트 컨텍스트에 통째로 넣는 것이 가장 정확하다
    • B) full 파일을 여러 개로 잘라 매번 모두 첨부한다
    • C) 색인(llms.txt)으로 필요한 페이지를 고르게 하는 편이 대부분의 도구에서 더 잘 동작한다
    • D) 다이어그램 뷰어 URL만 넘기면 LLM이 나머지를 추론한다
정답 보기

정답: C) 색인(llms.txt)으로 필요한 페이지를 고르게 하는 편이 대부분의 도구에서 더 잘 동작한다

설명: 형식 안내의 "크기 주의" 항목은 full 파일이 수 MiB 규모이므로 "한 번의 프롬프트 컨텍스트에 다 넣기보다, 색인(llms.txt)으로 필요한 페이지를 고르게 하는 편이 대부분의 도구에서 더 잘 동작합니다"라고 권장합니다. 활용 예시의 첫 프롬프트("llms.txt 를 읽고, … 문서를 찾아 … 요약해줘")가 바로 이 방식입니다. full 파일은 RAG 인덱싱처럼 통째로 내려받아 청킹하는 용도에 맞습니다.

  1. llms-full-*.txt에서 문서 단위 청킹이 쉬운 이유는 무엇인가요?
    • A) 각 문서가 별도의 ZIP 엔트리로 압축되어 있기 때문에
    • B) 각 문서 앞에 Source: <URL>이 들어간 구분자 블록이 붙어 있기 때문에
    • C) 문서마다 고정 길이 4,096자로 잘려 있기 때문에
    • D) JSON 배열 형식으로 문서가 하나씩 담겨 있기 때문에
정답 보기

정답: B) 각 문서 앞에 Source: <URL>이 들어간 구분자 블록이 붙어 있기 때문에

설명: 형식 안내에 따르면 full 파일은 "문서마다 아래 구분자 블록이 앞에 붙습니다" — 대시 줄, Source: https://www.atomai.click/kubernetes-docs/ko/core/01-cluster-architecture 같은 원본 URL, 다시 대시 줄로 이루어진 블록입니다. RAG 예시의 주석도 "각 문서는 Source: <URL> 구분자로 나뉘어 있어 문서 단위 청킹이 쉽습니다"라고 설명합니다. 파일 자체는 마크다운 텍스트이며 ZIP이나 JSON이 아닙니다.

  1. full 파일에 담긴 다이어그램 정보를 LLM과 사람이 각각 어떻게 활용한다고 설명하나요?
    • A) LLM은 PNG 이미지를 직접 분석하고, 사람은 alt 텍스트를 읽는다
    • B) LLM은 다이어그램 설명(alt 텍스트)으로 내용을 파악하고, 사람은 인터랙티브 뷰어 URL을 열어 Export 메뉴로 PNG/JPEG/WebP, SVG, WebM, Share Card를 받는다
    • C) LLM과 사람 모두 full 파일에서는 다이어그램 정보를 전혀 얻을 수 없다
    • D) LLM이 뷰어 URL에서 WebM 애니메이션을 생성해 사람에게 전달한다
정답 보기

정답: B) LLM은 다이어그램 설명(alt 텍스트)으로 내용을 파악하고, 사람은 인터랙티브 뷰어 URL을 열어 Export 메뉴로 PNG/JPEG/WebP, SVG, WebM, Share Card를 받는다

설명: "다이어그램은 사람에게 — 내보내기 링크" 섹션은 full 파일이 마크다운을 그대로 담기 때문에 각 다이어그램의 alt 텍스트와 뷰어 URL(https://www.atomai.click/kubernetes-docs/archmaps/<이름>.html)이 텍스트로 들어 있다고 설명합니다. 텍스트 LLM은 alt 텍스트와 주변 본문만으로 모든 노드·연결을 알 수 없으므로 이미지 전용 정보는 별도로 확인해야 합니다. 사람은 URL을 열어 뷰어의 Export 메뉴에서 PNG/JPEG/WebP, 라이트·다크 겸용 SVG, 트레이스 애니메이션 6초 WebM, 1200×630 Share Card를 받습니다. 메뉴 항목별 용도는 가이드북 로드맵의 "다이어그램 공유하기" 섹션에 정리되어 있습니다.

  1. 뷰어에서 내보낸 다이어그램 파일(PNG, SVG, WebM, Share Card)의 성격에 대해 문서가 밝히는 한계는 무엇인가요?
    • A) 내보낸 파일은 아키텍처가 검증됐다는 공식 증거로 사용할 수 있다
    • B) 내보낸 파일은 커뮤니케이션 자산일 뿐, 아키텍처 검증 증거는 아니다
    • C) 내보낸 파일은 LLM 전용이며 사람이 열어 볼 수 없다
    • D) 내보낸 파일은 원본 HTML 문서를 대체하는 정식 배포본이다
정답 보기

정답: B) 내보낸 파일은 커뮤니케이션 자산일 뿐, 아키텍처 검증 증거는 아니다

설명: 섹션 마지막 문장은 "내보낸 파일은 커뮤니케이션 자산일 뿐, 아키텍처 검증 증거는 아닙니다"라고 못박습니다. 다이어그램 내보내기는 LinkedIn 포스팅이나 발표 자료 같은 공유 목적에 쓰이는 것이며, 그 이미지가 있다고 해서 아키텍처가 검증되었음을 뜻하지 않습니다.