[프리랜서 AX] 서브에이전트로 7개 AX 사례를 자동 분석하고 재사용 가능한 인사이트 문서 만들기

한줄 요약

서브에이전트 개념을 처음 배우면서 7개의 AX 사례를 분석하고, 실전 프롬프트 패턴과 문제-해결 패턴을 추출하여 재사용 가능한 인사이트 문서로 만들었습니다.

이런 분들께 도움돼요

• 서브에이전트를 처음 만들어보고 싶은데 어떻게 설계해야 할지 막막한 분

• 쌓인 AX 사례들을 체계적으로 분석하고 패턴을 추출하고 싶은 분

• AI 작업을 재사용 가능한 시스템으로 만들고 싶은 분

• 프롬프트 작성이나 문제 해결 시 참고할 실전 패턴이 필요한 분

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

문제 상황

프리랜서 자동화 스터디 1주차 과제로 서브에이전트를 만들어야 했습니다.

서브에이전트를 처음 만들어보는 거라 개념도 잘 몰랐고, 어떻게 설계해야 할지 막막했어요. 하지만 스터디 과제를 통해 실전 학습을 해보고 싶었고, 나중에 다른 프로젝트에서도 쓸 수 있는 재사용 가능한 시스템을 만들고 싶었습니다.

목표

1. 2개의 서브에이전트 생성: 프롬프트 패턴 분석용, 문제-해결 패턴 분석용

2. 7개 AX 사례 분석: gpters의 실전 사례에서 실제로 효과적인 패턴 추출

3. 인사이트 문서화: 나중에 참고할 수 있도록 체계적으로 정리

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

사용한 도구

• 도구명: Claude Code (CLI)

• 모델: Sonnet 4.5

• 핵심 기능: Subagent Creator Skill, Read, Write

작업 과정

1단계: 서브에이전트 설계

/subagent-creator 스킬을 활용하여 두 개의 서브에이전트를 생성했습니다.

ax-prompt-finder:

• 역할: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색

• 도구: Read, Grep, Glob

• 모델: Haiku (빠른 검색을 위해)

• 출력: 2-3개 best pattern (출처, 원본 프롬프트, 효과적인 이유, 적용 방법)

ax-case-finder:

• 역할: 현재 상황과 비슷한 AX 사례 병렬 검색

• 도구: Read, Grep, Glob

• 모델: Haiku

• 출력: 1개 most relevant case (200자 이내)

2단계: 7개 AX 사례 문서 읽기

분석 대상 문서:

• A/B 테스트 구현 사례

• Airtable 자동화 재설계

• Exit Intent 피드백 수집

• 바이브코더-개발자 협업

• 매출 대시보드 구축

• 상세페이지 자동화

• 사례글 작성 자동화

모든 문서를 병렬로 읽으면서 전체 맥락을 파악했습니다.

3단계: 패턴 추출 및 분석

프롬프트 패턴 분석: 7개 문서를 읽으면서 실제로 효과적인 프롬프트 패턴을 추출하는 게 생각보다 어려웠어요. 단순히 "이렇게 했다"가 아니라 "왜 효과적인가"까지 설명해야 했거든요. Claude와 대화하며 각 패턴의 본질을 파악하고, 재사용 가능한 형태로 정리하는 과정이 인상적이었습니다.

최종적으로 추출한 7가지 프롬프트 패턴:

1. 예시 기반 설명 패턴: 구체적 예시로 설명하면 정확한 이해

2. 역할 부여 패턴: "너가 마케터라고 생각하고..."

3. 점진적 명확화 패턴: 큰 그림 → 구체화

4. 맥락 제공 패턴: 현재 상황, 제약사항 먼저 설명

5. 실패 피드백 패턴: 안 되는 부분 명확히 지적

6. 템플릿 고정 패턴: 가이드 문서에 반영하여 일관성 유지

7. 실행 순서 정의 패턴: 워크플로우를 스킬/커맨드로 정의

문제-해결 패턴 분석: 각 사례에서 막혔던 순간과 해결 방법을 매칭했습니다.

최종적으로 추출한 7가지 문제-해결 패턴:

