AI 친화 문서 포맷 생성 — llms.txt 생성 자동화 by RiaOh · Pull Request #100 · DaleStudy/daleui.com

RiaOh · 2026-07-10T02:20:43Z

배경

LLM이 DaleUI를 쉽게 이해할 수 있도록 www.daleui.com 사이트를 토대로 llmstxt.org 규약에 따른 llms.txt를 자동 생성하는 스크립트를 추가했습니다.
이 파일은 daleui npm 패키지에 포함되어 배포되며, https://www.daleui.com/llms.txt로 서빙되어야 합니다.

수정 전:
daleui 레포 PR 머지 + npm 배포 (llms.txt 포함된 버전) → daleui.com: Dependabot이 daleui 버전 bump PR 생성 → 버전 bump PR 머지 → 재빌드 시 copy 스크립트가 llms.txt 복사 → https://www.daleui.com/llms.txt 서빙

수정 후: daleui.com에서 자체적으로 generate-llms-txt.mts 생성스크립트로 파일 생성

llms.txt
llms-full.txt : 실제 mdx파일이 있는 문서 전체
llms-foundations.txt : 파운데이션
llms-components.txt(현재 mdx파일이 없으므로 생성x) : 컴포넌트

해야 할 일

llms.txt 파일 등이 gitignore에 추가하여 해당 파일이 github에는 올라와있지 않습니다.
bun run generate-llms 명령어를 통해 생성해야합니다.

테스팅

현재 아직 배포 전이므로 www.daleui.com/llms.txt 접속 시, 아래와 같은 404페이지가 뜹니다.

체크 리스트

코드 리뷰를 요청하기 전에 반드시 CI가 통과하는지 확인해주세요.
Cloudflare Preview URL에서 수정한 내용이 의도대로 잘 동작하는지 확인해 주세요.

github-actions · 2026-07-10T02:21:24Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Ready View logs	daleui	`05ceba9`	Commit Preview URL	Oct 01 2026, 01:54 PM

hyoseong1994 · 2026-07-10T05:59:34Z

이 티켓이 아니고 별도 티켓으로 만드신거같은데 맞을까요?

RiaOh · 2026-07-18T02:59:58Z

@hyoseong1994

https://github.com/DaleStudy/daleui.com/issues/26이 아니고 별도 티켓으로 만드신거같은데 맞을까요?

헛 맞습니다. 기존 티켓이 있는줄 몰랐네요.
별도 티켓은 closed하고, 기존 티켓과 링크해두겠습니다.
알려주셔서 감사합니다!

hyoseong1994 · 2026-07-21T02:17:53Z

@RiaOh 안녕하세요 리아님 기존에 작업하신 내용과 티켓은 비슷하지만 차이가 있습니다. 작업진행이 안되고있는거 같아서 혹시나 싶어 남깁니다.

SimYunSup · 2026-07-22T06:24:25Z

    "generate-og": "bun scripts/generate-og.mts",
    "predev": "bun scripts/sync-blog.mts && bun scripts/generate-og.mts",
    "dev": "react-router dev",
-    "prebuild": "bun scripts/sync-blog.mts && bun scripts/generate-og.mts",


prebuild떄 넣는다면 그냥 .gitignore하는 것은 어떤가요?

@SimYunSup 네, llms.txt파일도 .gitignore에 추가해두었습니다.
gitignore에 추가하는건 생각못했었는데, 알려주셔서 감사합니다 :)

RiaOh · 2026-07-23T14:23:58Z

@hyoseong1994

@RiaOh 안녕하세요 리아님 기존에 작업하신 내용과 https://github.com/DaleStudy/daleui.com/issues/26은 비슷하지만 차이가 있습니다. 작업진행이 안되고있는거 같아서 혹시나 싶어 남깁니다.

네, 확인해보겠습니다!

hyoseong1994 · 2026-07-24T06:40:35Z

