Claude Code Patterns는 개인 업무용 AI 에이전트를 단발성 대화가 아니라, 지식과 작업 규칙이 다음 세션으로 이어지는 시스템으로 운영하기 위한 패턴·안티패턴 컬렉션이다. 코드 작업뿐 아니라 회의 준비, 메일 분류, CRM 분석처럼 개인 데이터와 반복 업무를 연결하려는 고급 사용자에게 특히 유용하다.
세 계층 아키텍처
| 계층 | 역할 | 운영 원칙 |
|---|---|---|
| CLAUDE.md | 정체성, 라우팅, 가드레일 | 백과사전이 아니라 짧은 라우터로 둔다 |
| 스킬·MCP | 외부 데이터와 작업 실행 | 필요한 순간에만 상세 지식을 불러온다 |
| 지식 베이스·훅 | 기억 축적과 강제 규칙 | 결과를 기록하고, 반드시 지킬 규칙은 훅으로 강제한다 |
핵심 플라이휠은 스킬이 외부 데이터를 처리한 뒤, 정제된 결과를 지식 베이스에 다시 저장하고 다음 세션이 이를 활용하는 구조다. 모든 정보를 시작 프롬프트에 넣는 방식보다 컨텍스트 비용과 지시 희석을 줄인다.
적용할 때의 주의점
개인 데이터에 접근하는 에이전트는 “넓은 읽기 권한, 좁은 결과 게이트”가 편리할 수 있지만, 전송·삭제·발행 같은 부작용은 초안 후 승인을 기본값으로 둬야 한다. 훅은 테스트·감사 로그·안전 검사를 강제하는 데 쓰고, 사람이 내려야 할 판단까지 자동화하지 않는다.
처음에는 한 가지 반복 업무와 지식 베이스 하나만 연결한다. 효과가 확인된 뒤 스킬과 훅을 더하는 편이 거대한 CLAUDE.md를 한 번에 만드는 것보다 유지보수하기 쉽다.
관련 문서
- agent-harness — 에이전트 하네스의 구성 요소와 설계 원칙
- agent-skills — 재사용 가능한 절차를 스킬로 패키징하는 방법
- claude-brain — Claude Code 기억을 파일로 관리하는 방식
참고 자료
- AaronRoeF/claude-code-patterns — GitHub 공식 저장소