Quick Reference

Karpathy Guidelines는 코딩 에이전트가 구현 전에 가정을 드러내고, 필요한 최소 변경만 한 뒤, 검증 가능한 완료 조건까지 반복하도록 만드는 지침형 Skill입니다.

핵심 원칙: 구현 전 사고 / 단순함 / 필요한 부분만 변경 / 검증 가능한 목표
적용 대상: Claude Code Plugin, CLAUDE.md, Cursor rule, Agent Skill
성격: Andrej Karpathy의 관찰을 재구성한 커뮤니티 프로젝트
선택: 에이전트의 성급한 가정, 과잉 구현과 관계없는 수정이 반복될 때

언제 쓰는가

에이전트가 질문 없이 한 해석으로 달리거나, 작은 요청에 큰 추상화를 만들거나, 관계없는 코드를 함께 고치는 일이 반복될 때 유용합니다. 저장소는 네 원칙을 Plugin, 프로젝트 지침 파일과 Skill 형태로 제공합니다.

기존 프로젝트 규칙이 있다면 파일을 그대로 덮어쓰기보다 겹치는 항목을 먼저 비교합니다. 신중함을 강하게 요구하는 지침이라 단순한 오탈자 수정까지 같은 절차를 강제하면 속도만 늦어질 수 있습니다.

설치 방식과 지원 클라이언트는 바뀔 수 있으므로 저장소의 최신 README와 실제 지침 내용을 읽은 뒤 적용합니다. 프로젝트 규칙 파일의 역할은 AGENTS.md 기초에서 이어서 확인할 수 있습니다.