서브 에이전트로 AX 사례 5개 분석하여 인사이트 추출하기

한줄 요약

Claude Code 서브 에이전트 2개를 생성하여 5개의 AX 사례를 분석하고, 공통 문제 패턴과 효과적인 프롬프트 패턴을 문서화했습니다.

이런 분들께 도움돼요

• 서브 에이전트 개념을 실습하고 싶은 분

• AX 사례를 체계적으로 분석하고 싶은 분

• 재사용 가능한 프롬프트 패턴을 찾고 싶은 분

• 비개발자로서 효과적인 AI 협업 방법을 배우고 싶은 분

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

시작 계기

20기 클로드 코드 자동화 스터디의 1주차 과제로 서브 에이전트를 만들고 실전에서 활용해보고 싶었습니다. 단순히 개념을 이해하는 것을 넘어, 실제로 서브 에이전트를 생성하고 구체적인 작업(AX 사례 분석)을 수행하면서 그 유용성을 체감해보고자 했습니다.

해결하고자 한 문제

여러 AX(Agent Experience) 사례를 읽어봤지만, 각 사례가 독립적으로 존재해서 다음과 같은 어려움이 있었습니다:

• 패턴 파악의 어려움: 5개 사례를 읽었지만 공통적인 문제 해결 패턴을 찾기 어려웠음

• 프롬프트 학습 부족: 어떤 프롬프트가 왜 효과적인지 체계적으로 정리되지 않음

• 재사용성 낮음: 사례를 읽어도 내 프로젝트에 바로 적용하기 어려움

이 문제를 서브 에이전트를 활용한 체계적 분석으로 해결하고자 했습니다.

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

사용한 도구

• 도구명: Claude Code (CLI)

• 모델: Claude Sonnet 4.5

• 주요 기능: 서브 에이전트 생성, 병렬 문서 읽기, 패턴 분석

1단계: 서브 에이전트 생성

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

Agent 1: ax-prompt-finder

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

현재 프롬프트를 분석해야 합니다.
1. AX 사례에서 비슷한 의도 찾기
2. 실제로 작동한 프롬프트 추출
3. "왜 효과적인가" 설명

역할: 효과적인 프롬프트 패턴 추출 및 분석

Agent 2: ax-case-finder

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

현재 문제를 분석해야 합니다.
1. 키워드로 AX 사례 검색
2. "막혔던 순간과 해결" 매칭
3. 실제 해결 방법 추출
OUTPUT: 사례 참고 1개 (200자)

역할: 공통 문제 패턴과 해결 방법 도출

저장 위치: .claude/agents/ 폴더

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

메인 에이전트가 다음 5개 사례를 병렬로 읽고 전체 맥락을 파악했습니다:

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

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

3. 랜딩페이지 이탈 피드백 - Exit Intent로 유저 의견 수집

4. 바이브코더-개발자 협업 - 리팩토링 보고서 학습 프로세스

5. 매출 대시보드 구축 - Airtable 연동 데이터 시각화

gpters-w1-practice/gpters_aicase_ax/ 경로의 문서들

3단계: 서브 에이전트 역할 수행

원래 계획은 두 서브 에이전트를 병렬로 호출하는 것이었지만, Task 도구로 호출 시 "에이전트를 찾을 수 없다"는 오류가 발생했습니다.

해결 방법: 메인 에이전트가 직접 두 가지 역할(사례 분석 + 프롬프트 패턴 추출)을 수행하는 방식으로 전환했습니다.

4단계: 분석 결과 문서화

두 가지 관점에서 인사이트를 추출하여 문서화했습니다:

문서 1: ax-case-insights.md

경로: gpters-w1-practice/agent-review/ax-case-insights.md

주요 내용:

• 5개 사례의 공통 문제 패턴 (도메인 지식 전달, AI의 반복 실수 등)

• 효과적인 해결 패턴 (설계 문서 우선, 역할 부여 등)

• 재사용 가능한 해결 템플릿 표

• 협업 프로세스 정리

문서 2: ax-prompt-patterns.md

경로: gpters-w1-practice/agent-review/ax-prompt-patterns.md

주요 내용:

• 9가지 효과적인 프롬프트 패턴

• 비효과적 vs 효과적 프롬프트 비교

• 재사용 가능한 프롬프트 라이브러리

• 상황별 프롬프트 템플릿

• 실전 시나리오 적용 예시