1. 기술 용어 장벽 → "공부하고 싶어" + 비유 요청

2. 도메인 로직 오해 → 구체적 예시 제공

3. Rate Limit & API 제약 → 현상 설명 후 원인 찾기

4. 1회성 수정 vs 템플릿 반영 → 가이드에 반영 요청

5. 환경 동기화 문제 → "비교해줘"

6. AI 임의 요약/수정 방지 → 스킬로 범위 한정

7. 배포 환경 차이 → "직접 봐줘" + 문서화

4단계: 인사이트 문서화

추출한 패턴들을 체계적으로 문서화했습니다.

ax-prompt-insights.md (프롬프트 패턴):

• 각 패턴의 실제 사례

• 왜 효과적인가

• 적용 방법

• 실전 적용 체크리스트

ax-case-insights.md (문제-해결 패턴):

• 막혔던 순간

• 해결 방법

• 핵심 교훈

• 문제 해결 프로세스

결과와 배운 점

결과

생성된 파일:

• .claude/agents/ax-prompt-finder.md - 프롬프트 패턴 분석 서브에이전트

• .claude/agents/ax-case-finder.md - 문제-해결 패턴 분석 서브에이전트

• gpters-w1-practice/agent-review/ax-prompt-insights.md - 7가지 프롬프트 패턴 인사이트

• gpters-w1-practice/agent-review/ax-case-insights.md - 7가지 문제-해결 패턴 인사이트

정량적 성과:

• 7개 사례 분석

• 7가지 프롬프트 패턴 추출

• 7가지 문제-해결 패턴 추출

• 20개 이상의 구체적인 문제-해결 쌍 정리

배운 점

단순히 문서만 만든 게 아니라, "어떻게 하면 나중에 다른 사람도 쓸 수 있을까"를 고민하며 체크리스트와 적용 방법까지 정리했어요.

배운 점은 "AI 작업도 결국 구조 설계가 중요하다"는 거예요. 처음부터 재사용을 염두에 두고 설계하면 시간이 좀 걸려도 나중에 훨씬 효율적입니다.

핵심 인사이트:

1. 서브에이전트는 특화된 AI: 특정 작업에 최적화된 도구, 모델, 출력 형식 정의

2. 패턴 문서화의 힘: 한 번 정리해두면 계속 참고 가능한 자산

3. 구체성 > 추상성: 예시 기반 설명이 압도적으로 효과적

4. 점진적 개선: 한 번에 완성보다 대화하며 정교화

재사용 가능한 프롬프트

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

/subagent-creator를 이용하여 두 서브에이전트를 생성합니다

Agent 1: [에이전트명]
---
name: [이름]
description: [설명]
tools: [도구 목록]
model: [모델]
---

[역할과 책임 설명]

Agent 2: [에이전트명]
[동일한 구조로 작성]

프롬프트 2: 패턴 추출 요청

[경로]의 문서들을 분석해서:
1. 실제로 효과적인 [패턴 종류] 추출
2. 왜 효과적인지 설명
3. 재사용 가능한 형태로 정리

프롬프트 3: 인사이트 문서화 요청

추출한 패턴들을 체계적으로 문서화해줘:
- 각 패턴의 실제 사례
- 왜 효과적인가
- 적용 방법
- 실전 체크리스트 포함

향후 계획

지금은 수동으로 분석했지만, 앞으로는 /analyze-ax-cases 같은 커맨드를 만들어서 한 번에 전체 프로세스를 자동화하고 싶어요.

그리고 이 작업 과정 자체를 템플릿화해서 "AX 사례 분석 → 인사이트 추출 → 문서화" 워크플로우를 다른 사람도 쓸 수 있게 만들 계획입니다.

구체적 계획:

1. 새로운 AX 사례가 추가될 때마다 자동으로 패턴 업데이트

2. 다른 도메인(마케팅, 디자인 등)에도 비슷한 서브에이전트 적용

3. 패턴 검색 API 만들어서 "막혔을 때 즉시 참고"할 수 있게

도움 받은 글

• gpters AX 사례 7개

• w1-step-2-gen-sub-agent.md (프롬프트 가이드)

• w1-step3-use-subagent.md (활용 가이드)