프롬프트 패턴 찾기: AX 사례로 만든 맞춤형 서브 에이전트

한줄 요약

5개의 gpters AX 사례를 분석하여 프롬프트 패턴과 문제 해결 사례 패턴을 자동으로 추출하는 서브 에이전트 2개를 만들었습니다.

이런 분들께 도움돼요

• AX 사례가 많지만 공통 패턴을 찾기 어려운 분

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

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

• 프리랜서 자동화 스터디를 시작하는 분

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

문제 상황

gpters에는 많은 AX(AI eXperience) 사례가 쌓여있습니다. 하지만 사례가 많을수록 오히려 문제가 생깁니다:

• 비슷한 문제를 겪었던 사례를 찾기 어렵다

• 효과적인 프롬프트 패턴을 추출하기 힘들다

• 매번 수동으로 문서를 읽고 분석해야 한다

특히 프리랜서 자동화 스터디를 시작하면서 이런 생각이 들었습니다:

"막혔을 때 참고할 수 있는 사례를 빠르게 찾을 수 있다면?" "효과적인 프롬프트 패턴을 자동으로 추천받을 수 있다면?"

시도한 것

그래서 두 개의 특화된 서브 에이전트를 만들기로 했습니다:

1. ax-prompt-finder: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색

2. 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

현재 프롬프트를 분석해야 합니다:

1. AX 사례에서 비슷한 의도 찾기

2. 실제로 작동한 프롬프트 추출

3. "왜 효과적인가" 설명

ax-case-finder:

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

현재 문제를 분석해야 합니다:

1. 키워드로 AX 사례 검색

2. "막혔던 순간과 해결" 매칭

3. 실제 해결 방법 추출 (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개의 사례를 분석했습니다:

1. A/B 테스트 구현 (비개발자가 30분 만에)

2. Airtable Automation 재설계 (사람 개입 없는 자동화)

3. Exit Intent 피드백 수집 (Voiceform 활용)

4. 개발자 리뷰 학습 (바이브코딩 → 리팩토링)

5. 매출 대시보드 구축 (Airtable 연동)

Step 4: 막혔던 순간 - 에이전트가 등록 안 됨

처음에는 만든 에이전트를 Task 도구로 호출하려고 했습니다:

Task(subagent_type="ax-case-finder", prompt="...")

하지만 에러가 발생했습니다:

Agent type 'ax-case-finder' not found

원인: 에이전트가 시스템에 아직 등록되지 않았음

해결: 직접 분석을 진행하기로 결정

• 5개 문서를 병렬로 읽기 (Read 도구 5회 동시 호출)

• 두 가지 관점(사례 패턴, 프롬프트 패턴)으로 직접 분석

• 각각의 인사이트 문서 작성

Step 5: 인사이트 추출 및 문서화

생성된 문서 2개:

1. ax-case-비개발자_자동화_구현_패턴.md

   • 핵심 패턴 3가지 발견:

     • "명세 먼저, 구현 나중"

     • "구체적 예시 없이는 안 통한다"

     • "반복 실수는 문서화로 방지"

   • 막혔던 순간 TOP 5와 해결책

   • 비개발자 자동화 성공 3단계

2. ax-prompt-효과적인_프롬프트_패턴.md

   • 가장 효과적인 프롬프트 TOP 10

   • 재사용 가능한 템플릿 6가지

   • 프롬프트 원칙 5가지

   • 상황별 프롬프트 전략

결과와 배운 점

Before vs After

결과물

서브 에이전트 2개:

• .claude/agents/ax-prompt-finder.md - 프롬프트 패턴 검색 전문

• .claude/agents/ax-case-finder.md - 비슷한 사례 검색 전문

인사이트 문서 2개:

• gpters-w1-practice/agent-review/ax-case-비개발자_자동화_구현_패턴.md

• gpters-w1-practice/agent-review/ax-prompt-효과적인_프롬프트_패턴.md

핵심 발견 사항

1. "명세 먼저, 구현 나중" 패턴

사례: Airtable Automation 재설계

• 설계 문서(md)를 먼저 작성 → 그 문서를 기반으로 구현

• AI가 이해할 수 있는 형태로 명세를 정리하면, 구현/디버깅/수정이 모두 명세 기준으로 진행됨

2. 효과적인 프롬프트 구조

[상황 설명] + [목적/의도] + [구체적 예시 또는 제약]

예시:

❌ "고쳐줘"
✅ "로딩이 너무 길어. 20기만 먼저 로딩하고 나머지는 lazy loading 해줘"

3. 역할 부여 + ultrathink 패턴

ultrathink 너가 [마케터/PM/개발자]라고 생각하고 [결과물] 기획해줘.

• 모르는 도메인 지식을 AI에게서 빌려올 수 있음

• ultrathink: 더 깊이 생각하게 만드는 트리거

가장 크게 배운 점

서브 에이전트 생성 방법론:

1. 명확한 역할 정의: "프롬프트 패턴 찾기" vs "비슷한 사례 찾기"

2. 도구 선택: Read, Grep, Glob으로 빠른 검색

3. 모델 선택: haiku로 비용 효율성

4. 출력 형식: 구체적으로 정의 (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]

각 패턴마다:
- 구체적 예시
- 왜 효과적인지
- 파일 참조
를 포함해주세요.

다른 업무에 적용한다면?

이 패턴은 다음 상황에 적용 가능합니다:

1. 고객 피드백 분석: 수백 개의 피드백에서 공통 이슈 추출

2. 회의록 요약: 여러 회의록에서 액션 아이템 패턴 찾기

3. 코드 리뷰 학습: 과거 리뷰에서 반복되는 지적 사항 정리

4. 마케팅 캠페인 분석: 성공한 캠페인의 공통 패턴 도출

앞으로의 계획

1. 더 많은 서브 에이전트 생성

   • 코드 리뷰 전문 에이전트

   • 문서 최적화 전문 에이전트

   • 테스트 케이스 생성 에이전트

2. 에이전트 체인 구성

   • ax-case-finder → ax-prompt-finder 순차 실행

   • 찾은 사례의 프롬프트 패턴 자동 분석

3. 팀 워크플로우 통합

   • 스터디 멤버들이 막혔을 때 자동으로 사례 추천

   • 프롬프트 개선이 필요할 때 자동으로 패턴 제안

4. 지속적 학습

   • 새로운 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 사례:

1. A/B 테스트 해본 적 없는 비개발자가 30분 만에 구현한 팁

2. Airtable Automation을 '사람 개입 없는 운영 자동화'로 재설계

3. 랜딩페이지 이탈하려는 유저 피드백을 AI 바이브로 듣는 방법

4. 바이브코더가 개발자 써먹는(?) 법

5. AI스터디 매출 분석에 필요한 데이터 로직 & 대시보드 구축