Claude Code로 만든 나만의 AI 분석 에이전트

📝 한줄 요약

gpters 스터디 과제로 시작해서, 재사용 가능한 AI 분석 에이전트 2개를 만들고 7개 사례에서 프롬프트 패턴 라이브러리까지 완성한 여정

🎯 이런 분들께 도움돼요

• Claude Code 서브 에이전트를 만들어보고 싶은 분

• 반복되는 문서 분석 작업을 자동화하고 싶은 분

• 프롬프트 패턴을 체계적으로 정리하고 싶은 분

• AI 에이전트 병렬 실행의 효율성을 경험하고 싶은 분

💡 소개: 시도하고자 했던 것과 그 이유

시작 계기

gpters 프리랜서 자동화 스터디 1주차 과제를 수행하기 위해 시작했습니다. 과제는 3단계로 구성되어 있었어요:

1. 바이브 코딩: 단일 HTML로 LMS 사이트 만들기

2. 서브 에이전트 생성: 전문 분석 에이전트 2개 구축

3. 에이전트 활용: 7개 AX 사례 분석 및 인사이트 문서화

단순한 과제 수행을 넘어서, 실무에서 재사용 가능한 도구를 만들고 싶었습니다.

목표

• ✅ 재사용 가능한 AI 분석 에이전트 구축

• ✅ 병렬 실행으로 분석 시간 단축

• ✅ 체계적인 프롬프트 패턴 라이브러리 완성

🛠️ 진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?

사용한 도구

• 도구명: Claude Code (CLI)

• 모델: Claude Sonnet 4.5

• 추가 도구: /subagent-creator 스킬

작업 과정

Step 1: 바이브 코딩으로 워밍업

먼저 LMS(학습 관리 시스템) 사이트를 단일 HTML 파일로 만들었습니다.

요구사항:

• 외부 라이브러리 없이 순수 HTML/CSS/JS만 사용

• 디자인 시스템 일관성 유지

• 버튼 클릭 시 인터랙션 효과 구현

결과:

gpters-w1-practice/vibe-lms.html
- 사이드바 네비게이션
- 강의 카드 그리드 (8개)
- 수강신청, 찜 기능
- 필터링 시스템

Claude Code에게 "gpters-w1-practice/vibe-lms.html 경로에 단일 HTML로 LMS 사이트 구현해줘"라고 요청하니, 디자인 시스템부터 인터랙션까지 한 번에 구현해줬습니다.

Step 2: 서브 에이전트 생성 - 구조 설계가 핵심

가장 인상 깊었던 순간은 서브 에이전트의 구조를 설계하는 과정이었습니다.

/subagent-creator 스킬을 사용하여 두 개의 전문 에이전트를 만들었어요:

Agent 1: ax-prompt-finder (프롬프트 패턴 분석가)

---
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep, Glob
model: haiku
---

역할: 프롬프트 엔지니어링 전문가
실행 순서:
1. 현재 프롬프트 분석
2. AX 사례 병렬 검색
3. 효과적인 프롬프트 추출
4. 효과성 설명

왜 haiku 모델?

• 빠른 검색 속도 필요

• 비용 효율적

• 패턴 추출에는 충분한 성능

핵심 설계 포인트:

• tools를 Read, Grep, Glob만 지정 → 읽기 전용으로 안전성 확보

• description에 "병렬 검색" 명시 → 에이전트 역할 명확화

• 출력 형식을 구조화 → 일관된 결과물

Agent 2: ax-case-finder (사례 문제 해결 분석가)

---
name: ax-case-finder
description: 현재 상황과 비슷한 AX 사례 병렬 검색
tools: Read, Grep, Glob
model: haiku
---

역할: 문제 해결 전문가
출력: 200자 이내 간결 형식

200자 제한의 이유:

• 핵심만 빠르게 파악

• 토큰 소비 최소화

• 실용성 우선

Step 3: 에이전트 병렬 실행 - 효율성의 체감

7개의 AX 사례 문서를 분석하는 과정에서 병렬 실행의 효율성을 확실히 체감했습니다.

분석 대상:

gpters-w1-practice/gpters_aicase_ax/
├── A/B 테스트 30분 구현
├── Airtable 자동화
├── Exit Intent 팝업
├── 리팩토링 학습
├── 매출 대시보드
├── 상세페이지 자동화
└── 사례글 자동화

병렬 실행 방식:

단일 메시지에 두 Task 도구 호출
├─ Task 1: ax-case-finder 실행
└─ Task 2: ax-prompt-finder 실행

→ 동시에 실행되어 시간 절반으로 단축

실제 프롬프트:

"gpters-w1-practice/gpters_aicase_ax 경로의 7개 AX 사례를 분석해줘.

[ax-case-finder 역할로]
- 막혔던 순간과 해결 방법
- 공통 병목 지점
- 효과적인 커뮤니케이션 방법

[ax-prompt-finder 역할로]
- 효과적이었던 프롬프트들
- 프롬프트의 효과성 근거
- 재사용 가능한 패턴"

결과:

• 두 에이전트가 동시에 7개 문서를 읽고 분석

• 각자의 관점에서 인사이트 추출

