AI 코딩 — 규칙과 프롬프트
🚫
규칙을 안 주면 AI는 자기가 아는 색을 씁니다. Tailwind 기본 파랑, 임의 hex, 임의 px. 그 순간 브랜드 통일은 끝납니다. 이 페이지의 3분이 나중의 며칠을 아낍니다.
순서
규칙 파일을 프로젝트에 넣기
프로젝트 루트에 저장합니다. 도구마다 파일명이 다릅니다. (각 도구의 공식 문서로 2026-10-18에 확인)
| 도구 | 읽는 파일 | 참고 |
|---|---|---|
| Claude Code | CLAUDE.md | CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다 |
| Codex (OpenAI) | AGENTS.md | |
| Gemini CLI | GEMINI.md | |
| Antigravity | AGENTS.md 또는 GEMINI.md | .agents/rules/*.md도 있으며, 이 폴더의 파일은 머리말(frontmatter)이 필요합니다 |
| Cursor | .cursor/rules/ 폴더 또는 AGENTS.md | 옛 .cursorrules는 폐기 예정입니다 |
| Windsurf | .devin/rules/ 폴더 또는 AGENTS.md | .windsurf/rules/와 옛 .windsurfrules도 아직 읽습니다. 공식 문서가 docs.devin.ai로 옮겨졌습니다 |
| GitHub Copilot | .github/copilot-instructions.md 또는 AGENTS.md |
도구가 달라도 규칙 내용은 같은 원본(아래 jt-core · jt-legacy)을 씁니다. 파일 이름만 도구에 맞추세요.
내용은 → jt-core (신규 앱) / jt-legacy (기존 앱)
첫 대화에 압축 스펙 붙여넣기
llms.txt를 통째로 복사해 첫 메시지에 붙이세요. 토큰 227개 + 클래스 177개 + 절대 규칙 10개가 8KB로 들어 있습니다.
작업이 끝나면 검사
하드코딩이 남았는지 직접 확인하고, 잡힌 줄을 그대로 AI에게 주세요.
복사용 시스템 프롬프트
이 프로젝트는 JANYTREE 디자인 시스템(JDS) v5.0을 사용합니다.
스펙: https://ds.janytree.app/llms.txt
절대 규칙:
1. 색·크기·간격에 리터럴 값을 쓰지 마세요. hex, rgb(), 임의 px 전부 금지.
반드시 var(--토큰) 을 씁니다.
2. Tailwind 임의값 대괄호 표기 금지 (예: bg-[#305CDE], text-[13px], p-[7px])
3. z-index 숫자 금지. --z-* 토큰만.
4. 원시 팔레트(--blue-500)를 직접 쓰지 말고 Alias(--color-*)만 쓰세요.
5. jt-tokens.css / jt-utilities.css 파일을 수정하지 마세요.
모양을 바꿔야 하면 --jt-* 노브만 덮어씁니다.
6. 고정 width/height 금지. min-width / min-height 를 쓰세요.
7. 판정·상태를 색만으로 전달 금지. 반드시 글자를 함께 넣으세요.
8. 주버튼은 먹색(--color-primary)입니다. 파랑으로 만들지 마세요.
9. 필요한 값이 토큰에 없으면 지어내지 말고 "토큰에 없다"고 알려주세요.
컴포넌트는 .jt-* 클래스를 씁니다 (버튼 .jt-btn, 입력 .jt-input,
표 .jt-table, 배지 .jt-badge-pass 등 총 47종).
작업 후에는 하드코딩된 색·크기가 남았는지 스스로 검사하고 보고하세요.
--- 아래는 JDS v5.0 압축 스펙 ---
(여기에 llms.txt 내용 붙여넣기)효과가 좋은 지시 방식
| 이렇게 ✅ | 이러지 마세요 🚫 |
|---|---|
“.jt-table을 써서 표를 만들어줘” | “표 만들어줘” |
| “이 파일에서 색상 값만 토큰으로 바꿔줘” | “디자인 시스템 적용해줘” |
| “바꾼 내용을 표로 보고해줘” | (보고 요청 없음) |
| “토큰에 없는 값이 필요하면 물어봐” | (알아서 하게 둠) |
| 한 번에 파일 하나 | 한 번에 전체 프로젝트 |