문제 해결 가이드
세팅 중 발생하는 흔한 에러와 대처 방법들을 모았습니다.
| 상황 | 조치 |
|---|---|
| AI가 규칙을 무시한다 | 저장했는지 → Always On인지 → 폴더를 워크스페이스로 열었는지 순서로 확인 |
| 규칙이 너무 길다는 경고 | 파일 1개당 12,000자 제한. 규칙과 토큰 값을 한 파일에 넣지 말 것 |
| 색이 이상하다 | "jt-tokens.css의 변수만 써서 다시 맞춰줘" 재요청 |
| 로고가 안 보인다 | "public/brand 경로와 파일명이 정확한지 확인해줘" 요청 |
| 앱이 망가졌다 | 즉시 되돌리기 — "마지막 커밋으로 되돌려줘". 되돌린 뒤 다시 시작하면 됩니다 |
| 글자가 전체적으로 작아졌다 | 전역 글자 크기가 바뀐 것. "body의 font-size 변경을 되돌려줘" 요청 |
| 레이아웃이 틀어졌다 | 간격 토큰이 적용된 것. 채택 레벨을 L1(색만)로 낮춰 재작업 |
| AI가 여러 화면을 한꺼번에 바꿨다 | 되돌린 뒤 "화면 하나씩만 하고 끝나면 멈춰줘"를 다시 강조 |
| 디자인 시스템이 개정됐다 | jt-tokens.css만 새 것으로 통째 교체 → --jt-ds-version 값 확인 → 화면 훑어보기 |