DaleStudy/daleui#1187 와 비슷한 작업으로 예상됩니다.
draft PR 로 변경하시고 1187 작업에 집중하시어 머지하시고 해당 내용을 바탕으로 PR를 재오픈하는걸 권장드립니다.

RiaOh · 2026-07-24T07:42:33Z

@hyoseong1994

DaleStudy/daleui#1187 와 비슷한 작업으로 예상됩니다.
draft PR 로 변경하시고 1187 작업에 집중하시어 머지하시고 해당 내용을 바탕으로 PR를 재오픈하는걸 권장드립니다.

네, 우선 draft PR로 변경해두었습니다.

RiaOh · 2026-07-24T15:17:45Z

진행상황: 수정작업이 필요할 듯 하여 draft로 변환하였고, daleui작업을 먼저 진행한 다음 이 daleui.com 작업을 이어서 진행할 예정입니다.

RiaOh · 2026-09-03T07:43:32Z

@SimYunSup 님, @hyoseong1994 님,
제가 이 작업에 대해서 다시한번 생각을 해봤는데
현재는 daleui 레포에서 skills와 llms.txt를 자동 생성 -> daleui npm 패키지에 'llms.txt' 포함되어 배포 -> daleui.com에서 copy 스크립트가 llms.txt 복사 → https://www.daleui.com/llms.txt 서빙
이런 방식으로 할 예정이었습니다.
근데 생각해보니 llms.txt 파일을 굳이 daleui에서 만들 필요가 있을까 싶어서요.
daleui.com에서도 컴포넌트, 파운데이션쪽 문서가 곧 생기게되면 그걸 토대로 llms.txt를 만들어도 되지 않을까? 싶었습니다.

daleui에서 skills는 여전히 생성하구요.
어떻게 생각하시나요~?

RiaOh · 2026-09-07T09:04:09Z

수정 예정

이전: daleui 레포에서 llms.txt를 자동 생성 -> daleui npm 패키지에 'llms.txt' 포함되어 배포 -> daleui.com에서 copy 스크립트가 llms.txt 복사 → https://www.daleui.com/llms.txt 서빙
수정방향: daleui.com에서 컴포넌트, 파운데이션 문서를 토대로 llms.txt파일 생성

hyoseong1994 · 2026-09-12T00:51:25Z

수정 예정

이전: daleui 레포에서 llms.txt를 자동 생성 -> daleui npm 패키지에 'llms.txt' 포함되어 배포 -> daleui.com에서 copy 스크립트가 llms.txt 복사 → https://www.daleui.com/llms.txt 서빙

수정방향: daleui.com에서 컴포넌트, 파운데이션 문서를 토대로 llms.txt파일 생성

저는 방향에 대해서 동의합니다.
@SimYunSup 윤섭님은 어떠신가요?

SimYunSup · 2026-09-13T10:48:28Z

좋습니다!

SimYunSup · 2026-09-29T07:05:00Z

+  );
+
+  await mkdir(PUBLIC_DIR, { recursive: true });
+  await writePublic("llms.txt", renderIndex(publishedSets));


이슈 #26에는 페이지별 *.md도 포함되어 있는데, 현재는 묶음 파일만 생성됩니다. 프리뷰 /docs/install.md도 Markdown이 아니라 사이트 HTML을 반환하네요. 이번 PR에서 페이지별 파일까지 생성할 예정인가요? 범위를 나누신 거라면 PR 제목과 이슈에도 표시해두면 좋을 것 같습니다.

아, 네 윤섭님 말씀이 맞습니다! 범위를 나눠야겠네요. 따로 PR 생성하도록 하겠습니다~!

SimYunSup · 2026-09-29T07:05:00Z

