Gear Curriculum

소스 및 출력 경로

• 소스 문서: 2026-04-01-gear-design-mathematics/
• 작업 디렉토리: _workspace/ (프로젝트 루트 하위)
• 최종 산출물: gear-curriculum/ (프로젝트 루트 하위)

워크플로우

Phase 1: 준비

1. 프로젝트 루트에 _workspace/ 디렉토리 생성
2. 소스 문서 존재 확인 (2026-04-01-gear-design-mathematics/ 내 9개 파일)

Phase 2: 커리큘럼 계획 (순차)

planner 에이전트를 실행하여 커리큘럼 구조를 설계한다.

Agent(
  name: "planner",
  subagent_type: "curriculum-planner",
  model: "opus",
  prompt: "
    Skill 도구로 /plan-gear-curriculum 을 호출하라.
    소스 문서 디렉토리: {프로젝트루트}/2026-04-01-gear-design-mathematics/
    출력: {프로젝트루트}/_workspace/01_planner_curriculum-plan.md

    모든 소스 문서 9개를 읽고 교육 커리큘럼 구조를 설계하라.
    스킬의 절차를 따르되, 소스의 모든 수식과 개념이 빠짐없이 매핑되어야 한다.
  "
)

Phase 2 완료 후: _workspace/01_planner_curriculum-plan.md 존재 확인.

Phase 3: 모듈 집필 (병렬)

커리큘럼 플랜을 기반으로 3명의 writer를 병렬 실행한다. 단일 메시지에서 3개 Agent 도구를 동시 호출.

writer-A (모듈 00~03: 기초):

Agent(
  name: "writer-A",
  subagent_type: "edu-writer",
  model: "opus",
  run_in_background: true,
  prompt: "
    Skill 도구로 /write-edu-module 을 호출하라.

    담당 모듈: 00(학습 가이드), 01(인볼류트 곡선), 02(기어 매개변수), 03(이 프로파일)
    커리큘럼 플랜: {프로젝트루트}/_workspace/01_planner_curriculum-plan.md
    소스 문서: {프로젝트루트}/2026-04-01-gear-design-mathematics/
    상세 참조: {프로젝트루트}/.claude/skills/write-edu-module/references/module-templates.md

    각 모듈을 별도 파일로 출력:
    - {프로젝트루트}/_workspace/02_writer_mod-00.md
    - {프로젝트루트}/_workspace/02_writer_mod-01.md
    - {프로젝트루트}/_workspace/02_writer_mod-02.md
    - {프로젝트루트}/_workspace/02_writer_mod-03.md

    소스의 수식과 개념을 빠짐없이 포함하되, 쉬운 언어로 설명하라.
    마크다운으로 시각화할 수 없는 그래프/곡선은 파이썬 코드로 제공하라.
  "
)

writer-B (모듈 04~05: 중급):

Agent(
  name: "writer-B",
  subagent_type: "edu-writer",
  model: "opus",
  run_in_background: true,
  prompt: "
    Skill 도구로 /write-edu-module 을 호출하라.

    담당 모듈: 04(기어 강도와 접촉), 05(기어 종류별 3D 기하학)
    커리큘럼 플랜: {프로젝트루트}/_workspace/01_planner_curriculum-plan.md
    소스 문서: {프로젝트루트}/2026-04-01-gear-design-mathematics/
    상세 참조: {프로젝트루트}/.claude/skills/write-edu-module/references/module-templates.md

    각 모듈을 별도 파일로 출력:
    - {프로젝트루트}/_workspace/02_writer_mod-04.md
    - {프로젝트루트}/_workspace/02_writer_mod-05.md

    소스의 수식과 개념을 빠짐없이 포함하되, 쉬운 언어로 설명하라.
    마크다운으로 시각화할 수 없는 그래프/곡선은 파이썬 코드로 제공하라.
  "
)

writer-C (모듈 06~08: 고급):

Agent(
  name: "writer-C",
  subagent_type: "edu-writer",
  model: "opus",
  run_in_background: true,
  prompt: "
    Skill 도구로 /write-edu-module 을 호출하라.

    담당 모듈: 06(절삭 공구), 07(웜 기어), 08(수치 구현과 검증)
    커리큘럼 플랜: {프로젝트루트}/_workspace/01_planner_curriculum-plan.md
    소스 문서: {프로젝트루트}/2026-04-01-gear-design-mathematics/
    상세 참조: {프로젝트루트}/.claude/skills/write-edu-module/references/module-templates.md

    각 모듈을 별도 파일로 출력:
    - {프로젝트루트}/_workspace/02_writer_mod-06.md
    - {프로젝트루트}/_workspace/02_writer_mod-07.md
    - {프로젝트루트}/_workspace/02_writer_mod-08.md

    소스의 수식과 개념을 빠짐없이 포함하되, 쉬운 언어로 설명하라.
    마크다운으로 시각화할 수 없는 그래프/곡선은 파이썬 코드로 제공하라.
  "
)

