운동 프로그램의 목표별 설계부터 진행 기록 템플릿까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '운동 프로그램 짜줘', '헬스 루틴', '근력 프로그램', '다이어트 운동', '홈트레이닝', '주간 운동 스케줄', '벌크업 프로그램', '마라톤 훈련', '운동 루틴 추천', 'PPL 프로그램', '맨몸운동 루틴' 등 운동·트레이닝 프로그램 관련 요청에 이 스킬을 사용한다. 기존 프로그램이 있으면 분석이나 개선을 지원한다. 단, 재활치료 프로그램 처방(물리치료사 업무), 경기력 향상 약물 상담, 실시간 퍼스널 트레이닝은 이 스킬의 범위가 아니다.
목표별프로그램설계→주간스케줄→운동가이드문서→식단연계표→진행기록템플릿을 에이전트 팀이 협업하여 한 번에 생성한다.
에이전트 팀 — 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 |
_workspace/ 디렉토리를 프로젝트 루트에 생성한다_workspace/00_input.md에 저장한다| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|---|---|---|---|
| 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(식단 연계)는 병렬 실행한다.
팀원 간 소통 흐름:
_workspace/ 내 모든 파일을 확인한다01_program_design.md02_weekly_schedule.md03_exercise_guide.md04_nutrition_plan.md05_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세 남성이야" 기대 결과:
프롬프트: "지금 하고 있는 PPL 루틴인데 식단이랑 연계해줘" + 프로그램 파일 첨부 기대 결과:
_workspace/01_program_design.md로 복사프롬프트: "허리디스크 있는데 운동 프로그램 짜줘" 기대 결과:
| 에이전트 | 확장 스킬 | 용도 |
|---|---|---|
| exercise-guide | exercise-biomechanics | 운동 생체역학, 근육 활성화, 대체 운동 |
| program-architect, template-builder | periodization-engine | 주기화 설계, 볼륨·강도 계산, 디로드 전략 |