AI 코딩 도구를 쓰다 보면 “모델을 더 좋은 걸로 바꾸면 해결될까?”라는 생각이 듭니다. 그런데 현장에서는 의외로 “모델보다 규칙 파일이 더 중요하다”는 이야기가 자주 나옵니다. 이번 글에서는 65줄짜리 마크다운 규칙이 전 세계 개발자 사이에서 유행한 이유와, 그걸 VS Code·Cursor에서 확장으로 써봤을 때 무엇이 바뀌고 무엇이 안 바뀌는지 정리해봅니다.1
AI 코딩 규칙 파일이 하는 일: 모델 위에 얇은 ‘팀의 뇌’ 올리기
규칙 파일은 AI에게 주는 “상시 브리핑”에 가깝습니다. 우리 팀의 코딩 스타일, 쓰는 라이브러리, 금지 패턴, 폴더별 관례 같은 걸 자연어로 적어두고 매번 자동으로 깔아주는 방식이죠.
재미있는 건, 이게 단순한 취향 싸움이 아니라는 점입니다. Cursor 룰 파일을 대규모로 분석한 연구는 개발자들이 규칙에 담는 내용을 다섯 부류(컨벤션, 가이드라인, 프로젝트 정보, LLM 지시, 예시)로 분류했고, “프롬프트 한 방”보다 “지속되는 문맥”이 실무 품질에 영향을 준다고 설명합니다.2 결국 규칙 파일은 AI가 프로젝트 맥락을 ‘까먹지 않게’ 만드는 최소 장치입니다.
Karpathy 스타일 65줄 가이드가 히트한 이유: 뻔한 말인데, 그래서 먹힌다
화제의 가이드는 거창한 플러그인이 아니라 65줄 남짓한 마크다운 파일입니다.1 핵심 메시지는 요약하면 “코드 치기 전에 먼저 생각하고, 계획을 말로 정리하고, 그 다음에 움직이자” 같은 상식에 가깝습니다.
그런데 이 뻔한 문장이 AI 코딩에서 힘을 가집니다. AI는 속도가 빠른 대신 과감하게 ‘그럴듯한’ 길로 새기 쉬운데, 규칙이 그 성향을 살짝 보수적으로 돌려놓습니다. 실제로 생산성 가이드를 다루는 글들에서도 공통으로 “계획→구현→검증 루프”를 강조합니다. AI에게는 특히 “먼저 계획만” 시키는 단계가 사고를 정렬하는 안전장치가 됩니다.34
VS Code·Cursor 확장으로 배포해보니: ‘작은 파일’이 ‘큰 절차’에 막힌다
규칙을 내 로컬에서 쓰는 건 쉽지만, 남도 쓰게 “확장”으로 배포하는 순간 난이도가 급상승합니다. VS Code 마켓플레이스는 새 퍼블리셔에게 신뢰 경고가 붙을 수 있고, 이를 해소하려면 검증 대기 같은 절차를 거칩니다.1
Cursor 쪽은 보통 Open VSX와 맞물리는데, 여기도 퍼블리셔 네임스페이스를 클레임하고 토큰을 만들고 계정 연동을 끝내는 등 단계가 늘어납니다.5 게다가 2026년부터 Open VSX는 공급망 공격을 줄이기 위해 사전 보안 점검을 강화하겠다고 밝혔습니다.6 “규칙 파일 하나 배포”가 생각보다 까다로운 이유가 여기 있습니다. 생태계가 커질수록 검증과 보안이 필수가 되니까요.
그래서 효과는? “마법”은 아니고, 평균을 조금 올린다
직접 리팩터링 같은 단순 과제로 체감 실험을 해보면, 규칙을 넣었을 때 AI가 더 신중해진 느낌은 받을 수 있습니다.1 다만 결과물이 매번 확실히 좋아진다고 말하긴 어렵습니다. 생성형 모델은 같은 조건에서도 결과가 흔들리고, 규칙도 그 흔들림을 “완전히 고정”시키진 못합니다.
이 지점에서 기대치를 조정하는 게 중요합니다. 규칙 파일은 AI를 천재로 만드는 비법서가 아니라, 우리 팀 코드베이스에 덜 해를 끼치게 만드는 가드레일에 가깝습니다. 그래서 실무 팁은 간단합니다. 규칙은 작게 시작하고, 실제로 AI가 자주 틀리는 지점이 보일 때마다 한 줄씩 추가하는 방식이 효율적입니다.3
시사점
요즘 AI 코딩은 “거대 모델 + 작은 규칙” 조합으로 굴러갑니다. 모델 교체는 비용이 크지만, 규칙 파일은 오늘 바로 고칠 수 있는 레버리지입니다.
다만 공개된 유명 규칙을 그대로 복사해 쓰기보다는, 우리 팀의 폴더 구조와 리뷰 기준, 금지 패턴을 반영해 ‘우리 버전’으로 재작성하는 편이 효과가 큽니다. 그리고 목표는 한 가지면 충분합니다. AI가 덜 멋대로 굴고, 우리가 검증 가능한 속도로 개발을 밀어주는 것. 65줄은 그 출발선으로는 꽤 괜찮습니다.1
참고
165 lines of Markdown - a Claude Code sensation | Blog
2Beyond the Prompt: An Empirical Study of Cursor Rules
3The Engineer’s Guide to AI-Assisted Productivity
4Getting the Most Out of AI Coding Assistants
5No Hassle Visual Code Theming: Publishing an Extension
6Eclipse Foundation Mandates Pre-Publish Security Checks for Open VSX Extensions
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.