+}
+
+function renderIndex(sets: TopicSet[]): string {
+  const setLinks = [


이슈 #26의 llms.txt는 모든 문서 페이지 링크 인덱스인데, 지금은 llms-full.txt와 주제별 묶음 파일만 들어갑니다. 실제 MDX가 있는 문서의 개별 링크도 넣으면 좋을 것 같습니다.

네, 현재 MDX가 있는 문서의 개별링크도 llms.txt파일에 들어가도록 generate-llms-txt.mts파일을 수정했습니다. 감사합니다.

SimYunSup · 2026-09-29T07:05:00Z

+        codes.push(code);
+        return `\0CODE${codes.length - 1}\0`;
+      });
+      const expanded = masked.replace(


install.mdx의 <CodeTabs>와 <CodeTab>은 여닫는 태그라 여기서 변환되지 않고 llms-full.txt에도 그대로 남습니다. 탭 이름은 소제목으로 남기고 태그는 걷어내면 좋을 것 같습니다.

꼼꼼하게 봐주셔서 감사합니다. 반영했습니다. :)

RiaOh self-assigned this Jul 10, 2026

RiaOh requested a review from a team as a code owner July 10, 2026 02:20

RiaOh linked an issue Jul 10, 2026 that may be closed by this pull request

LLM 컨텍스트 제공을 위한 llms.txt 페이지 추가 #99

Closed

RiaOh linked an issue Jul 18, 2026 that may be closed by this pull request

AI 친화 문서 포맷 생성 — llms.txt 및 페이지별 *.md 자동화 #26

Open

4 tasks

RiaOh changed the title ~~LLM 컨텍스트 제공을 위한 llms.txt 페이지 추가~~ AI 친화 문서 포맷 생성 — llms.txt 및 페이지별 *.md 자동화 Jul 18, 2026

SimYunSup reviewed Jul 22, 2026

View reviewed changes

RiaOh marked this pull request as draft July 24, 2026 07:41

RiaOh force-pushed the 99-llms-txt branch from 06cffc8 to d4076e5 Compare September 7, 2026 09:41

RiaOh force-pushed the 99-llms-txt branch from d4076e5 to d74fd17 Compare September 23, 2026 14:57

RiaOh marked this pull request as ready for review September 24, 2026 08:18

SimYunSup reviewed Sep 29, 2026

View reviewed changes

RiaOh force-pushed the 99-llms-txt branch from b4911d8 to 06eed37 Compare October 1, 2026 09:39

RiaOh added 5 commits October 1, 2026 22:54

chore: ignore prebuild-generated public/llms.txt

c5c4c37

chore: add llms files generate script and add llms files in gitignore

72816e3

chore: format with prettier

11c48ad

fix: remove CodeTabs tags and keep labels as headings in llms generator

e998674

feat: list individual MDX docs in llms.txt index

05ceba9

RiaOh force-pushed the 99-llms-txt branch from 06eed37 to 05ceba9 Compare October 1, 2026 13:54

RiaOh changed the title ~~AI 친화 문서 포맷 생성 — llms.txt 및 페이지별 *.md 자동화~~ AI 친화 문서 포맷 생성 — llms.txt 생성 자동화 Oct 1, 2026

RiaOh requested a review from SimYunSup October 1, 2026 14:05

Conversation

RiaOh commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

배경

해야 할 일

테스팅

체크 리스트

Uh oh!

github-actions Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

hyoseong1994 commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

RiaOh commented Jul 18, 2026

Uh oh!

hyoseong1994 commented Jul 21, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

RiaOh commented Jul 23, 2026

Uh oh!

hyoseong1994 commented Jul 24, 2026

Uh oh!

RiaOh commented Jul 24, 2026

Uh oh!

RiaOh commented Jul 24, 2026

Uh oh!

RiaOh commented Sep 3, 2026

Uh oh!

RiaOh commented Sep 7, 2026

Uh oh!

hyoseong1994 commented Sep 12, 2026

Uh oh!

SimYunSup commented Sep 13, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

RiaOh commented Jul 10, 2026 •

edited

Loading

github-actions Bot commented Jul 10, 2026 •

edited

Loading

hyoseong1994 commented Jul 10, 2026 •

edited

Loading