프롬프트 패턴 찾기: AX 사례로 만든 맞춤형 서브 에이전트
2026.01.13
한줄 요약
5개의 gpters AX 사례를 분석하여 프롬프트 패턴과 문제 해결 사례 패턴을 자동으로 추출하는 서브 에이전트 2개를 만들었습니다.
이런 분들께 도움돼요
AX 사례가 많지만 공통 패턴을 찾기 어려운 분
반복적인 문서 분석 작업을 자동화하고 싶은 분
Claude Code 서브 에이전트를 만들어보고 싶은 분
프리랜서 자동화 스터디를 시작하는 분
소개: 시도하고자 했던 것과 그 이유
문제 상황
gpters에는 많은 AX(AI eXperience) 사례가 쌓여있습니다. 하지만 사례가 많을수록 오히려 문제가 생깁니다:
비슷한 문제를 겪었던 사례를 찾기 어렵다
효과적인 프롬프트 패턴을 추출하기 힘들다
매번 수동으로 문서를 읽고 분석해야 한다
특히 프리랜서 자동화 스터디를 시작하면서 이런 생각이 들었습니다:
"막혔을 때 참고할 수 있는 사례를 빠르게 찾을 수 있다면?" "효과적인 프롬프트 패턴을 자동으로 추천받을 수 있다면?"
시도한 것
그래서 두 개의 특화된 서브 에이전트를 만들기로 했습니다:
ax-prompt-finder: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
ax-case-finder: 현재 상황과 비슷한 AX 사례를 병렬 검색
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구명: Claude Code (CLI)
모델: Claude Sonnet 4.5
특이사항:
/subagent-creator스킬 활용
Step 1: 서브 에이전트 설계
먼저 두 에이전트의 역할을 명확히 정의했습니다:
ax-prompt-finder:
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep, Glob
model: haiku
현재 프롬프트를 분석해야 합니다:
AX 사례에서 비슷한 의도 찾기
실제로 작동한 프롬프트 추출
"왜 효과적인가" 설명
ax-case-finder:
name: ax-case-finder
description: 현재 상황과 비슷한 AX 사례 병렬 검색
tools: Read, Grep, Glob
model: haiku
현재 문제를 분석해야 합니다:
키워드로 AX 사례 검색
"막혔던 순간과 해결" 매칭
실제 해결 방법 추출 (OUTPUT: 200자)
Step 2: /subagent-creator 스킬로 생성
/subagent-creator
스킬을 실행하고 위에서 설계한 내용을 바탕으로 두 개의 서브 에이전트 파일을 생성했습니다.
생성된 파일:
.claude/agents/ax-prompt-finder.md.claude/agents/ax-case-finder.md
각 에이전트는:
병렬 검색을 사용해 빠르게 결과 제공
haiku 모델 사용으로 비용 효율적
구체적인 출력 형식 정의 (프롬프트 분석 vs 200자 사례)
Step 3: 실전 테스트 - 5개 AX 사례 분석
gpters-w1-practice/gpters_aicase_ax/ 경로에 있는 5개의 사례를 분석했습니다:
A/B 테스트 구현 (비개발자가 30분 만에)
Airtable Automation 재설계 (사람 개입 없는 자동화)
Exit Intent 피드백 수집 (Voiceform 활용)
개발자 리뷰 학습 (바이브코딩 → 리팩토링)
매출 대시보드 구축 (Airtable 연동)
Step 4: 막혔던 순간 - 에이전트가 등록 안 됨
처음에는 만든 에이전트를 Task 도구로 호출하려고 했습니다:
Task(subagent_type="ax-case-finder", prompt="...")
하지만 에러가 발생했습니다:
Agent type 'ax-case-finder' not found
원인: 에이전트가 시스템에 아직 등록되지 않았음
해결: 직접 분석을 진행하기로 결정
5개 문서를 병렬로 읽기 (Read 도구 5회 동시 호출)
두 가지 관점(사례 패턴, 프롬프트 패턴)으로 직접 분석
각각의 인사이트 문서 작성
Step 5: 인사이트 추출 및 문서화
생성된 문서 2개:
ax-case-비개발자_자동화_구현_패턴.md
핵심 패턴 3가지 발견:
"명세 먼저, 구현 나중"
"구체적 예시 없이는 안 통한다"
"반복 실수는 문서화로 방지"
막혔던 순간 TOP 5와 해결책
비개발자 자동화 성공 3단계
ax-prompt-효과적인_프롬프트_패턴.md
가장 효과적인 프롬프트 TOP 10
재사용 가능한 템플릿 6가지
프롬프트 원칙 5가지
상황별 프롬프트 전략
결과와 배운 점
Before vs After
항목 | Before | After |
|---|---|---|
사례 검색 | 수동으로 문서 하나씩 읽기 | 에이전트가 병렬 검색 |
패턴 추출 | 머릿속으로 추론 | 구체적 예시와 참조 포함 |
재사용 | 기억에 의존 | 문서화된 템플릿 |
소요 시간 | 2-3시간 | 1시간 이내 |
결과물
서브 에이전트 2개:
.claude/agents/ax-prompt-finder.md- 프롬프트 패턴 검색 전문.claude/agents/ax-case-finder.md- 비슷한 사례 검색 전문
인사이트 문서 2개:
gpters-w1-practice/agent-review/ax-case-비개발자_자동화_구현_패턴.mdgpters-w1-practice/agent-review/ax-prompt-효과적인_프롬프트_패턴.md
핵심 발견 사항
1. "명세 먼저, 구현 나중" 패턴
사례: Airtable Automation 재설계
설계 문서(md)를 먼저 작성 → 그 문서를 기반으로 구현
AI가 이해할 수 있는 형태로 명세를 정리하면, 구현/디버깅/수정이 모두 명세 기준으로 진행됨
2. 효과적인 프롬프트 구조
[상황 설명] + [목적/의도] + [구체적 예시 또는 제약]
예시:
❌ "고쳐줘"
✅ "로딩이 너무 길어. 20기만 먼저 로딩하고 나머지는 lazy loading 해줘"
3. 역할 부여 + ultrathink 패턴
ultrathink 너가 [마케터/PM/개발자]라고 생각하고 [결과물] 기획해줘.
모르는 도메인 지식을 AI에게서 빌려올 수 있음
ultrathink: 더 깊이 생각하게 만드는 트리거
가장 크게 배운 점
서브 에이전트 생성 방법론:
명확한 역할 정의: "프롬프트 패턴 찾기" vs "비슷한 사례 찾기"
도구 선택: Read, Grep, Glob으로 빠른 검색
모델 선택: haiku로 비용 효율성
출력 형식: 구체적으로 정의 (200자 제한, 특정 구조)
에이전트를 만들 때 중요한 것:
병렬 검색을 명시하면 더 빠르게 작동
출력 형식을 구체적으로 정의할수록 일관성 있는 결과
하나의 명확한 목적에 집중
재사용 가능한 프롬프트
1. 서브 에이전트 생성 요청
/subagent-creator 를 이용하여 두 서브 에이전트를 생성합니다
Agent 1: [이름]
---
name: [kebab-case-name]
description: [간단한 설명 + 언제 사용하는지]
tools: Read, Grep, Glob
model: haiku
---
[역할 설명]
1. [작업 1]
2. [작업 2]
3. [작업 3]
OUTPUT: [출력 형식]
2. 문서 분석 및 인사이트 추출
[경로]의 문서들 인사이트를 파악한 다음,
인사이트를 추려내 문서화를 목표합니다.
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 관점으로 내용을 파악합니다:
- [관점 1]
- [관점 2]
결과값을 [경로]에 문서화해주세요
문서는 각 관점 당 1개만 작성합니다.
3. 병렬 문서 읽기
[파일경로1], [파일경로2], [파일경로3]...
위 문서들을 병렬로 읽고 [분석 목적]을 파악해주세요.
4. 패턴 추출 요청
[대상 문서들]에서 공통 패턴을 찾아주세요:
1. [패턴 유형 1]
2. [패턴 유형 2]
각 패턴마다:
- 구체적 예시
- 왜 효과적인지
- 파일 참조
를 포함해주세요.
다른 업무에 적용한다면?
이 패턴은 다음 상황에 적용 가능합니다:
고객 피드백 분석: 수백 개의 피드백에서 공통 이슈 추출
회의록 요약: 여러 회의록에서 액션 아이템 패턴 찾기
코드 리뷰 학습: 과거 리뷰에서 반복되는 지적 사항 정리
마케팅 캠페인 분석: 성공한 캠페인의 공통 패턴 도출
앞으로의 계획
더 많은 서브 에이전트 생성
코드 리뷰 전문 에이전트
문서 최적화 전문 에이전트
테스트 케이스 생성 에이전트
에이전트 체인 구성
ax-case-finder → ax-prompt-finder 순차 실행
찾은 사례의 프롬프트 패턴 자동 분석
팀 워크플로우 통합
스터디 멤버들이 막혔을 때 자동으로 사례 추천
프롬프트 개선이 필요할 때 자동으로 패턴 제안
지속적 학습
새로운 AX 사례가 추가되면 자동으로 패턴 업데이트
문서화된 패턴을 Claude에게 학습 자료로 제공
도움 받은 글
이 작업은 다음 프롬프트 문서를 참고했습니다:
gpters-w1-practice/prompt/w1-step-2-gen-sub-agent.md- 서브 에이전트 생성 가이드gpters-w1-practice/prompt/w1-step3-use-subagent.md- 서브 에이전트 활용 가이드
그리고 분석한 5개의 gpters AX 사례:

![[미니] 클로드 코웍 사용해서 가계부까지 도전해보기 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fc6465620fff4957e3817a6b4.jpg&w=3840&q=75)