Claude Code 서브 에이전트로 프롬프트 패턴 찾기 자동화
📝 한줄 요약
5개의 AX 사례 문서를 2개의 서브 에이전트가 병렬로 분석해서 프롬프트 패턴과 문제 해결 패턴을 자동 추출했다.
🎯 이런 분들께 도움돼요
여러 문서에서 공통 패턴을 찾고 싶은데 일일이 읽기 힘든 분
Claude Code 서브 에이전트를 만들어봤지만 실제로 어떻게 활용할지 모르는 분
반복적인 분석 작업을 자동화하고 싶은 프리랜서/스터디 운영자
💡 소개: 시도하고자 했던 것과 그 이유
문제 상황
gpters 스터디에서 5개의 AX (Automation Experience) 사례 문서를 받았습니다. 각 문서는 사람들이 Claude Code로 자동화를 구현한 경험을 담고 있었죠.
사례글 자동화 (세션 파일 파싱)
매출 대시보드 구축 (Airtable 연동)
바이브코더의 개발자 리뷰 학습
상세페이지 자동화 (스킬 활용)
Airtable Automation 재설계
문제는 이 5개 문서에서 공통 패턴을 찾고 싶었는데 방법을 몰랐다는 것입니다. 일일이 읽으면서 노트 정리하기엔 시간이 너무 오래 걸릴 것 같았습니다.
시작 계기
gpters 20기 자동화 템플릿에 "서브 에이전트 생성" 프롬프트가 있었습니다. 서브 에이전트를 만드는 건 해봤는데, 실제로 "어떻게 활용할까?"가 막연했죠.
그때 생각했습니다:
"문서 분석을 각각 다른 관점으로 하는 에이전트 2개를 만들고, 병렬로 돌리면 어떨까?"
🔧 진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구: Claude Code (CLI)
모델: Sonnet 4.5 (main), Haiku (sub-agents)
핵심 기능: 서브 에이전트 시스템, 병렬 Task 실행
작업 과정
1. 서브 에이전트 2개 생성
먼저 /subagent-creator 스킬을 사용해서 2개의 서브 에이전트를 만들었습니다.
Agent 1: ax-prompt-finder
목적: 효과적인 프롬프트 패턴 찾기
방법: "재사용 가능한 프롬프트" 섹션 검색, 왜 효과적인지 분석
Agent 2: ax-case-finder
목적: 문제 해결 패턴 찾기
방법: "막혔던 순간과 해결" 섹션 검색, Before/After 비교
두 에이전트 모두 tools: Read, Grep, Glob로 설정하고, 빠른 처리를 위해 model: haiku를 선택했습니다.
2. 5개 문서 읽기
먼저 main agent가 5개 문서를 모두 읽어서 전체 맥락을 파악했습니다. 이 과정에서 각 사례의 핵심 내용을 이해하게 됐죠:
누가, 무엇을, 어떻게 자동화했는지
어떤 문제에 부딪혔고 어떻게 해결했는지
어떤 프롬프트가 효과적이었는지
3. 병렬 에이전트 실행
핵심은 여기였습니다. 2개의 서브 에이전트를 동시에 실행했습니다:
Task 1 (ax-case-finder): 5개 문서에서 블로커/솔루션 패턴 추출
Task 2 (ax-prompt-finder): 5개 문서에서 효과적인 프롬프트 패턴 추출
인상 깊었던 점: 에이전트가 자동으로 Grep으로 키워드를 검색하고 패턴을 추출했습니다. "막혔던", "해결", "Before/After", "재사용 가능한 프롬프트" 같은 키워드로 문서를 스캔하더니, 의미 있는 내용만 골라내더군요.
4. 결과 문서화
각 에이전트가 분석을 끝내면 결과를 자동으로 마크다운 문서로 저장했습니다:
ax-prompt-패턴분석.md (9.9KB)
ax-case-사례분석.md (8.8KB)
✅ 결과와 배운 점
Before vs After
항목
Before
After
분석 시간
수동으로 5개 문서 읽고 정리 (예상 2-3시간)
병렬 에이전트 실행 (실제 5분)
관점
내 관점 하나
2가지 관점 (프롬프트/사례)
일관성
사람이 놓칠 수 있음
키워드 기반으로 빠짐없이
재사용
일회성 분석
서브 에이전트로 반복 가능
결과물
5가지 효과적인 프롬프트 패턴
Context-First Data Source Specification
Domain Logic with Concrete Examples
Role-Based Perspective Shift
Honest Feedback with Desired State
Workflow Definition with AI/Code Boundary
각 패턴별 실제 사례 + 왜 효과적인지 설명
패턴 선택 의사결정 트리
3가지 공통 블로커 패턴
AI 출력 맥락 및 한계 이해
코드 로직 vs AI 판단 구분
반복적 개선 마인드셋 갭
3가지 효과적인 솔루션 패턴
구체적 예시 > 추상적 설명
CLAUDE.md에 학습 문서화
역할 기반 관점 활용
배운 점
1. 서브 에이전트는 "관점"을 나누는 도구
같은 문서를 읽더라도:
ax-prompt-finder는 "어떤 프롬프트가 효과적이었나?"
ax-case-finder는 "어떤 문제를 어떻게 해결했나?"
이렇게 다른 질문으로 접근하니 훨씬 풍부한 인사이트를 얻을 수 있었습니다.
2. 병렬 실행의 힘
단일 Task로 "전체 분석해줘"라고 하면:
한 가지 관점에 치우칠 수 있음
토큰 소모가 많고 느림
병렬로 나눠서 실행하니:
각 에이전트가 명확한 목표에 집중
동시에 실행되어 시간 단축
3. 서브 에이전트 활용 패턴 발견
"반복되는 분석 작업 = 서브 에이전트"
앞으로 비슷한 AX 사례 문서가 추가되면, 같은 에이전트를 다시 실행하기만 하면 됩니다. 한 번 만들어두면 계속 재사용할 수 있는 "분석 도구"가 생긴 셈이죠.
📋 재사용 가능한 프롬프트
프롬프트 1: 서브 에이전트 병렬 실행
gpters-w1-practice\gpters_aicase_ax 경로의 5개 문서 인사이트를 파악합니다.
main-agent가 전체 문서를 읽고 맥락을 이해한 후,
아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-ax-case-finder
@agent-ax-prompt-finder
결과값을 gpters-w1-practice\agent-review 경로에 문서화합니다.
- ax-prompt-finder 결과 : ax-prompt-{title}.md
- ax-case-finder 결과 : ax-case-{title}.md
프롬프트 2: 서브 에이전트 정의 (프롬프트 패턴 분석용)
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep, Glob
model: haiku
현재 프롬프트를 분석해야 합니다.
1. AX 사례에서 비슷한 의도 찾기
2. 실제로 작동한 프롬프트 추출
3. "왜 효과적인가" 설명
프롬프트 3: 서브 에이전트 정의 (사례 분석용)
name: ax-case-finder
description: 현재 상황과 비슷한 AX 사례 병렬 검색
tools: Read, Grep, Glob
model: haiku
현재 문제를 분석해야 합니다.
1. 키워드로 AX 사례 검색
2. "막혔던 순간과 해결" 매칭
3. 실제 해결 방법 추출
💬 도움 받은 글
gpters 20기 자동화 템플릿 - w1-step-2-gen-sub-agent.md, w1-step3-use-subagent.md
Claude Code 공식 문서 - Sub-agent Creator 가이드
🚀 이 경험을 다른 업무에 적용한다면?
이 "병렬 서브 에이전트" 패턴은 다른 상황에도 적용할 수 있을 것 같습니다:
회의록 분석
agent-decision-finder: 결정 사항 추출
agent-action-finder: 액션 아이템 추출
고객 피드백 분석
agent-pain-finder: 불만/문제점 추출
agent-feature-finder: 기능 요청 추출
코드 리뷰
agent-security-checker: 보안 이슈 검토
agent-performance-checker: 성능 이슈 검토
핵심은 "관점을 나눠서 병렬로 분석"하는 것입니다.
⸻
분석 대상 문서들:
사례글 자동화 - 세션 파일 파싱 자동화
매출 대시보드 - Airtable 연동 및 자동 분류
바이브코더 학습 - 개발자 리뷰 학습 및 문서화
상세페이지 자동화 - 섹션별 수정 스킬
Airtable Automation - 무인 스케줄링 자동화
