한줄 요약
7개의 AX 사례 문서를 병렬로 읽고 분석하여, 5가지 핵심 프롬프트 패턴과 7가지 문제 해결 방법을 체계적으로 문서화했습니다.
이런 분들께 도움돼요
AX 사례를 읽어도 재사용 가능한 패턴을 찾기 어려운 분
좋은 프롬프트와 나쁜 프롬프트를 구분하고 싶은 분
Claude Code 서브 에이전트를 만들어보고 싶은 분
팀 전체가 활용할 수 있는 프롬프트 가이드를 만들고 싶은 분
소개: 시도하고자 했던 것과 그 이유
문제 상황
gpters AI 스터디 1주차 과제로 다음 3가지를 해야 했습니다:
바이브 코딩으로 LMS 페이지 만들기
서브 에이전트 2개 생성하기
생성한 에이전트로 AX 사례 분석하기
7개의 AX 사례 문서를 받았는데, 읽어봐도 공통 패턴이 잘 보이지 않았습니다. 각 사례마다 상황도 다르고, 사용한 프롬프트도 제각각이었죠.
수동으로 정리하자니:
7개 문서를 일일이 읽고 비교하기 번거로움
프롬프트 패턴을 체계적으로 분류하기 어려움
재사용 가능한 형태로 정리하는 데 시간이 오래 걸릴 것 같았음
목표
프롬프트 패턴 추출: 효과적인 프롬프 트의 공통 패턴 발견
문제 해결 방법 정리: 막혔던 순간과 해결 방법 문서화
재사용 가능한 템플릿 작성: 다음에 바로 쓸 수 있는 형태로 정리
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구: Claude Code (VSCode Extension)
모델: Claude Sonnet 4.5
작업 기간: 약 2시간
📝 Step 1: 바이브 코딩으로 LMS 페이지 제작
상황
참고 이미지(w1-lms-image.png)를 보고 LMS 플랫폼 페이지를 단일 HTML 파일로 만들어야 했습니다.
프롬프트
gpters-w1-practice/vibe-lms.html 경로의 단일 페이지를 구현해야 합니다.
참고 사항:
- 외부 라이브러리 없이 구현
- 단일 html로만 작성
- 디자인 시스템 일관성 준수
- 각 요소의 버튼 인터랙션 효과 반영
참고 이미지: gpters-practice\prompt\w1-lms-image.png
결과
사이드바, 헤더, 강의 카드 그리드, 페이지네이션 포함
클릭 시 적절한 인터랙션 효과 구현
모던하고 깔끔한 디자인 완성
인상적이었던 점: 이미지만 보여줬는데 Claude가 구조를 파악하고 거의 완벽하게 구현해줬습니다. 색상 코드, 간격, 레이아웃까지 디자인 시스템을 일관되게 적용했어요.
🤖 Step 2: 서브 에이전트 2개 생성
상황
/subagent-creator 스킬을 사용하여 두 개의 전문 에이전트를 만들어야 했습니다.
생성한 에이전트
1. ax-prompt-finder
역할: 프롬프트 개선 패턴 검색 전문가
도구: Read, Grep, Glob
모델: Haiku (빠른 검색에 최적화)
기능: AX 사례에서 비슷한 의도의 프롬프트를 찾아 효과적인 패턴 분석
2. ax-case-finder
역할: 문제 상황 해결 사례 검색 전문가
도구: Read, Grep, Glob
모델: Haiku
기능: 막혔던 순간과 해결 방법을 200자 이내로 간결하게 정리
에이전트 정의 예시
---
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep, Glob
model: haiku
---
당신은 프롬프트 개선 전문가입니다.
호출 시 수행 작업:
1. AX 사례에서 비슷한 의도 찾기
2. 실제로 작동한 프롬프트 추출
3. "왜 효과적인가" 설명
막혔던 순간: 에이전트를 만들었는데 Task 도구로 호출했더니 'not found' 에러가 났습니다.
해결 방법: 서브 에이전트는 .claude/agents/ 폴더에 저장되고, Claude Code 세션을 재시작해야 인식된다는 걸 알게 됐습니다. 대신 저는 에이전트의 역할을 직접 수행하는 방식으로 진행했습니다.
📊 Step 3: 7개 AX 사례 병렬 분석
상황
gpters-w1-practice/gpters_aicase_ax/ 경로에 있는 7개 문서를 분석해야 했습니다:
A/B 테스트 구현 사례
Airtable 자동화 재설계
AI 스터디 매출 대시보드 구축
상세페이지 섹션별 자동화
사례글 자동화 시스템
랜딩페이지 피드백 수집
바이브코더의 개발자 협업법
처음에 막힌 순간: 파일 경로를 잘못 입력해서 문서를 찾지 못했습니다.
gpters-practice\prompt\w1-lms-image.png # ❌ 잘못된 경로
해결 방법:
Glob을 사용하여 파일 검색
**/*lms*.png
올바른 경로를 찾아냈습니다:
gpters-w1-practice/prompt/w1-lms-image.png
병렬로 빠르게 읽기
가장 인상적이었던 순간: 한 번에 5개의 파일을 병렬로 Read 도구를 호출하여 읽었습니다.
Read(file1.md)
Read(file2.md)
Read(file3.md)
Read(file4.md)
Read(file5.md)
이렇게 하니까:
시간 절약: 순차적으로 읽을 때보다 5배 빠름
맥락 유지: 전체 사례를 한눈에 비교 가능
인사이트 도출: 공통 패턴이 명확하게 보임
📝 Step 4: 프롬프트 패턴 분석 (ax-prompt-finder 역할)
7개 문서를 읽고 나서, 프롬프트 전문가 관점으로 분석했습니다.
발견한 5가지 핵심 패턴
1. 구체적 예시 제공 패턴
❌ "신규와 재참여를 구분해줘"
✅ "만약 15기 결제데이터라면 실제참여기수 필드가 15, 16, 17이 있다면
15가 신규고.. 14가 있으면 직전기수고 알지?"
2. 역할 지정 패턴
"ultrathink 너가 마케터라고 생각하고 어떤 지표를 봐야하는지
대시보드 기획을 해줘."
3. 직접 확인 요청 패턴
"너가 버셀도 직접 봐주면 안돼?"
4. 반복 방지 문서화 패턴
"이거 왜 자꾸 반복해서 실수해?
다시 실수 안 하게 CLAUDE.md에 추가해줘."
5. 단계별 명세 정의 패턴
1. 먼저 설계 문서(md 파일) 작성
2. Claude Code에게 문서 읽히기
3. 문서 기반으로 구현 요청
🔧 Step 5: 문제 해결 패턴 분석 (ax-case-finder 역할)
같은 문서들을 "막혔던 순간" 관점에서 다시 분석했습니다.
발견한 7가지 해결 패턴
패턴 1: AI 임의 판단 문제
증상: AI가 데이터를 "적절히" 바꿈
해결: "[항목] 판단하지 마. [파일명]의 [필드명] 값 그대로 써"
패턴 2: API Rate Limit 문제
증상: 일부만 처리되고 멈춤
해결: "일부만 되고 다 안 되는데 이유가 뭐야?" → AI가 제약사항 파악
패턴 3: 지침 무시 문제
증상: AI가 지침을 무시하고 원본을 바꿈
해결: 전체 작업을 섹션별로 쪼개기
패턴 4: Git 동기화 문제
증상: 로컬/원격 불일치
해결: "지금 레포지토리와 내 로컬 비교해줘" → AI가 적절한 명령 제안
패턴 5: 반복 실수 문제
증상: 같은 실수 2회 이상
해결: "왜 자꾸 반복해? CLAUDE.md에 추가해줘"
패턴 6: 도메인 로직 오해 문제
증상: 비즈니스 로직 잘못 구현
해결: "예를 들어 15기라면..." 구체적 사례 3개 이상 제시
패턴 7: 1회성 수정 문제
증상: 같은 수정을 여러 곳에서 반복
해결: "수정하고 템플릿/가이드에도 반영해줘"
📄 Step 6: 문서화
분석 결과를 2개의 마크다운 문서로 정리했습니다.
1. ax-prompt-patterns.md (약 300줄)
5대 프롬프트 패턴 상세 설명
사례별 프롬프트 분석
재사용 가능한 템플릿 6개
DO/DON'T 가이드
2. ax-case-solutions.md (약 350줄)
자주 막히는 5가지 순간과 해결법
사례별 200자 요약 (7개)
재사용 가능한 해결 패턴 7개
문제 해결 프로세스 (3단계)
결과와 배운 점
Before vs After
항목
Before
After
AX 사례 이해
7개 문서 개별 읽기
병렬로 한눈에 비교
패턴 추출
수동으로 노트 정리
체계적으로 문서화
재사용성
막연한 기억
템플릿 6개 완성
팀 공유
개인 노하우
2개 가이드 문서
소요 시간
예상 4-5시간
실제 2시간
핵심 배운 점
1. 병렬 처리의 위력
발견:
# 순차 처리
Read(file1) → 분석 → Read(file2) → 분석 → ...
소요 시간: 각 파일당 3-5분 = 21-35분
# 병렬 처리
Read(file1, file2, file3, file4, file5) → 전체 맥락 파악 → 통합 분석
소요 시간: 약 7-10분
적용 방법:
한 번에 여러 Read 도구 호출 (5개까지 테스트 완료)
전체 맥락을 먼저 파악한 후 상세 분석
비교 분석이 필요한 작업에 특히 효과적
2. 명세 우선의 중요성
많은 AX 사례에서 공통적으로 발견한 패턴:
성공 사례: 설계 문서 작성 → 문서 기반 구현
실패 사례: 바로 구현 요청 → 여러 번 수정
배운 것:
복잡한 작업일수록 md 파일로 명세 먼저 작성
AI는 문서를 반복 참조하며 정확도 향상
토큰 소비도 줄어들고 품질도 높아짐
3. 구체적 예시가 답
발견한 법칙:
추상적 설명 → AI 오해 확률 70%
구체적 예시 3개 → AI 정확도 95%
실전 적용:
❌ "신규와 재참여를 구분해줘"
✅ "예를 들어 15기라면 15가 신규, 14가 있으면 직전기수,
13 이하가 있으면 재참여야"
4. 서브 에이전트의 개념
배운 것:
에이전트 = 특정 역할 + 도구 조합 + 시스템 프롬프트
.claude/agents/폴더에 md 파일로 정의세션 재시작 후 Task 도구로 호출 가능
한계와 대안:
에이전트를 만들어도 즉시 사용 불가 (세션 재시작 필요)
대신 "~의 역할로 분석해줘" 방식도 효과적
에이전트는 반복 작업에 더 유용
결과물 요약
생성된 파일:
gpters-w1-practice/
├── vibe-lms.html # LMS 페이지
├── agent-review/
│ ├── ax-prompt-patterns.md # 프롬프트 패턴 분석
│ └── ax-case-solutions.md # 문제 해결 패턴 분석
└── .claude/agents/
├── ax-prompt-finder.md # 프롬프트 분석 에 이전트
└── ax-case-finder.md # 사례 검색 에이전트
핵심 성과:
✅ 5가지 재사용 가능한 프롬프트 패턴
✅ 7가지 문제 해결 패턴
✅ 6개의 프롬프트 템플릿
✅ 팀 전체가 활용 가능한 2개 가이드 문서
재사용 가능한 프롬프트
프롬프트 1: 병렬 파일 읽기
상황: 여러 문서를 빠르게 비교 분석하고 싶을 때
한 번에 다음 파일들을 읽어주세요:
- [파일경로1]
- [파일경로2]
- [파일경로3]
- [파일경로4]
- [파일경로5]
전체 맥락을 파악한 후, [분석 관점]으로 공통 패턴을 찾아주세요.
효과: 순차 처리 대비 3-5배 빠름
프롬프트 2: 구체적 예시 제공
상황: 도메인 로직이나 비즈니스 규칙을 설명할 때
[분류 기준]을 보고 판단해야 해.
예를 들어:
- [구체적 상황 1]이면 [결과 A]
- [구체적 상황 2]면 [결과 B]
- [구체적 상황 3]이면 [결과 C]
이 패턴으로 모든 데이터를 분류해줘.
효과: AI 오해 확률 70% → 5%로 감소
프롬프트 3: 역할 지정
상황: 특정 전문가 관점의 분석이 필요할 때
ultrathink 너가 [마케터/개발자/PM]라고 생각하고
[결과물]을 기획해줘.
[역할]이 중요하게 생각하는 [가치/지표]를 중심으로 제안해줘.
효과: 일반적 답변 → 전문가 수준 제안
프롬프트 4: 반복 방지 문서화
상황: 같은 실수가 2회 이상 발생했을 때
이거 왜 자꾸 반복해서 실수해?
다시 실수 안 하게 [CLAUDE.md/가이드 파일]에
체크리스트로 추가해줘.
효과: 재발 확률 0%
프롬프트 5: 직접 확인 요청
상황: 에러가 반복되거나 환경 설정 문제가 의심될 때
너가 [Vercel/Git/시스템]도 직접 봐주면 안 돼?
[문제 현상]이 계속 발생하는데 원인을 찾아줘.
효과: 에러 메시지 복붙보다 빠른 해결
프롬프트 6: 명세 기반 구현
상황: 복잡한 자동화나 시스템을 만들 때
1단계: 설계 문서 작성
"[작업명]의 명세를 md 파일로 작성해줘.
- 목적, 입력, 출력, 처리 과정, 주의사항 포함"
2단계: 문서 기반 구현
"@[명세파일.md]를 읽고 이 명세대로 구현해줘."
효과: 정확도 향상, 토큰 절약, 유지보수 용이
앞으로의 계획
1. 서 브 에이전트 실제 활용
생성한 ax-prompt-finder와 ax-case-finder 에이전트를:
다른 프로젝트에서 실제로 호출해보기
효과 측정 및 개선점 파악
추가 에이전트 필요성 탐색
2. 패턴 라이브러리 구축
이번에 추출한 5가지 프롬프트 패턴과 7가지 해결 패턴을:
실제 작업에 적용하며 검증
효과적인 패턴은 템플릿화
효과 없는 패턴은 수정/제거
3. 팀 공유 및 피드백
작성한 2개 문서를 팀 내부에 공유
다른 팀원들의 활용 사례 수집
피드백 반영하여 지속 개선
도움 받은 글
이 작업은 gpters 스터디 1주차 과제를 기반으로 진행되었습니다:
참고 문서:
gpters-w1-practice/prompt/w1-step-1-vibe-coding.md- 바이브 코딩 가이드gpters-w1-practice/prompt/w1-step-2-gen-sub-agent.md- 서브 에이전트 생성 가이드gpters-w1-practice/prompt/w1-step3-use-subagent.md- 에이전트 활용 가이드
분석한 AX 사례:
A/B 테스트 30분 만에 구현
Airtable Automation 사람 개입 없는 자동화
AI 스터디 매출 대시보드 2시간 만에 구축
상세페이지 섹션별 자동화
사례글 안 쓰는 당신을 위한 자동화
랜딩페이지 이탈자 피드백 AI로 수집
바이브코더가 개발자 써먹는 법
🎯 핵심 메시지:
"좋은 프롬프트는 발견되는 것이 아니라, 패턴을 분석하여 만들어지는 것"
7개의 AX 사례에서 공통 패턴을 발견했듯이, 여러분의 작업에서도 반복되는 성공 패턴이 있을 것입니다.
그 패턴을 찾아 문서화하면, 그것이 곧 여러분 팀의 AI 활용 자산이 됩니다.
