nuxt-ui-rules
무엇인가
Nuxt UI v3 컴포넌트 라이브러리를 다루는 AI 코딩 에이전트의 출력을 규율하는 규칙 문서다. 컴포넌트 props·슬롯·테마 설정의 v3 기준 표기, v2에서 제거되거나 이름이 바뀐 API, 접근성·성능·TypeScript 관련 권장 패턴을 규칙 항목으로 고정한다.
어떻게 동작하나
규칙은 마크다운 파일 두 개로 배포된다. nuxt-ui.md는 약 600줄로 v2→v3 전체 마이그레이션 목록과 테마·성능·접근성·TypeScript 고급 패턴을 담고, nuxt-ui-minimal.md는 약 140줄로 핵심 파괴적 변경과 자주 발생하는 실수만 남긴다. SKILL.md식 프런트매터나 훅, 슬래시 명령은 없고, 에이전트가 컨텍스트에 읽어 들이는 참조 문서로 동작한다.
무엇과 다른가
프롬프트에 Nuxt UI 주의사항을 매번 직접 적는 방식과 달리, 버전이 고정된 단일 참조 문서를 재사용한다. 프로젝트 전반 규칙을 담는 CLAUDE.md·AGENTS.md와도 분리되어 있어 Nuxt UI 관련 지침만 골라 붙일 수 있고, 토큰 한도에 맞춰 완전판과 최소판 중 하나를 선택하는 구조다.
어떻게 쓰나
Claude Code에서는 규칙 파일을 프로젝트 안(예: rules/nuxt-ui.md)에 두고 프롬프트에서 @경로로 멘션해 해당 세션 컨텍스트에 로드한다. Cursor에서는 설정의 Rules for AI 탭에 내용을 붙여 넣거나 .cursor/rules/nuxt-ui.mdc 파일로 저장한다. 별도 설치 명령은 없다.
전제와 한계
Claude Code, Cursor, Windsurf 등 규칙 파일을 읽는 어시스턴트를 대상으로 하며, Nuxt UI v3를 쓰는 프로젝트를 전제로 한다. 자동 발동이나 위반 차단 장치가 없어 멘션하거나 붙여 넣지 않으면 적용되지 않고, 최소판은 고급 패턴과 상세 마이그레이션 항목을 생략한다.