AI 에이전트를 만들 때마다 매번 똑같은 설명을 반복해야 한다면 얼마나 귀찮을까요? 오늘은 이런 고민을 해결할 claude.md 파일을 직접 만들어봤어요.
22일차가 되니까 에이전트한테 맨날 같은 얘기 하는 게 좀 지겹더라고요. 그래서 한 번 만들어두면 파일만 읽고 알아서 작동하는 AI 에이전트 설계도를 만들기로 했어요.
오늘 목표
블로그 포스팅 에이전트용 claude.md 설계도 파일 완성하기
준비물
- 텍스트 에디터 (메모장도 괜찮아요)
- Claude 접속
- 기존에 정리해둔 글쓰기 규칙들
Step 1: claude.md 파일 기본 틀 만들기
먼저 빈 텍스트 파일을 만들고 claude.md로 저장했어요. 이름은 꼭 claude.md일 필요는 없는데, 보통 이렇게 짓더라고요.
파일을 열고 가장 먼저 에이전트의 역할부터 정했어요:
# AI 초보의 성장일기 블로그 자동 포스팅 에이전트
## 핵심 목표
- 매일 1개 SEO 최적화 글 생성
- WordPress 업로드 자동화
- 일관된 블로그 스타일 유지Step 2: 참조 파일 목록 추가
에이전트가 참고해야 할 다른 파일들을 명시했어요. 이게 없으면 매번 설명해야 하거든요:
## 참조 파일
- blog_style.md: 글쓰기 스타일 가이드
- 내_글쓰기_패턴.txt: 개인적 수정 패턴
- keyword_list.txt: SEO 키워드 목록
Step 3: 글 타입별 규칙 정리
이게 제일 중요한 부분이에요. 그동안 A/B/C/D 타입으로 분류해둔 글쓰기 규칙을 claude.md에 정리했어요:
## 글 타입별 규칙
### A타입: 실습 가이드
- Step 1~N 구조 필수
- 이미지 플레이스홀더 각 Step마다 1개씩
- 명령어는 코드 블록으로 표시
- 초보자 관점에서 서술
### B타입: 경험담 중심
- 문제상황 → 해결과정 → 결과 구조
- 개인적 감정과 시행착오 포함
- "Claude한테 물어봤더니" 식 서술
### C타입: 도구 비교/리뷰
- 실제 사용 경험 기반
- 장단점 균형있게 서술
- 구체적 사용 사례 포함
### D타입: 개념 설명
- 어려운 용어 쉽게 풀어서 설명
- 실생활 비유 활용
- 단계별 이해 과정 포함이렇게 타입별로 나누니까 훨씬 체계적이 되더라고요.
Step 4: 금지사항 명시
가장 중요한 건 하지 말아야 할 것들이에요. 그동안 에이전트가 자주 실수했던 부분들을 정리했어요:
## 절대 금지사항
1. 메모에 없는 내용 지어내기 금지
2. ChatGPT, OpenAI, Zapier 언급 금지
3. 글이 중간에 끊기거나 미완성으로 끝내기 금지
4. "~합니다" 교과서체 반복 금지
5. 소제목 앞 이모지 사용 금지이 부분을 보며 AI 에이전트 설계도의 핵심을 깨달았어요.
Step 5: SEO 최적화 규칙 추가
마지막으로 검색 최적화 규칙도 넣었어요:
## SEO 최적화 필수사항
- 핵심 키프레이즈 본문에서 4~6회 자연스럽게 사용
- 첫 문단 100자 안에 주요 키워드 포함
- H2, H3 소제목 중 최소 1개에 키프레이즈 포함
- 메타 설명 120~156자, 키프레이즈 포함
- 본문 최소 1,200자 이상 작성
- 외부 링크 최소 1개 이상 삽입
완성된 claude.md 파일이 이런 모습이 되었어요.
실제 테스트 결과
claude.md를 만들고 나서 Claude에게 “이 파일을 읽고 블로그 글 써줘”라고 했더니 정말 신기하게도 별도 설명 없이 알아서 작동하더라고요.
특히 좋았던 점들:
- 매번 글쓰기 규칙 설명할 필요 없음
- 일관된 스타일로 글 생성
- SEO 요구사항 자동 반영
- 금지사항 실수 현저히 줄어듦
claude.md 작성할 때 주의사항
직접 만들어보면서 알게 된 팁들이에요:
구체적으로 써야 함
“깔끔하게 써줘” 같은 모호한 표현은 소용없어요. “함수명은 30자 이하로 작성할 것”처럼 구체적으로 써야 해요.
200줄 이하로 유지
너무 길면 중요한 규칙이 무시된다고 하더라고요. 핵심만 간단명료하게 정리하는 게 좋아요.
실패할 때마다 추가하기
처음부터 완벽하게 만들려고 하지 말고, 에이전트가 실수할 때마다 한 줄씩 추가하는 방식이 효과적이에요.
이런 접근법을 자세히 설명한 “유튜브 영상“도 참고가 됐어요. 또 이 영상에서는 실제 사례를 볼 수 있고요.
향후 계획
지금까지는 wp_auto_post 스크립트 안에 프롬프트를 하드코딩해뒀는데, 이제 claude.md가 그 역할을 대체할 예정이에요. 파일만 읽으면 되니까 훨씬 관리하기 편할 것 같아요.
다음엔 이 claude.md를 실제 자동화 스크립트와 연결해볼 계획이에요.
마무리
오늘 claude.md로 AI 에이전트 설계도를 만들어보니까 파일 하나로 에이전트 설계 개념을 확실히 이해할 수 있었어요.
생각보다 간단한 원리인데 효과는 확실하네요. 앞으로 다른 프로젝트에서도 이런 방식으로 에이전트 설계도를 만들어볼 생각이에요.
썸네일 사진: Thalia Tran on Unsplash