Fitness Program — 운동 프로그램 설계 풀 파이프라인
목표별프로그램설계→주간스케줄→운동가이드문서→식단연계표→진행기록템플릿을 에이전트 팀이 협업하여 한 번에 생성한다.
실행 모드
에이전트 팀 — 4명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 |
파일 |
역할 |
타입 |
| program-architect |
.claude/agents/program-architect.md |
프로그램 설계, 주기화, 스케줄 |
general-purpose |
| exercise-guide |
.claude/agents/exercise-guide.md |
운동 동작 설명, 폼 가이드, 대체운동 |
general-purpose |
| nutrition-linker |
.claude/agents/nutrition-linker.md |
운동별 영양전략, 보충제, 타이밍 |
general-purpose |
| template-builder |
.claude/agents/template-builder.md |
기록지, 추적표, 평가 양식 |
general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 목표: 근비대/근력/다이어트/체력향상/재활
- 체력 수준: 초보자/중급자/상급자, 운동 경력
- 가용 자원: 주 X회, 회당 X분, 장비(헬스장/홈트/맨몸)
- 신체 정보 (선택): 성별, 연령, 신장, 체중
- 부상 이력 (선택): 부위, 현재 상태
- 기존 프로그램 (선택): 현재 수행 중인 프로그램
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 요청 범위에 따라 실행 모드를 결정한다
Phase 2: 팀 구성 및 실행
| 순서 |
작업 |
담당 |
의존 |
산출물 |
| 1 |
프로그램 설계 + 주간 스케줄 |
architect |
없음 |
01_program_design.md, 02_weekly_schedule.md |
| 2a |
운동 가이드 문서 |
guide |
작업 1 |
03_exercise_guide.md |
| 2b |
식단 연계표 |
linker |
작업 1 |
04_nutrition_plan.md |
| 3 |
진행 기록 템플릿 |
builder |
작업 1, 2a, 2b |
05_tracking_template.md |
작업 2a(운동 가이드)와 2b(식단 연계)는 병렬 실행한다.
팀원 간 소통 흐름:
- architect 완료 → guide에게 운동 목록·주의사항 전달, linker에게 강도·볼륨·목표 전달, builder에게 주기화 일정 전달
- guide 완료 → linker에게 고강도 운동 목록 전달, builder에게 기록 항목 전달
- linker 완료 → builder에게 영양 추적 항목 전달
- builder는 모든 정보를 통합하여 템플릿 생성. 누락 항목 발견 시 해당 에이전트에게 확인 요청
Phase 3: 통합 및 최종 산출물
_workspace/ 내 모든 파일을 확인한다
- 프로그램-스케줄-가이드-영양-템플릿 간 일관성을 확인한다
- 최종 요약을 사용자에게 보고한다:
- 프로그램 설계서 —
01_program_design.md
- 주간 스케줄 —
02_weekly_schedule.md
- 운동 가이드 —
03_exercise_guide.md
- 식단 연계표 —
04_nutrition_plan.md
- 기록 템플릿 —
05_tracking_template.md
작업 규모별 모드
| 사용자 요청 패턴 |
실행 모드 |
투입 에이전트 |
| "운동 프로그램 전체 짜줘" |
풀 파이프라인 |
4명 전원 |
| "주간 운동 스케줄만" |
스케줄 모드 |
architect 단독 |
| "스쿼트 폼 알려줘" |
가이드 모드 |
guide 단독 |
| "벌크업 식단 연계해줘" (프로그램 있음) |
영양 모드 |
linker 단독 |
| "운동 기록지 만들어줘" |
템플릿 모드 |
builder 단독 |
| "이 프로그램 분석해줘" (기존 파일) |
분석 모드 |
architect + guide |
기존 파일 활용: 사용자가 기존 프로그램을 제공하면, _workspace/01_program_design.md로 복사하고 architect를 건너뛴다.
데이터 전달 프로토콜
| 전략 |
방식 |
용도 |
| 파일 기반 |
_workspace/ 디렉토리 |
주요 산출물 저장 및 공유 |
| 메시지 기반 |
SendMessage |
실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 |
TaskCreate/TaskUpdate |
진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
에러 핸들링
| 에러 유형 |
전략 |
| 사용자 정보 부족 |
보수적(초보자) 기준으로 설계, "체력 수준 미확인" 명시 |
| 부상 이력 |
해당 부위 운동 제외 또는 대체 + "전문의 상담 권고" |
| 장비 제한 |
가용 장비 내 대체 운동으로 구성 |
| 에이전트 실패 |
1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |
| 프로그램 비일관성 |
architect에게 수정 요청 (최대 2회) |
테스트 시나리오
정상 흐름
프롬프트: "헬스장 다니는 초보자인데, 근비대 목표로 주 4회 운동 프로그램 짜줘. 178cm, 75kg, 28세 남성이야"
기대 결과:
- 프로그램: 상·하체 4분할, 12주 주기화(적응→축적→강화→디로드)
- 스케줄: 주 4회 × 60분, 운동별 세트·반복·RPE 명시
- 가이드: 프로그램 내 모든 운동(15~20개)의 폼 설명 + 대체운동
- 영양: 벌크업 칼로리(TDEE+300), 매크로, 운동 전후 타이밍
- 템플릿: 일일 기록지, 주간 요약, 4주 평가 양식, 체성분 추적표
기존 파일 활용 흐름
프롬프트: "지금 하고 있는 PPL 루틴인데 식단이랑 연계해줘" + 프로그램 파일 첨부
기대 결과:
- 기존 프로그램을
_workspace/01_program_design.md로 복사
- 영양 모드: linker 투입, 기존 프로그램 강도 분석 후 식단 연계표 생성
에러 흐름
프롬프트: "허리디스크 있는데 운동 프로그램 짜줘"
기대 결과:
- 부상 이력 반영: 허리 부담 운동(데드리프트, 바벨 스쿼트) 제외
- 코어 안정화 운동 포함, 대체 운동(레그프레스, 머신 기반) 제시
- 모든 운동에 "허리 주의" ⚠️ 표시 + "정형외과/재활의학과 상담 권고"
- 점진적 강도 증가를 더 보수적으로 설정
에이전트별 확장 스킬
| 에이전트 |
확장 스킬 |
용도 |
| exercise-guide |
exercise-biomechanics |
운동 생체역학, 근육 활성화, 대체 운동 |
| program-architect, template-builder |
periodization-engine |
주기화 설계, 볼륨·강도 계산, 디로드 전략 |
1---2name: fitness-program-23description: 운동 프로그램의 목표별 설계부터 진행 기록 템플릿까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '운동 프로그램 짜줘', '헬스 루틴', '근력 프로그램', '다이어트 운동', '홈트레이닝', '주간 운동 스케줄', '벌크업 프로그램', '마라톤 훈련', '운동 루틴 추천', 'PPL 프로그램', '맨몸운동 루틴' 등 운동·트레이닝 프로그램 관련 요청에 이 스킬을 사용한다. 기존 프로그램이 있으면 분석이나 개선을 지원한다. 단, 재활치료 프로그램 처방(물리치료사 업무), 경기력 향상 약물 상담, 실시간 퍼스널 트레이닝은 이 스킬의 범위가 아니다.4---56# Fitness Program — 운동 프로그램 설계 풀 파이프라인78목표별프로그램설계→주간스케줄→운동가이드문서→식단연계표→진행기록템플릿을 에이전트 팀이 협업하여 한 번에 생성한다.910## 실행 모드1112**에이전트 팀** — 4명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| program-architect | `.claude/agents/program-architect.md` | 프로그램 설계, 주기화, 스케줄 | general-purpose |19| exercise-guide | `.claude/agents/exercise-guide.md` | 운동 동작 설명, 폼 가이드, 대체운동 | general-purpose |20| nutrition-linker | `.claude/agents/nutrition-linker.md` | 운동별 영양전략, 보충제, 타이밍 | general-purpose |21| template-builder | `.claude/agents/template-builder.md` | 기록지, 추적표, 평가 양식 | general-purpose |2223## 워크플로우2425### Phase 1: 준비 (오케스트레이터 직접 수행)26271. 사용자 입력에서 추출한다:28 - **목표**: 근비대/근력/다이어트/체력향상/재활29 - **체력 수준**: 초보자/중급자/상급자, 운동 경력30 - **가용 자원**: 주 X회, 회당 X분, 장비(헬스장/홈트/맨몸)31 - **신체 정보** (선택): 성별, 연령, 신장, 체중32 - **부상 이력** (선택): 부위, 현재 상태33 - **기존 프로그램** (선택): 현재 수행 중인 프로그램342. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다353. 입력을 정리하여 `_workspace/00_input.md`에 저장한다364. 요청 범위에 따라 **실행 모드를 결정**한다3738### Phase 2: 팀 구성 및 실행3940| 순서 | 작업 | 담당 | 의존 | 산출물 |41|------|------|------|------|--------|42| 1 | 프로그램 설계 + 주간 스케줄 | architect | 없음 | `01_program_design.md`, `02_weekly_schedule.md` |43| 2a | 운동 가이드 문서 | guide | 작업 1 | `03_exercise_guide.md` |44| 2b | 식단 연계표 | linker | 작업 1 | `04_nutrition_plan.md` |45| 3 | 진행 기록 템플릿 | builder | 작업 1, 2a, 2b | `05_tracking_template.md` |4647작업 2a(운동 가이드)와 2b(식단 연계)는 **병렬 실행**한다.4849**팀원 간 소통 흐름:**50- architect 완료 → guide에게 운동 목록·주의사항 전달, linker에게 강도·볼륨·목표 전달, builder에게 주기화 일정 전달51- guide 완료 → linker에게 고강도 운동 목록 전달, builder에게 기록 항목 전달52- linker 완료 → builder에게 영양 추적 항목 전달53- builder는 모든 정보를 통합하여 템플릿 생성. 누락 항목 발견 시 해당 에이전트에게 확인 요청5455### Phase 3: 통합 및 최종 산출물56571. `_workspace/` 내 모든 파일을 확인한다582. 프로그램-스케줄-가이드-영양-템플릿 간 일관성을 확인한다593. 최종 요약을 사용자에게 보고한다:60 - 프로그램 설계서 — `01_program_design.md`61 - 주간 스케줄 — `02_weekly_schedule.md`62 - 운동 가이드 — `03_exercise_guide.md`63 - 식단 연계표 — `04_nutrition_plan.md`64 - 기록 템플릿 — `05_tracking_template.md`6566## 작업 규모별 모드6768| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |69|----------------|----------|-------------|70| "운동 프로그램 전체 짜줘" | **풀 파이프라인** | 4명 전원 |71| "주간 운동 스케줄만" | **스케줄 모드** | architect 단독 |72| "스쿼트 폼 알려줘" | **가이드 모드** | guide 단독 |73| "벌크업 식단 연계해줘" (프로그램 있음) | **영양 모드** | linker 단독 |74| "운동 기록지 만들어줘" | **템플릿 모드** | builder 단독 |75| "이 프로그램 분석해줘" (기존 파일) | **분석 모드** | architect + guide |7677**기존 파일 활용**: 사용자가 기존 프로그램을 제공하면, `_workspace/01_program_design.md`로 복사하고 architect를 건너뛴다.7879## 데이터 전달 프로토콜8081| 전략 | 방식 | 용도 |82|------|------|------|83| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |84| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |85| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |8687파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`8889## 에러 핸들링9091| 에러 유형 | 전략 |92|----------|------|93| 사용자 정보 부족 | 보수적(초보자) 기준으로 설계, "체력 수준 미확인" 명시 |94| 부상 이력 | 해당 부위 운동 제외 또는 대체 + "전문의 상담 권고" |95| 장비 제한 | 가용 장비 내 대체 운동으로 구성 |96| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |97| 프로그램 비일관성 | architect에게 수정 요청 (최대 2회) |9899## 테스트 시나리오100101### 정상 흐름102**프롬프트**: "헬스장 다니는 초보자인데, 근비대 목표로 주 4회 운동 프로그램 짜줘. 178cm, 75kg, 28세 남성이야"103**기대 결과**:104- 프로그램: 상·하체 4분할, 12주 주기화(적응→축적→강화→디로드)105- 스케줄: 주 4회 × 60분, 운동별 세트·반복·RPE 명시106- 가이드: 프로그램 내 모든 운동(15~20개)의 폼 설명 + 대체운동107- 영양: 벌크업 칼로리(TDEE+300), 매크로, 운동 전후 타이밍108- 템플릿: 일일 기록지, 주간 요약, 4주 평가 양식, 체성분 추적표109110### 기존 파일 활용 흐름111**프롬프트**: "지금 하고 있는 PPL 루틴인데 식단이랑 연계해줘" + 프로그램 파일 첨부112**기대 결과**:113- 기존 프로그램을 `_workspace/01_program_design.md`로 복사114- 영양 모드: linker 투입, 기존 프로그램 강도 분석 후 식단 연계표 생성115116### 에러 흐름117**프롬프트**: "허리디스크 있는데 운동 프로그램 짜줘"118**기대 결과**:119- 부상 이력 반영: 허리 부담 운동(데드리프트, 바벨 스쿼트) 제외120- 코어 안정화 운동 포함, 대체 운동(레그프레스, 머신 기반) 제시121- 모든 운동에 "허리 주의" ⚠️ 표시 + "정형외과/재활의학과 상담 권고"122- 점진적 강도 증가를 더 보수적으로 설정123124## 에이전트별 확장 스킬125126| 에이전트 | 확장 스킬 | 용도 |127|---------|----------|------|128| exercise-guide | `exercise-biomechanics` | 운동 생체역학, 근육 활성화, 대체 운동 |129| program-architect, template-builder | `periodization-engine` | 주기화 설계, 볼륨·강도 계산, 디로드 전략 |