REAP LogoREAPdocsv0.17.7
기타

마이그레이션 가이드 (v0.15 → v0.16)

REAP v0.16은 자기 진화 파이프라인 아키텍처를 기반으로 완전히 재작성되었습니다. 라이프사이클, genome 구조, 구성, 비전 시스템이 모두 재설계되었습니다. 가이드된 마이그레이션 도구가 자동으로 전환을 처리합니다.

왜 마이그레이션하나요?

  • 라이프사이클 재설계: learning이 첫 번째 단계로 objective를 대체
  • Genome이 3개의 집중 파일로 재구성 (application.md, evolution.md, invariants.md)
  • 세대 간 맥락 유지를 위한 3계층 메모리의 비전 레이어
  • Genome 우선 조정이 있는 Merge 라이프사이클
  • 파일 기반 Hook이 인라인 Hook 구성을 대체

마이그레이션 단계

Step 1: v0.16을 전역으로 설치합니다. v0.16 스킬이 자동 배포되고 레거시 v0.15 프로젝트 레벨 스킬이 제거됩니다.

bash
npm install -g @c-d-cc/reap

Step 2: 프로젝트에서 Claude Code를 열고 마이그레이션 명령을 실행합니다.

bash
/reap.update

Step 3: 5단계 가이드 마이그레이션을 따릅니다:

단계수행 내용역할
confirm변경 사항을 표시하고 .reap/v15/에 백업 생성검토 및 확인
execute디렉토리 재구성, config/hooks/lineage/backlog 마이그레이션자동
genome-convertAI가 v0.15 파일에서 새 3파일 구조로 genome 재구성AI 작업 검토
visionvision/goals.md와 메모리 계층 파일 설정프로젝트 방향 제공
complete마이그레이션 결과 요약확인

Step 4: 마이그레이션 성공 여부를 확인합니다.

bash
/reap.status
/reap.evolve

변경 사항

영역v0.15v0.16
Lifecycleobjective → planning → impl → validation → completion (5단계)learning → planning → impl → validation → completion (4단계)
Genome다수 파일, 평면 구조3개 파일: application.md + evolution.md + invariants.md
ConfigJSON 기반 구성YAML 기반 config.yml (cruiseCount, strictEdit, strictMerge, autoSubagent)
Vision비전 시스템 없음vision/goals.md + 3계층 메모리
Hooks인라인 구성파일 기반: .reap/hooks/{event}.{name}.{md|sh}
Environment단일 지식 파일2계층: summary.md (항상 로드) + domain/ (온디맨드)

중단된 마이그레이션

마이그레이션이 중단되면 (API 오류, 세션 연결 끊김 등), 진행 상태가 .reap/migration-state.yml에 저장됩니다. 이 파일은 완료된 단계를 추적합니다.

재개하려면: /reap.update를 다시 실행하세요. 완료된 단계를 건너뛰고 중단된 곳부터 계속합니다.

처음부터 다시 하려면: .reap/migration-state.yml을 삭제하고 /reap.update를 다시 실행하세요.

yaml
# .reap/migration-state.yml (example)
version: "0.16"
phases:
  confirm: completed
  execute: completed
  genome-convert: in-progress
  vision: pending
  complete: pending

백업

모든 v0.15 파일은 confirm 단계에서 .reap/v15/에 보존됩니다. 이것은 마이그레이션 전 상태의 완전한 스냅샷입니다.

  • 백업은 파괴적인 변경이 발생하기 전에 생성됩니다
  • 마이그레이션이 작동하는지 확인한 후 (/reap.status, /reap.evolve) .reap/v15/를 안전하게 삭제할 수 있습니다
  • 모든 것이 작동하는지 확인하기 위해 최소 하나의 전체 Generation 동안 백업을 유지하세요

지원 중단 명령어

여러 v0.15 슬래시 명령어가 v0.16에서 이름이 변경되거나 통합되었습니다.

v0.15 명령어v0.16 대체비고
/reap.sync/reap.knowledgegenome, environment, 맥락 지식 관리
/reap.refreshKnowledge/reap.knowledge reload디스크에서 모든 지식 다시 로드
/reap.objective/reap.run단계별 명령어가 reap run <stage>로 대체
/reap.complete/reap.run단계별 명령어가 reap run <stage>로 대체

레거시 v0.15 프로젝트 레벨 스킬 파일은 npm install 시 자동으로 제거됩니다. .claude/commands/에 남아 있으면 안전하게 삭제할 수 있습니다.