문제
가이드는 있는데, 아무도 열지 않습니다
시안과 개발을 몇 번 오가면 가이드 문서는 잊히고, 같은 질문이 매번 다시 나옵니다. AI가 화면을 만들수록 더 그렇습니다.
01AI는 우리 가이드를 모른 채 그럴듯한 기본값으로 만듭니다
02검수는 사람 눈에 기대고, 어떤 규칙을 근거로 고쳤는지 남지 않습니다
03어떤 규칙이 실제로 쓰이는지 몰라 가이드가 낡아 갑니다
UX_GUIDE.md마지막으로 연 날 · 94일 전
결제 버튼 색, 우리 기준이 뭐였죠?화요일 · 디자인 채널
입력칸 테두리 이 정도면 되나요?수요일 · 개발 채널
에러 문구 톤, 누가 정리한 거 있나요?금요일 · 기획 채널
작동 방식
찾고, 고치고, 근거를 남깁니다
Claude Code가 화면을 만들다 가이드가 필요한 순간, Carvit UX가 우리 회사 가이드에서 맞는 절을 건넵니다.
1 · 찾기
필요한 절만 꺼냅니다
§1.35입력칸은 경계가 늘 보인다테두리는 --input 이상으로 진하게, 안내 문구는 늘 표시
2 · 고치기
그 절대로 코드를 고칩니다
lock-screen.css
- .pin input{ border:1px solid var(--border); }
+ .pin input{ border:1px solid var(--input); }
+ .pin .hint{ display:block; } /* 안내 "PIN 6자리" 늘 표시 */
3 · 근거 남기기
어떤 규칙으로 고쳤는지 기록합니다
09:41PIN 칸 테두리를 --input으로§1.35 입력칸은 경계가 늘 보인다
10:12설치 명령어를 끊지 않고 복사 버튼§1.13 잘리는 글자는 전체를 볼 수단을
4 · 보이기
실제로 쓰이는 규칙이 보입니다
위 화면 조각의 숫자와 시각은 예시입니다. 실제 기록은 아래 증거에 있습니다.
증거
우리 팀이 매일 쓰고 있습니다
우리 팀 내부 가이드(UX_GUIDE.md)에 실제로 쌓인 인용입니다. 부풀리지 않았습니다.
19인용
10일2026-09-04부터
16개가이드 절
UX_GUIDE.md 인용 리포트
2026-09-14절많이 쓴 규칙인용
인용 총합 19건(커밋 기록 기준). 2026-09-04 도입 당시 5건에서 10일 동안 쌓였고, 16개 절 중 10개는 아직 인용 0건입니다.
믿을 수 있는 이유
무엇을 받고, 무엇을 남기지 않는지
회사 이름 대신 동작으로 말씀드립니다. 서버 코드로 확인한 내용입니다.
보관하는 것등록한 가이드 문서, 어떤 절을 읽고 인용했는지(인용 메모 포함), 찾지 못한 검색어, 피드백, 가입 정보(이메일·이름·회사·직무)
보관하지 않는 것코드 검사(check_diff_violations)에 넣은 코드는 비교만 하고 저장하지 않습니다. 비밀키는 해시만 둡니다
외부 AI조회·인용·검사는 외부 AI를 부르지 않습니다. 새 규칙 제안(suggest_section)만 그 절의 인용 메모를 Google Gemini에 보냅니다
회사끼리다른 회사 사용자는 우리 회사 가이드와 기록을 볼 수 없습니다
실제 사용 기록: 우리 팀 인용 19건(커밋 기록 기준, 기준일 2026-09-14). 지어낸 고객 로고·후기는 싣지 않습니다.
만든 사람의 말
저는 작은 팀에서 AI와 함께 제품을 만듭니다. 공들여 쓴 UX 가이드가 있었지만, AI는 화면을 만들 때마다 그 가이드를 모른 채 그럴듯한 기본값으로 만들었습니다. 같은 지적을 매번 되풀이하다가, 가이드를 문서함이 아니라 코딩하는 자리에 두기로 했습니다. Carvit UX는 그렇게 시작했고, 지금도 우리 팀이 매일 쓰면서 고치고 있습니다. 위의 인용 기록이 그 흔적입니다.
Claude Code화면을 만드는 중
검색어 → lookup
Carvit UX우리 회사 가이드에서 절 찾기
절 본문 ←
Claude가 고침그 절의 값대로
인용 메모 → cite
인용 기록절 번호 · 메모 · 날짜
집계
대시보드우리 회사만 봄
시작하기
명령어 한 줄이면 연결됩니다
지금은 승인된 회사에 한해 제공합니다. 가입하면 이 명령어가 비밀키와 함께 나옵니다.
claude mcp add --transport http carvit <가입 화면에서 받은 주소> --scope user --header "Authorization: Bearer <가입 화면에서 받은 값>"
1
가입하기
이메일, 이름, 회사명만 입력합니다. 승인된 회사가 아니면 그 자리에서 안내가 뜹니다.
2
명령어 붙여넣기
나온 명령어를 Claude Code 대화창에 붙여넣습니다. 비밀키는 그 순간에만 보이니 꼭 저장하세요.
3
그냥 물어보기
"UX 가이드에서 타이포그래피 관련 절 찾아줘"처럼 말하면 됩니다.
자주 묻는 것
문제가 생겼다면
DESIGN.md를 이미 쓰고 있어요
그대로 가져오세요. 연결한 뒤 Claude Code에 "우리 DESIGN.md를 Carvit UX로 가져와 줘"라고 하면 절마다 가이드가 됩니다. 처음 가져오면 바로 찾기·코드 검사에 쓰이고, 이미 가이드가 있으면 초안으로 올라가 지금 가이드는 그대로입니다. 이전 판도 모두 남습니다. 거꾸로 Carvit UX 가이드도 구글 DESIGN.md 규격 그대로 내보낼 수 있습니다.
비밀키를 잃어버렸어요
이 링크에서 가입할 때 쓴 이메일을 입력하고 "인증 메일 보내기"를 누르세요. "[Carvit UX] 비밀키 재발급 링크" 메일이 30분 안에 옵니다(스팸함 포함). 링크를 열고 "새 비밀키 발급"을 누르면 새 명령어가 나오고, 이전 비밀키는 자동으로 무효화됩니다.
회사명이 승인 목록에 없다고 나와요
Carvit UX는 지금 승인된 회사만 가입할 수 있습니다. 아래 문의 주소로 알려 주시면 확인해 드립니다. 승인되면 같은 화면에서 다시 가입하시면 됩니다.
Cursor·Antigravity로 연결하고 싶어요
가입 메일의 명령어에서 주소(
/mcp로 끝나는 부분)와 비밀키(: 뒤)를 확인한 뒤, 도구의 AI 입력창에 아래 문장을 붙여 넣으세요. 도구가 MCP 설정을 대신 만들어 줍니다. Claude Code는 가입 메일의 명령어 그대로 쓰면 됩니다.아래 MCP 서버를 이 도구에 추가해 줘. 이름: carvit / 종류: 원격 HTTP / 주소: <주소> / 요청 헤더 Authorization: Bearer <비밀키>
예전에 saegim이라는 이름으로 연결했어요
이름만 carvit으로 바뀌었고, 비밀키와 주소는 그대로 씁니다. 터미널에서 아래 두 줄을 차례로 실행하세요. 두 번째 줄의 주소와 비밀키는 가입 메일에 있던 명령어의 값을 그대로 넣으면 됩니다.
claude mcp remove saegim --scope user claude mcp add --transport http carvit <주소> --scope user --header "Authorization: Bearer <비밀키>"비밀키를 잃어버렸다면 위 "비밀키를 잃어버렸어요"대로 새 명령어를 받으세요(새 명령어는 이미 carvit입니다).
우리 회사의 다른 파일도 볼 수 있나요
아니요. Carvit UX는 각 회사에 등록된 UX 가이드 문서만 조회·인용합니다. 다른 파일이나 대화 내용에는 접근하지 않습니다.