인상적이었던 점

문서 구조화가 매우 잘 되어 있어 재사용하기 좋았습니다.

• 테이블 형식의 템플릿 라이브러리

• 체크리스트 형태의 프롬프트 작성 가이드

• Before/After 비교표

• 실전 시나리오별 단계적 적용 예시

이러한 구조화된 문서 덕분에 다음 프로젝트에서 바로 참고하여 사용할 수 있는 형태가 되었습니다.

결과와 배운 점

Before vs After

주요 성과

1. 서브 에이전트 개념 실습 완료

• 2개의 서브 에이전트 생성 (ax-prompt-finder, ax-case-finder)

• 역할 정의, 도구 선택, 모델 지정 등 실전 경험

• 에이전트 호출 오류 해결 과정 학습

2. 체계적인 분석 문서 2개 획득

ax-case-insights.md:

• 5개 공통 문제 패턴

• 5개 효과적 해결 패턴

• 재사용 템플릿 표

ax-prompt-patterns.md:

• 9가지 프롬프트 패턴

• 상황별 템플릿 라이브러리

• 프롬프트 작성 체크리스트

3. 재사용 가능한 프롬프트 라이브러리

배운 점

1. AI에게 역할을 부여하는 것의 중요성

서브 에이전트는 특정 역할(AX 사례 분석, 프롬프트 패턴 추출)을 명확히 정의하는 방식입니다. 이렇게 역할을 분리하면:

• AI가 해당 관점에 집중하여 더 깊이 있는 분석 가능

• 작업의 재사용성이 높아짐

• 복잡한 작업을 단계별로 나눌 수 있음

2. 병렬 읽기의 효율성

5개 문서를 Read 도구로 병렬로 읽으니 매우 빠르게 전체 맥락을 파악할 수 있었습니다. 순차적으로 읽는 것보다 효율적이었습니다.

3. 구조화된 문서의 가치

테이블, 템플릿, 체크리스트 등으로 체계적으로 정리된 문서는:

• 이해하기 쉽고

• 다른 프로젝트에 바로 적용 가능하며

• 팀원과 공유하기 좋음

재사용 가능한 프롬프트

서브 에이전트 생성

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

Agent 1: [이름]
---
name: [agent-name]
description: [역할 설명]
tools: Read, Grep, Glob
model: haiku
---

[구체적인 작업 내용]
1. [단계 1]
2. [단계 2]
3. [단계 3]

문서 병렬 분석

[경로]의 [N]개의 문서 인사이트를 파악한 다음,
인사이트를 추려내 문서화를 목표합니다.

main-agent가 전체 문서를 읽고 맥락을 이해합니다.

아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-[역할1]
@agent-[역할2]

결과값을 다음 경로에 문서화를 해주세요
[결과물 경로]

효과적인 프롬프트 패턴 (TOP 3)

1. 역할 부여 + ultrathink

ultrathink 너가 [마케터/PM/데이터 분석가]라고 생각하고 [작업]해줘

2. 구체적 예시 제공

[기준]을 보고 판단해야 해. 예를 들어 [상황 A]이면 [결과 1]이고, [상황 B]이면 [결과 2]야.

3. 목적 명시 → 방법 제안

@[문서경로]를 보고 [목적: 공부하고 싶어/분석하고 싶어/적용하고 싶어]. 나를 어떻게 이끌어줄래?

향후 계획

1. 서브 에이전트를 다른 용도로 확장

이번에 만든 분석 전문 서브 에이전트 외에도:

• code-reviewer: 코드 리뷰 전문 에이전트

• test-writer: 테스트 코드 작성 에이전트

• doc-writer: 문서화 전문 에이전트

등 다양한 역할의 서브 에이전트를 만들어 프로젝트에 적용할 계획입니다.

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

5개 사례로 9가지 패턴을 추출했으니, 앞으로 gpters에 올라오는 새로운 사례들도 같은 방식으로 분석하여 패턴 라이브러리를 지속적으로 확장할 예정입니다.

3. 팀 프로젝트에 적용

이번에 정리한 프롬프트 템플릿을 실제 프로젝트에 적용하여:

• 더 효과적인 AI 협업

• 반복되는 실수 방지 (CLAUDE.md 활용)

• 팀원과 프롬프트 패턴 공유

이 사례가 서브 에이전트를 처음 만들어보는 분들에게 도움이 되길 바랍니다! 🚀