한줄 요약
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 공식 문서 (서브에이전트 기능)
