여기서 말하는 Rules, Skills, Subagents, Memory, Hooks는 주로 Claude Code/Claude 기반 코딩 에이전트 환경에서 정리된 개념 체계에 가깝습니다.
Cursor, Codex, Gemini CLI, Windsurf 같은 다른 AI 코딩 도구들도 비슷한 기능을 제공하지만, 명칭과 저장 위치, 호출 방식은 도구마다 다를 수 있습니다.
따라서 이 표는 모든 코딩 에이전트의 공통 표준이라기보다, Claude를 기준으로 AI 코딩 에이전트의 구성요소를 이해하기 위한 대표 모델로 보면 됩니다.
유사점과 차이점 두개의 코딩 에이전트를 혼합해서 사용하는 방법은 후에 다루겠습니다.
추가로 중요한 점은 이 다섯 요소가 서로 독립적으로만 작동하는 것이 아니라, 실제 개발 워크플로우에서는 함께 조합된다는 점입니다.
이 5대 구성요소는 AI 코딩 에이전트를 단발성 챗봇이 아니라 지속적으로 프로젝트 맥락을 이해하고, 반복 작업을 표준화하며, 실수를 줄이는 개발 인프라로 만드는 핵심 장치입니다.
| 개념 | 역할 | 호출/적용 방식 | 사용 시기 | 저장 위치 |
|---|---|---|---|---|
Rules (CLAUDE.md) | 세션 전반 기본 표준 | 세션 시작 시 자동 로드 | 모든 작업에 항상 적용할 규칙 | ~/.claude/CLAUDE.md, ./.claude/CLAUDE.md, ./CLAUDE.md |
| Skills | 재사용 가능한 작업 플레이북 | 자동 감지 또는 /skill-name 직접 호출 | 반복 작업, 팀 컨벤션, 도메인 지식, 수동 실행 워크플로우 | ~/.claude/skills/, ./.claude/skills/ |
| Subagents | 독립 컨텍스트를 가진 전문 에이전트 | Claude가 위임하거나 사용자가 명시 요청 | 대규모 탐색, 보안/성능/아키텍처 검토, 컨텍스트 격리 | ~/.claude/agents/, ./.claude/agents/ |
| Memory | 세션 간 학습 내용 저장 | Claude가 축적하고 사용자가 /memory에서 확인 | 반복 수정사항, 디버깅 패턴, 프로젝트 운영 지식 | ~/.claude/projects/<project>/memory/ |
| Hooks | 특정 시점에 자동 실행되는 결정적 자동화 | 이벤트 발생 시 자동 실행 | 위험 명령 차단, 편집 후 lint/test, 완료 조건 검증, 알림/로그 | settings.json, Skill/Agent frontmatter, Plugin |
핵심 원칙은 간단합니다.
항상 따라야 하면 Rules, 상황별 지식과 절차는 Skills, 큰 탐색과 검토는 Subagents, 반복해서 배운 것(반복 실패 교정)은 Memory, 반드시 자동으로 실행되어야 하는 검사는 Hooks로 둡니다.
