AI용 파일
이 사이트의 모든 내용은 서버에서 완성된 HTML로 내려가고, 같은 내용을 기계가 읽기 좋은 파일로도 제공한다. AI는 화면을 그릴 필요 없이 아래 파일을 바로 읽으면 된다.
이 페이지의 목차
파일 목록#
| 주소 | 내용 |
|---|---|
| /tds/llms.txt | 문서 목록과 한 줄 요약. 가장 먼저 읽는다. |
| /tds/llms-full.txt | 전체 문서를 하나로 합친 마크다운. |
| /tds/tokens.json | 모든 토큰 값(서비스·라이트·다크별), 용도, 값의 출처. |
| /tds/tokens.css | CSS 변수 파일. 서비스는 data-tds-service, 다크는 data-tds-scheme="dark". |
/tds/{페이지}.md | 페이지별 마크다운: colors.md, typography.md, spacing.md, radius.md, elevation.md, motion.md, icons.md, guidelines.md, inventory.md |
/tds/components/{id}.md | 컴포넌트별 마크다운. 예: primary-button.md. 목록은 components.md. |
모든 페이지의 HTML 머리에도 같은 내용의 마크다운 주소가 link rel="alternate" type="text/markdown"으로 들어 있다.
읽는 순서#
llms.txt로 전체 구조를 본다.colors.md와guidelines.md를 읽는다. 색 이름과 사용 규칙이 모든 판단의 바탕이다.- 만들려는 부품의
components/{id}.md를 읽는다. 사용 방법의 코드를 그대로 쓴다. - 값이 필요하면
tokens.json에서 찾는다.
AI에게 시키는 예#
프롬프트 예
https://developers.moring.co/tds/llms.txt 를 읽고 TDS 규칙을 따라
Morit 서비스의 "자료 삭제 확인" 화면을 만들어 줘.
- 색은 tokens.json의 토큰 이름으로만 쓴다 (HEX 직접 사용 금지).
- 규칙 B1, B3, C4를 지킨다.
- 컴포넌트는 components/*.md 의 사용 방법을 그대로 쓴다.문서의 약속#
- 모든 색은 HEX 값과 토큰 이름을 함께 적는다. 서비스와 모드(라이트·다크)마다 값이 따로 있다.
- 모든 컴포넌트 문서는 같은 제목 순서다: 미리보기, 언제 쓰는가, 종류, 크기, 상태, 사용 방법, 치수와 토큰, 접근성, 잘한 예와 잘못한 예, 함께 보는 컴포넌트.
- 속성 표의 이름, 타입, 기본값은 앱 코드에서 읽은 값이다.
- 코드와 설계 문서가 다르면 코드를 따른다.