• 약 5분 만에 분석 완료

Step 4: 인사이트 문서화

두 에이전트의 분석 결과를 문서화했습니다:

gpters-w1-practice/agent-review/
├── ax-case-insights.md (11KB)
│   ├─ 7개 사례별 인사이트
│   ├─ 공통 병목과 해결 전략
│   ├─ 재사용 가능한 해결 패턴 8가지
│   └─ 핵심 교훈
│
└── ax-prompt-patterns.md (20KB)
    ├─ 7개 사례별 프롬프트 분석
    ├─ 10가지 공통 효과적 패턴
    ├─ 비효과적 패턴과 개선 방법
    └─ 재사용 가능한 프롬프트 템플릿 10개

✨ 결과와 배운 점

Before vs After

핵심 학습 내용

1. 병렬 실행의 효율성 체감

깨달은 점:

• 독립적인 작업은 병렬로 실행하면 시간을 크게 절약

• 두 에이전트가 각자의 관점에서 분석하니 더 풍부한 인사이트

적용 방법:

단일 메시지에 여러 Task 호출
→ 동시 실행으로 시간 절약

2. 서브 에이전트 설계의 중요성

핵심 원칙:

• tools 제한으로 안전성 확보 (Read, Grep, Glob만)

• model 선택으로 비용 효율화 (haiku)

• description에 역할 명확히 정의

• 출력 형식 구조화로 일관성 확보

3. 프롬프트 패턴 라이브러리의 가치

10가지 효과적 패턴 발견:

1. 도메인 지식 + 구체적 예시

2. 역할 할당 (ultrathink)

3. 명확한 제약 명시

4. 설계 문서화

5. 구체적 피드백

6. 워크플로우 정의

7. 문서화 + 재사용

8. 문제 → 옵션 비교

9. 기존 도구 통합

10. 필수 항목 체크

재사용 템플릿 예시:

"[목표]를 위해 사용할 수 있는 도구/방법이 뭐가 있을까?
각각의 장단점을 비교해줄래? 내 상황은 [제약사항]이야"

→ 초기 리서치 & 비교 템플릿

결과물

1. 재사용 가능한 서브 에이전트

   • .claude/agents/ax-prompt-finder.md

   • .claude/agents/ax-case-finder.md

2. 프롬프트 패턴 라이브러리

   • ax-prompt-patterns.md (20KB)

   • 10개 재사용 템플릿

   • 7개 사례 검증 완료

3. 사례 인사이트 문서

   • ax-case-insights.md (11KB)

   • 8가지 해결 패턴

   • 공통 병목 분석

📋 재사용 가능한 프롬프트

프롬프트 1: 서브 에이전트 생성

"/subagent-creator를 이용하여 [목적] 에이전트를 생성합니다.

---
name: [에이전트명]
description: [역할과 언제 사용하는지]
tools: Read, Grep, Glob
model: haiku
---

[에이전트가 수행할 작업]:
1. [단계 1]
2. [단계 2]
3. [단계 3]

OUTPUT: [출력 형식]"

사용 예시:

• 문서 분석 자동화

• 코드 리뷰 자동화

• 패턴 추출 자동화

프롬프트 2: 병렬 분석 실행

"[경로]의 [N개] 문서를 분석해줘.

[에이전트1 역할로]
- [분석 항목 1]
- [분석 항목 2]

[에이전트2 역할로]
- [분석 항목 1]
- [분석 항목 2]

각 에이전트를 병렬로 실행해줘."

효과:

• 분석 시간 절반 단축

• 다양한 관점 확보

프롬프트 3: 구조화된 문서화 요청

"[에이전트명]의 분석 결과를 다음 형식으로 문서화해줘:

경로: [저장 경로]
형식:
- 사례별 인사이트
- 공통 패턴
- 재사용 템플릿
- 핵심 교훈

[특정 제약사항이 있다면 명시]"

🚀 앞으로의 계획

다른 프로젝트에 서브 에이전트 적용

1. 코드 리뷰 자동화

   • PR 분석 에이전트

   • 보안 취약점 검사 에이전트

2. 고객 피드백 분석

   • 감정 분석 에이전트

   • 주요 이슈 추출 에이전트

3. 경쟁사 분석

   • 가격 비교 에이전트

   • 기능 매칭 에이전트

확장 아이디어

• 더 많은 AX 사례 분석으로 패턴 라이브러리 확장

• 팀 내 공유하여 협업 효율성 향상

• 에이전트 마켓플레이스 구축

💬 마치며

gpters 스터디 과제로 시작했지만, 실무에서 바로 활용 가능한 도구를 만들 수 있었습니다.

핵심은:

• 서브 에이전트 구조 설계의 중요성

• 병렬 실행으로 효율성 극대화

• 재사용 가능한 패턴 라이브러리 구축

비개발자도 Claude Code만 있으면 충분히 할 수 있습니다. 중요한 건 "어떻게 구조화할 것인가"입니다.

📚 참고 자료

• 서브 에이전트 생성 가이드

• gpters 프리랜서 자동화 스터디

• Claude Code 문서

🤖 이 게시글은 Claude Code와 함께 작성되었습니다.