Phase 3 완료 후: _workspace/02_writer_mod-00.md ~ _workspace/02_writer_mod-08.md 총 9개 파일 존재 확인.

Phase 4: 품질 검증 (순차)

reviewer 에이전트로 전체 모듈을 검증한다.

Agent(
  name: "reviewer",
  subagent_type: "curriculum-reviewer",
  model: "opus",
  prompt: "
    Skill 도구로 /review-edu-module 을 호출하라.

    커리큘럼 플랜: {프로젝트루트}/_workspace/01_planner_curriculum-plan.md
    교육 모듈: {프로젝트루트}/_workspace/02_writer_mod-00.md ~ mod-08.md
    소스 문서: {프로젝트루트}/2026-04-01-gear-design-mathematics/
    출력: {프로젝트루트}/_workspace/03_reviewer_report.md

    스킬의 검증 절차를 따라 모든 모듈을 검증하라.
    특히 소스 대비 수식/개념 누락 여부를 철저히 확인하라.
  "
)

Phase 5: 수정 반영 (조건부)

리뷰 보고서에 CRITICAL 이슈가 있으면:

1. 리뷰 보고서 읽기 (_workspace/03_reviewer_report.md)
2. CRITICAL 이슈가 있는 모듈을 담당한 writer를 재실행
3. 재실행 시 리뷰 피드백을 프롬프트에 포함
4. 최대 1회 재수정 (무한 루프 방지)

CRITICAL 이슈가 없으면 Phase 6으로 진행.

Phase 6: 최종 산출물 생성

1. gear-curriculum/ 디렉토리 생성
2. _workspace/02_writer_mod-*.md 파일들을 최종 경로로 복사/정리:

   gear-curriculum/
   ├── 00-학습-가이드.md
   ├── 01-인볼류트-곡선.md
   ├── 02-기어-매개변수.md
   ├── 03-이-프로파일-생성.md
   ├── 04-기어-강도와-접촉.md
   ├── 05-기어-종류-3D.md
   ├── 06-절삭-공구-설계.md
   ├── 07-웜-기어.md
   └── 08-수치-구현-검증.md
   

3. 모듈 간 교차 참조 링크를 상대 경로로 통일
4. 사용자에게 결과 요약 보고

Phase 7: 정리

1. _workspace/ 디렉토리 보존 (중간 산출물 사후 검증용)
2. 완료 보고:
   • 생성된 모듈 수
   • 총 분량 (줄 수)
   • 리뷰 결과 요약 (이슈 해결 현황)
   • 남은 MAJOR/MINOR 이슈 목록 (있을 경우)

데이터 흐름

[소스 9개 파일]
       │
       ▼
  [planner] → curriculum-plan.md
       │
       ├──────────────┬──────────────┐
       ▼              ▼              ▼
  [writer-A]     [writer-B]     [writer-C]
  mod-00~03      mod-04~05      mod-06~08
       │              │              │
       └──────────────┴──────────────┘
                      │
                      ▼
               [reviewer] → report.md
                      │
                      ▼ (CRITICAL 시)
               [writer 재실행]
                      │
                      ▼
              gear-curriculum/
              (최종 9개 모듈)

에러 핸들링

테스트 시나리오

정상 흐름

1. 사용자가 "기어 커리큘럼 만들어줘" 요청
2. Phase 1: _workspace/ 생성
3. Phase 2: planner가 커리큘럼 구조 설계 → 01_planner_curriculum-plan.md
4. Phase 3: 3명 writer 병렬 실행 → 9개 모듈 .md 생성
5. Phase 4: reviewer가 검증 → 03_reviewer_report.md (CRITICAL 0건)
6. Phase 5: 스킵 (CRITICAL 없음)
7. Phase 6: gear-curriculum/ 디렉토리에 최종 9개 파일 생성
8. Phase 7: 결과 요약 보고
9. 예상: gear-curriculum/00-학습-가이드.md ~ 08-수치-구현-검증.md

에러 흐름

1. Phase 3에서 writer-C 실패 (모듈 06~08)
2. writer-C 1회 재시도 시도
3. 재시도 성공 시: 정상 흐름으로 복귀
4. 재시도 실패 시: 모듈 06~08 미완성으로 표시
5. Phase 4: 사용 가능한 모듈만 리뷰
6. Phase 6: 완성 모듈만 gear-curriculum/에 출력, 미완성 모듈은 빈 파일 + "작성 중" 표시
7. 사용자에게 미완성 모듈 목록 보고