[프리랜서 클코 스터디] 병렬 에이전트로 7개 AX 사례 문서를 5분 만에 분석한 방법
2026.01.13
한줄 요약
4단계 프롬프트만 준비하면, 클로드 코드가 서브에이전트를 만들고 병렬로 문서를 분석해서 인사이트까지 정리해준다.
이런 분들께 도움돼요
클로드 코드 입문하고 싶은데 뭐부터 해야 할지 모르겠는 분
여러 문서를 읽고 인사이트를 뽑아야 하는데 시간이 부족한 분
서브에이전트가 뭔지 궁금한데 직접 만들어본 적 없는 분
프롬프트 흐름을 체계적으로 설계하고 싶은 분
소개: 시도하고자 했던 것과 그 이유
문제 상황
프리랜서 자동화 스터디를 운영하면서 두 가지 고민이 있었어요:
스터디 멤버들이 클로드 코드에 입문할 때 따라할 수 있는 실습 예제가 필요했어요
"설치했는데 뭐 하지?" 상태에서 벗어나게 해주고 싶었음
AX 사례 문서가 7개나 쌓여있는데 하나씩 읽고 인사이트 뽑기가 너무 번거로웠어요
각 문서마다 프롬프트 패턴, 자동화 패턴이 숨어있는데 수작업으로 정리하려니 엄두가 안 남
해결 아이디어
"프롬프트 4개만 준비해두면, 클로드 코드가 알아서 분석해주지 않을까?"
그래서 4단계 프롬프트 흐름을 설계했어요:
바이브 코딩으로 워밍업
서브에이전트 2개 생성
병렬로 문서 분석 실행
사례 게시글 작성
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구: Claude Code (VSCode Extension)
모델: Claude Opus 4.5 (메인) + Haiku (서브에이전트)
특이사항:
/subagent-creator스킬 활용
4단계 프롬프트 흐름
Step 1: 바이브 코딩으로 워밍업
# w1-step-1-vibe-coding.md
현재 사용자는 클로드 코드 입문자입니다.
단일 html로 LMS 페이지를 구현해야 합니다.
참고 사항:
- 외부 라이브러리 없이 구현
- 단일 html로만 작성
- 디자인 시스템 일관성 준수
포인트: 복잡한 설정 없이 바로 결과물을 볼 수 있는 작업으로 시작
Step 2: 서브에이전트 2개 생성
# w1-step-2-gen-sub-agent.md
/subagent-creator 를 이용하여 두 서브 에이전트를 생성합니다
Agent 1: ax-prompt-finder
- 프롬프트 개선 패턴을 AX 사례에서 검색
- tools: Read, Grep
- model: haiku
Agent 2: ax-case-finder
- 현재 상황과 비슷한 AX 사례 검색
- tools: Read, Grep
- model: haiku
포인트:
Haiku 모델로 비용 절감
각 에이전트에 명확한 역할 부여 (프롬프트 패턴 vs 자동화 패턴)
Step 3: 병렬 에이전트로 문서 분석
# w1-step3-use-subagent.md
gpters-w1-practice\gpters_aicase_ax 경로의 문서 인사이트를 파악
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-ax-case-finder
@agent-ax-prompt-finder
결과값을 gpters-w1-practice\agent-review 경로에 문서화
포인트:
Main agent가 먼저 맥락 파악
서브에이전트는 병렬로 호출 → 시간 단축
결과물 경로까지 명시
Step 4: 사례 게시글 자동 작성
# w1-step4-ai-case-write.md
/ai-case-writer 를 이용하여 현재 작업의 내용을 사례 게시글로 작성
포인트: 작업 완료 후 바로 사례글까지 자동화
실제 실행 결과
생성된 서브에이전트:
.claude/agents/ax-case-finder.md.claude/agents/ax-prompt-finder.md
생성된 인사이트 문서:
ax-case-automation-patterns.md- 4가지 자동화 유형, 5가지 재사용 템플릿ax-prompt-effective-patterns.md- 5가지 프롬프트 패턴, 8개 템플릿
결과와 배운 점
Before vs After
항목 | Before | After |
|---|---|---|
7개 문서 분석 | 1-2시간 수작업 | 5분 자동화 |
인사이트 정리 | 머릿속에만 | 구조화된 문서 2개 |
재사용성 | 일회성 작업 | 프롬프트 4개로 반복 가능 |
핵심 배운 점
프롬프트를 파일로 관리하면 재사용이 쉬워진다
prompt/폴더에 단계별 프롬프트 저장다음에 비슷한 작업할 때 그대로 활용
서브에이전트는 생각보다 쉽다
/subagent-creator로 몇 줄만 적으면 생성Haiku 모델로 비용 부담 없이 병렬 처리
Main → Sub 구조가 효율적이다
Main agent가 맥락 파악 후 분배
Sub agent는 특화된 작업만 수행
재사용 가능한 프롬프트
프롬프트 1: 서브에이전트 생성 템플릿
/subagent-creator 를 이용하여 서브 에이전트를 생성합니다
---
name: [에이전트 이름]
description: [한 줄 설명]
tools: Read, Grep
model: haiku
---
[에이전트가 해야 할 작업]:
1. [단계 1]
2. [단계 2]
3. [단계 3]
프롬프트 2: 병렬 에이전트 호출 템플릿
[경로]의 문서 인사이트를 파악합니다.
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-[에이전트1]
@agent-[에이전트2]
결과값을 [출력 경로]에 문서화해주세요.
프롬프트 3: 단계별 프롬프트 흐름 설계
# Step 1: [워밍업 작업]
→ 간단한 결과물로 시작
# Step 2: [도구/에이전트 준비]
→ 필요한 것들 생성
# Step 3: [메인 작업 실행]
→ 준비된 도구로 실제 작업
# Step 4: [결과 정리/공유]
→ 문서화 또는 게시글 작성
앞으로의 계획
스터디 멤버들이 이 4단계 흐름을 따라하면서 클로드 코드에 입문할 수 있도록 가이드 제작
서브에이전트를 더 다양한 용도로 확장 (코드 리뷰, 테스트 작성 등)
프롬프트 라이브러리를
.claude/commands/로 정리해서 스킬화
도움 받은 글
gpters 사내 AX 사례 7개 (분석 대상)
Claude Code 공식 문서 (서브에이전트 기능)


![[Claude Code] 한 줄 명령어로 FDA 가이드라인 수집부터 번역까지 - 규제과학 연구원의 AI 자동화기 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F4664d896962b3c2465bee374.jpg&w=3840&q=75)
