fitness-program

name	fitness-program
description	운동 프로그램의 목표별 설계부터 진행 기록 템플릿까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '운동 프로그램 짜줘', '헬스 루틴', '근력 프로그램', '다이어트 운동', '홈트레이닝', '주간 운동 스케줄', '벌크업 프로그램', '마라톤 훈련', '운동 루틴 추천', 'PPL 프로그램', '맨몸운동 루틴' 등 운동·트레이닝 프로그램 관련 요청에 이 스킬을 사용한다. 기존 프로그램이 있으면 분석이나 개선을 지원한다. 단, 재활치료 프로그램 처방(물리치료사 업무), 경기력 향상 약물 상담, 실시간 퍼스널 트레이닝은 이 스킬의 범위가 아니다.

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: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
   • 목표: 근비대/근력/다이어트/체력향상/재활
   • 체력 수준: 초보자/중급자/상급자, 운동 경력
   • 가용 자원: 주 X회, 회당 X분, 장비(헬스장/홈트/맨몸)
   • 신체 정보 (선택): 성별, 연령, 신장, 체중
   • 부상 이력 (선택): 부위, 현재 상태
   • 기존 프로그램 (선택): 현재 수행 중인 프로그램
2. _workspace/ 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 _workspace/00_input.md에 저장한다
4. 요청 범위에 따라 실행 모드를 결정한다

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: 통합 및 최종 산출물

1. _workspace/ 내 모든 파일을 확인한다
2. 프로그램-스케줄-가이드-영양-템플릿 간 일관성을 확인한다
3. 최종 요약을 사용자에게 보고한다:
   • 프로그램 설계서 — 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	주기화 설계, 볼륨·강도 계산, 디로드 전략