AI & Tools

소개Copy Anchor Link

Rebar 는 AI 도구와 함께 쓰기 좋도록 문서를 Markdown 으로, 컴포넌트를 shadcn registry 로 제공해요. AI 에게 문서를 컨텍스트로 주면 토큰 유틸과 컴포넌트 API 를 정확히 지켜 코드를 써요.

llms.txtCopy Anchor Link

llms.txt 는 LLM 이 사이트 구조를 빠르게 파악하도록 돕는 표준 형식이에요. AI 도구에 아래 주소를 알려주면 필요한 페이지를 골라 읽을 수 있어요.

<site>/llms.txt

문서 전체를 한 번에 컨텍스트에 넣고 싶다면 llms-full.txt 를 써요. 분량이 크므로 컨텍스트가 넉넉한 모델에 알맞아요.

<site>/llms-full.txt

페이지별 Markdown 복사Copy Anchor Link

모든 문서 페이지 제목 아래에 Markdown 복사(Copy Markdown) 버튼이 있어요. 누르면 지금 보고 있는 페이지의 본문이 Markdown 으로 복사돼서, 채팅에 바로 붙여 넣을 수 있어요.

같은 내용을 주소로도 받을 수 있어요. 페이지 경로 뒤에 content.md 를 붙이고 앞에 /llms.mdx 를 붙여요.

<site>/components/action-button
→ <site>/llms.mdx/components/action-button/content.md

shadcn registry 와 AI 도구Copy Anchor Link

shadcn registry 는 AI 도구가 컴포넌트를 설치하는 표준 통로이기도 해요. AI 에게 registry 주소를 알려주면 shadcn add 명령으로 컴포넌트를 직접 추가할 수 있어요.

프롬프트로 알려주기Copy Anchor Link

이 프로젝트는 Rebar 의 Clay 디자인 시스템(SEED 계열)을 써.
- 문서: <site>/llms.txt
- 컴포넌트 설치: pnpm dlx shadcn@latest add <site>/r/<name>.json
- 테마가 없으면 먼저 <site>/r/clay-theme.json 을 설치해.
- 색·간격·모서리·글자는 bg-bg-*, text-fg-*, p-x4, rounded-r2, text-t4 같은 토큰 유틸만 써.

components.json 에 registry 등록Copy Anchor Link

components.json 에 registry 를 등록하면 AI 도구와 사람이 같은 짧은 이름을 쓸 수 있어요.

{
  "registries": {
    "@rebar": "<site>/r/{name}.json"
  }
}

pnpm dlx shadcn@latest add @rebar/action-button @rebar/text-field

shadcn MCPCopy Anchor Link

shadcn CLI 는 registry 를 탐색하고 설치하는 MCP 서버를 제공해요. 위처럼 components.json 에 registry 를 등록한 뒤, 사용하는 AI 도구에 shadcn MCP 를 연결하면 "Clay 버튼이랑 체크박스 추가해 줘" 같은 요청으로 컴포넌트를 찾아 설치할 수 있어요.

pnpm dlx shadcn@latest mcp init

자세한 설정은 shadcn MCP 문서를 참고해요.

프로젝트 규칙 파일Copy Anchor Link

AI 도구가 매번 같은 규칙을 지키게 하려면 프로젝트 규칙 파일(AGENTS.md, CLAUDE.md, .cursor/rules 등)에 아래 내용을 넣어 두면 좋아요.

## 디자인 시스템
- UI 는 Clay 컴포넌트(`@/components/ui/*`)를 먼저 쓴다. 없으면 `<site>/r/registry.json` 에서 찾아 shadcn 으로 설치한다.
- 스타일은 토큰 Tailwind 유틸만 쓴다: bg-bg-*, text-fg-*, border-stroke-*, p-x*, gap-x*, rounded-r*, text-t*, shadow-s*.
- 임의 hex 색, 임의 px 간격을 쓰지 않는다.
- 문서: <site>/llms.txt