agent-rules
무엇인가
agent-rules는 코딩 에이전트가 작업 중 참조할 규칙과 지식을 마크다운 문서로 축적하는 저장소다. 코드를 어떻게 고치고 어떤 절차를 따를지를 사람이 매번 프롬프트로 설명하는 대신, 파일로 고정해 두는 영역을 다룬다.
어떻게 동작하나
규칙은 실행 코드가 아니라 텍스트 파일로 존재한다. SKILL.md, CLAUDE.md, AGENTS.md 같은 형식이 쓰이며, 에이전트가 작업을 시작할 때 해당 파일을 읽어 컨텍스트에 넣는 방식으로 발동한다. 저장소는 이런 규칙 문서를 모아 둔 skill-file 유형이다.
무엇과 다른가
프롬프트에 규칙을 직접 적어 넣는 방식과 달리, 규칙이 파일로 분리되어 버전 관리되고 여러 세션과 여러 사람에게 같은 내용이 적용된다. 플러그인이나 실행 스크립트가 아니라 문서 자체를 배포 단위로 삼는다는 점에서 prompt-pack·plugin과 구분된다.
어떻게 쓰나
README에는 별도 설치 명령이 없다. 저장소의 규칙 파일을 프로젝트 루트나 에이전트가 읽는 설정 위치에 두고, 에이전트가 그 파일을 참조하도록 연결하는 방식으로 쓴다. README는 이 저장소가 2025년 중반 Cursor를 쓰던 시기의 작업물이며 후속 작업은 steipete/agent-scripts로 옮겼다고 밝힌다.
전제와 한계
지원 대상은 Claude Code이며 저장소 설명에는 Cursor도 함께 언급된다. 규칙이 텍스트이므로 에이전트가 반드시 따르도록 강제하는 런타임 검증은 없고, 모델이 파일을 읽지 않으면 적용되지 않는다. README가 스스로 구버전이라 밝히므로 새 프로젝트에는 후속 저장소를 우선 검토해야 한다.
관련 논문 1
유사 스킬
- nopua위협과 평가 압박 대신 신뢰를 전제로, 에이전트가 불확실성을 밝히고 완료 전 검증과 숨은 결함 탐색을 수행하도록 규칙을 주입하는 Claude Code용 프롬프트 팩이다.
- guard-skills코딩 에이전트가 만든 코드·테스트·문서를 커밋 전에 검토하는 가드 스킬 묶음이다. Skills CLI로 설치해 diff 단위로 적용한다.
- andrej-karpathy-skillsClaude Code에 적용하는 단일 CLAUDE.md 지침 파일이다. Karpathy가 지적한 LLM 코딩 실수를 네 가지 원칙으로 막는다.
- pm-claude-skillsPRD 작성·계약서 해독·사후 분석 등 업무별 절차를 SKILL.md로 주입해 프레임워크·출력 템플릿·품질 검사·안티패턴에 따라 산출물을 내도록 강제하는 Claude Code 플러그인이다.