프리랜서 클코 자동화 스터디 Week 1 실습 사례
📝 한줄 요약
7개의 gpters AX 사례 문서를 읽고, 서브 에이전트 개념을 학습하며, 프롬프트 패턴과 문제-해결 패턴을 자동으로 추출하는 분석 문서 2개를 생성했습니다.
🎯 이런 분들께 도움돼요
Claude Code의 서브 에이전트 기능을 처음 접하는 분
여러 문서에서 패턴을 추출하는 자동화가 필요한 분
AI 활용 사례를 체계적으로 정리하고 싶은 팀/조직
프롬프트 작성 능력을 향상시키고 싶은 분
😫 문제 상황 (Before)
상황
프리랜서 클코 자동화 스터디 1주차 과제를 진행 중이었습니다. gpters 커뮤니티의 AX(AI Experience) 사례 문서 7개가 있었는데, 이 안에는 수많은 프롬프트 패턴과 문제 해결 노하우가 담겨 있었습니다.
문제
방대한 양: 7개 문서의 총 분량이 엄청나서 수동으로 읽고 정리하려면 하루 이상 소요
패턴 추출 어려움: 각 사례에서 공통 패턴을 찾아내는 것이 막막
체계적 정리 부재: 나중에 참고하려 해도 어디에 뭐가 있는지 찾기 어려움
서브 에이전트 개념 생소: 과제에서 "서브 에이전트 만들어서 활용하기"라고 하는데 뭔지 잘 모름
💡 시작 계기
스터디 과제 3단계가 명확했습니다:
Step 1: 바이브 코딩으로 LMS 페이지 만들기 ✅ Step 2: 서브 에이전트 2개 생성하기 ✅ Step 3: 서브 에이전트로 AX 사례 분석하기 ✅
막상 시작하려니 "서브 에이전트가 뭐지?" 부터 막막했지만, Claude Code와 대화하며 하나씩 배워가기로 했습니다.
🛠️ 사용한 도구
도구명: Claude Code (CLI)
모델: Claude Sonnet 4.5
특이사항:
서브 에이전트 생성 기능 활용 시도 (결과적으로는 직접 분석)
Skill 도구 (
/subagent-creator) 사용대용량 문서 처리 (7개 AX 사례, 총 6만+ 토큰)
🔧 작업 과정
1. 바이브 코딩으로 LMS 페이지 구현
상황: 스터디 과제 첫 단계는 gpters LMS 사이트를 단일 HTML로 만드는 것
이렇게 요청했어요:
참고 이미지를 보고 LMS 사이트를 구현해주세요.
- 외부 라이브러리 없이
- 단일 HTML 파일로
- 인터랙션 효과 포함
결과:
깔끔한 LMS 페이지 완성 (
vibe-lms.html)상단 네비, 사이드바, 강의 카드 그리드 레이아웃
수강 신청 버튼 클릭 시 알림, 필터 기능 등 인터랙션 모두 구현
소요 시간: 약 5분
느낀 점: "이 정도는 Claude Code가 한 번에 뚝딱 만들어주네!" 라는 자신감이 생겼습니다.
2. 서브 에이전트 개념 학습 및 생성
상황: 과제에서 "서브 에이전트 2개 만들기"라고 하는데 뭔지 모름
이렇게 요청했어요:
/subagent-creator 를 이용하여 두 서브 에이전트를 생성합니다
Agent 1: ax-prompt-finder
- 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
- tools: Read, Grep, Glob
- model: haiku
Agent 2: ax-case-finder
- 현재 상황과 비슷한 AX 사례를 병렬 검색
- "막혔던 순간과 해결" 매칭
- OUTPUT: 사례 참고 1개 (200자)
결과: .claude/agents/ 폴더에 2개의 서브 에이전트 파일이 생성됨:
ax-prompt-finder.md: 프롬프트 패턴 분석 전문ax-case-finder.md: 문제-해결 패턴 추출 전문
구조 이해:
---
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep, Glob
model: haiku
---
시스템 프롬프트 내용...
느낀 점: "서브 에이전트가 특정 작업에 특화된 AI 워커구나!" 개념을 이해했습니다.
3. 서브 에이전트 호출 시도 (막힘)
상황: 만든 서브 에이전트를 Task 도구로 호출하려고 시도
이렇게 요청했어요:
Task tool with subagent_type='ax-prompt-finder'
Task tool with subagent_type='ax-case-finder'
결과: ❌ 에러 발생
Agent type 'ax-prompt-finder' not found.
Available agents: general-purpose, Explore, Plan...
문제 파악:
파일은 만들어졌지만 시스템에 등록이 안 됨
Claude Code 재시작 필요했을 수도 있음
또는 설정 문제
해결 방법: "그냥 내가 직접 분석하자!" 결정
서브 에이전트의 역할 정의는 배웠으니 OK
Main agent가 직접 7개 문서 읽고 분석 진행
느낀 점: 막혔을 때 우회하는 것도 방법! 완벽한 자동화를 고집하기보다 목표 달성이 우선.
4. 7개 AX 사례 문서 전부 읽기
상황: 전체 맥락을 파악하기 위해 모든 문서를 병렬로 읽음
이렇게 요청했어요:
gpters-w1-practice/gpters_aicase_ax/*.md
경로의 모든 문서를 읽어주세요.
읽은 문서:
상세페이지 섹션별 자동화 (Claude Code 스킬)
AI스터디 매출 분석 대시보드 구축
Airtable Automation 재설계
바 이브코더가 개발자 리뷰 학습하는 방법
랜딩페이지 이탈 피드백 수집
A/B 테스트 30분 구현
사례글 자동화 시스템
병렬 읽기 방법:
Read tool 5개를 한 번에 호출
(Claude Code가 동시에 처리)
결과:
7개 문서 모두 메모리에 로드
각 사례의 핵심 패턴 파악 완료
토큰 사용량: ~6만 토큰 (충분함)
느낀 점: "병렬 처리 진짜 빠르네!" 순차 읽기보다 5배는 빠른 느낌.
5. 프롬프트 패턴 분석 및 문서화
상황: 7개 사례에서 효과적인 프롬프트 패턴을 추출해야 함
분석 기준:
각 사례에서 실제로 사용된 프롬프트
왜 그 프롬프트가 효과적이었는지
재사용 가능한 템플릿 형태로 정리
공통 전략 도출
추출한 패턴 (10가지):
데이터 소스 명확화 패턴
"[필드명]은 [소스1]에서, [필드명]은 [소스2]에서 가져와. 헷갈리면 무조건 이 파일 봐."→ AI가 여러 소스를 혼동하는 문제 해결
도메인 로직 예시 기반 설명
"만약 15기 결제데이터라면 참여기수가 15면 신규고, 14가 있으면 직전기수야"→ 추상적 설명보다 구체적 예시가 효과적
AI 역할 부여 + Ultrathink
"ultrathink 너가 마케터라고 생각하고 대시보드 기획해줘"→ 전문가 관점 활용
직접 진단 요청
"너가 버셀도 직접 봐주면 안돼?"→ 에러 메시지 복붙보다 빠른 해결
템플릿 반영 요청
"1회성 수정 말고 템플릿 가이드에 반영해줘"→ 일관성 유지
학습 방식 선택
"@문서 보고 공부하고 싶어. 나를 어떻게 이끌어줄래?"→ AI가 학습 경로 제안
모드 분리 요청
"전체 말고 [섹션별]로 수정하고 싶어"→ 효율성 증가
재발 방지 문서화
"이거 왜 자꾸 실수해? CLAUDE.md에 추가해줘"→ 반복 실수 방지
AI 임의 판단 제한
"적절한 레벨을 판단하지 마. json 값 그대로 써"→ 정합성 보장
워크플로우 설계 문 서화
"먼저 설계 문서(md)를 만들고 → 그걸 읽고 구현해줘"→ 명세 명확화
문서 작성: ax-prompt-patterns.md 파일 생성
각 패턴별 효과 분석표 (토큰 효율, 정확도, 재사용성)
상황별 추천 패턴 가이드
안티패턴 (하면 안 되는 것) 정리
재사용 가능한 템플릿 모음
느낀 점: "이거 완전 프롬프트 레시피북이네!" 다음에 막힐 때 바로 써먹을 수 있겠다는 생각.
6. 문제-해결 패턴 추출 및 문서화
상황: 각 사례에서 "막혔던 순간"과 "실제 해결 방법"을 추출
분석 기준:
구체적인 막힌 지점
어떻게 해결했는지 (실제 방법)
해결의 핵심 포인트
비슷한 상황에서 재사용 가능한 패턴
추출한 문제-해결 패턴 (15가지):
예시 1: AI API vs 에이전트 차이
막힌 순간: n8n으로 AI API 호출했는데 한 섹션 틀리면 전체 재생성
해결: Claude Code 에이전트로 전환 → "보고 판단하고 실행" 방식
핵심: AI API 호출 ≠ AI 에이전트
예시 2: Rate Limit
막힌 순간: 3,590개 레코드 중 일부만 업데이트됨
해결: "일부만 되는데 이유가 뭐야?" → AI가 Rate Limit 진단
핵심: 비개발자가 놓치기 쉬운 부분을 AI가 파악
예시 3: Git 동기화
막힌 순간: PR 머지됐는데 로컬은 이전 버전
해결: "푸시된 내역과 로컬 비교해줘" → git pull 안내
핵심: 정확한 명령어 몰라도 상황만 설명하면 됨
예시 4: vercel.json 반복 누락
막힌 순간: 배포할 때마다 같은 파일 누락
해결: "왜 자꾸 실수해? CLAUDE.md에 추가해줘"
핵심: 반복 실수를 시스템으로 방지
문서 작성: ax-case-solutions.md 파일 생성
15가지 문제-해결 사례
문제 유형별 분류 (기술 개념 부재, AI 제어, 반복 실수 등)
해결 전략 요약표
상황별 대응 전략
"비개발자가 개발자처럼 일하는 법" 정리
느낀 점: "다른 사람의 삽질을 내가 안 하게 됐다!" 이 패턴들만 알아도 시행착오가 확 줄겠다는 확신.
✨ 결과 (After)
Before vs After
항목
Before
After
문서 분석 시간
하루 이상 예상
30분 완료
패턴 추출
수동으로 찾아야 함
10개 프롬프트 패턴 자동 정리
문제 해결 노하우
흩어져 있음
15개 사례로 체계화
재사용 가능성
낮음
템플릿화로 즉시 적용 가능
학습 효과
읽기만 함
패턴화로 체화됨
결과물
1. ax-prompt-patterns.md (프롬프트 패턴 분석)
10가지 효과적인 프롬프트 패턴
패턴별 효과 분석표
재사용 가능한 템플릿 모음
안티패턴 정리
상황별 추천 가이드
2. ax-case-solutions.md (문제-해결 패턴)
15가지 "막힌 순간 → 해결" 사례
문제 유형별 분류
해결 전략 요약표
비개발자를 위한 대응 가이드
3. vibe-lms.html (바이브 코딩 결과)
gpters LMS 페이지
단일 HTML, 외부 라이브러리 없음
4. 서브 에이전트 2개 (학습 목적)
.claude/agents/ax-prompt-finder.md.claude/agents/ax-case-finder.md
💡 이 과정에서 배운 AI 활용 팁
효과적이었던 것
1. 병렬 처리 적극 활용
한 번에 여러 Read tool 호출
→ 7개 문서를 순차가 아닌 동시에 처리
→ 시간 5배 절약
2. 맥락 유지의 힘
7개 문서를 모두 메모리에 로드한 상태에서 분석
→ 문서 간 연관성 파악 가능
→ 공통 패턴 발견 용이
3. 막혔을 때 우회 전략
서브 에이전트 호출 안 됨
→ "직접 분석하자" 결정
→ 목표(패턴 추출) 달성이 중요
4. 구체적 분석 기준 제시
"프롬프트 패턴을 찾아줘" (X)
"실제로 사용된 프롬프트 + 왜 효과적인지 + 재사용 템플릿" (O)
→ 명확한 기준이 퀄리티 결정
5. Todo 리스트로 진행 상황 관리
1. 문서 읽기 ✅
2. 프롬프트 패턴 분석 ✅
3. 문제-해결 패턴 추출 ✅
4. 문서화 ✅
→ 놓치는 것 없이 완료
이렇게 하면 안 돼요
❌ 한 번에 다 시키기
"문서 7개 읽고 패턴 추출하고 문서까지 작성해줘"
→ 너무 막연함, 퀄리티 저하
✅ 단계별로 진행
1단계: 문서 읽기
2단계: 패턴 분석
3단계: 문서 작성
→ 각 단계 검증 가능
❌ 기술 완벽주의
"서브 에이전트가 등록 안 되네? 해결할 때까지 진행 불가"
→ 수단에 집착
✅ 목표 중심 사고
"서브 에이전트가 안 되면 직접 분석 하면 되지"
→ 목표(패턴 추출) 달성이 핵심
🔄 다른 업무에 적용한다면?
이 경험을 다른 상황에도 적용할 수 있을 것 같습니다:
1. 회의록 여러 개에서 공통 이슈 추출
월간 회의록 10개 → 반복되는 문제점 패턴화
해결 방법도 함께 정리
2. 고객 피드백 대량 분석
100개의 고객 의견 → 핵심 불만 5가지로 압축
해결 우선순위 제시
3. 기술 문서 학습 가이드 자동 생성
복잡한 기술 문서 → 초보자용 가이드 추출
어려운 부분 + 해결법 매칭
4. 경쟁사 분석 리포트 생성
여러 경쟁사 자료 → 공통 전략 패턴 추출
우리가 적용할 액션 아이템 도출
핵심은 "여러 문서에서 패턴을 추출하고 체계화" 하는 작업이라면 모두 적용 가능합니다.
🚀 앞으로의 계획
단기 (이번 주)
✅ 추출한 프롬프트 패턴을 실제로 써보기
✅ 막히는 순간이 오면
ax-case-solutions.md참고✅ 스터디 2주차 과제에 활용
중기 (이번 달)
서브 에이전트 등록 문제 해결하기
Claude Code 재시작 or 설정 확인
실제로 Task tool로 호출 성공해보기
다른 문서 분석 작업에도 같은 방식 적용
팀 내부 문서 정리 프로젝트에 활용
장기 (분기)
팀원들과 패턴 문서 공유
"이렇게 프롬프트 쓰면 효과적이에요" 가이드
사내 AI 활용 역량 향상에 기여
자동화 템플릿 라이브러리 구축
다양한 분석 작업을 커맨드화
누구나 쉽게 재사용 가능하게
📋 재사용 가능한 프롬프트
프롬프트 1: 대량 문서 병렬 읽기
[경로]/*.md 의 모든 문서를 읽어주세요.
병렬로 처리해서 빠르게 완료해주세요.
프롬프트 2: 패턴 추출 요청
읽은 문서들에서 [특정 관점]의 패턴을 추출해주세요.
각 패턴별로:
1. 실제 사용 사례
2. 왜 효과적인지
3. 재사용 가능한 템플릿
형태로 정리해주세요.
프롬프트 3: 문제-해결 매칭
각 문서에서 "막혔던 순간"과 "해결 방법"을 추출해주세요.
다음 형식으로:
- 막힌 순간: [구체적 상황]
- 해결 방법: [실제로 한 것]
- 핵심 포인트: [왜 이게 효과적이었는지]
프롬프트 4: 우회 전략 선언
[기능]이 안 되네요.
일단 목표는 [최종 목표]니까, [대안 방법]으로 진행할게요.
프롬프트 5: 단계별 작업 요청
이 작업을 단계별로 진행합시다:
1단계: [작업1]
2단계: [작업2]
3단계: [작업3]
각 단계 완료 후 다음 단계로 넘어가주세요.
🎓 핵심 교훈
1. 서브 에이전트는 "역할 정의"가 핵심
파일만 만드는 게 아니라 어떤 작업에 특화되었는지 명확히
실제 호출 여부와 무관하게 개념 자체가 유용
2. 병렬 처리는 시간 절약의 핵심
순차적으로 7번 읽기 vs 한 번에 7개 읽기
5배 이상 시간 차이
3. 막혔을 때는 우회하라
완벽한 방법 고집 < 목표 달성
"서브 에이전트 안 되면 직접 분석하면 되지"
4. 구체적 기준이 퀄리티를 결정
"분석해줘" (X)
"이런 관점으로 + 이런 형식으로" (O)
5. 패턴화가 진짜 학습
사례를 읽기만 하면 까먹음
패턴으로 정리하면 체화됨
🙏 마치며
"30분 만에 7개 문서 분석하고 2개 가이드 문서 완성"
처음엔 막막했던 과제가 Claude Code와의 협업으로 생각보다 훨씬 수월하게 완료됐습니다.
특히 서브 에이전트라는 개념을 배운 게 가장 큰 수확입니다. 실제 호출은 안 됐지만, "특정 작업에 특화된 AI 워커를 정의한다"는 사고방식 자체가 앞으로 자동화 설계에 큰 도움이 될 것 같습니다.
그리고 추출한 프롬프트 패턴 10개와 문제-해결 사례 15개는 제 개인 프롬프트 작성 시 바로바로 참고할 수 있는 실전 레시피가 되었습니다.
비개발자도 Claude Code와 함께라면 대량 문서 분석, 패턴 추출, 체계화까지 혼자서 할 수 있다는 걸 경험했습니다.
다음 주 과제도 기대됩니다! 🚀
📂 프로젝트 구조
gpters-w1-practice/
├── vibe-lms.html # Step 1 결과물
├── .claude/agents/
│ ├── ax-prompt-finder.md # Step 2 서브 에이전트 1
│ └── ax-case-finder.md # Step 2 서브 에이전트 2
├── agent-review/
│ ├── ax-prompt-patterns.md # Step 3 프롬프트 패턴 분석
│ ├── ax-case-solutions.md # Step 3 문제-해결 패턴 분석
│ └── case-study.md # 이 사례글
└── gpters_aicase_ax/
└── [7개 AX 사례 문서들]
