시작하기

빠른 시작

Upgrading from v0.15? See the Migration Guide instead.

사전 요구사항

필수Node.js— v18 이상

필수npm— Node.js에 포함됨

필수Claude Code 또는 OpenCode— AI 에이전트 CLI (최소 하나 필요)

선택Bun— 대체 패키지 관리자

설치

Global installation required. Local project-level installation is blocked.

bash

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

# or Bun
bun install -g @c-d-cc/reap

프로젝트 초기화

bash

# In Claude Code, initialize REAP in your project
> /reap.init

첫 번째 Generation 실행

프로젝트 디렉토리에서 AI 에이전트(Claude Code 또는 OpenCode)를 엽니다:

bash

# Start a generation — /reap.start will prompt for a goal
> /reap.evolve

/reap.evolve 이 주요 명령어입니다

전체 Generation 라이프사이클 — Learning, Planning, Implementation, Validation, Completion — 을 자율적으로 수행합니다. AI 에이전트가 모든 단계를 진행하며, 진정으로 막혔을 때만 멈춥니다. 일상적인 개발에서 가장 많이 사용하게 될 명령어입니다.

수동 단계 제어

각 단계를 개별적으로 제어할 수도 있습니다:

bash

> /reap.start            # Start a new generation (prompts for goal)
> /reap.next             # Advance to next stage
> /reap.back             # Return to previous stage

Generation 중 일어나는 일

단계	수행 내용	산출물
Learning	프로젝트 탐색, 컨텍스트 구축, genome과 environment 검토	01-learning.md
Planning	작업 분해, 접근법 선택, 의존성 매핑	02-planning.md
Implementation	AI + 인간 협업으로 구현	03-implementation.md
Validation	테스트 실행, 완료 기준 검증	04-validation.md
Completion	회고, 적합도 피드백 수집, genome 적응, 아카이브	05-completion.md

명령어 로딩 방식

REAP 슬래시 명령어는 REAP 프로젝트에서만 로딩됩니다 — REAP가 아닌 프로젝트에서는 나타나지 않습니다.

소스— 명령어 원본은 ~/.reap/commands/에 저장됩니다 (reap init과 reap update로 설치됨)

로딩— REAP 프로젝트를 열면 세션 hook이 자동으로 .claude/commands/에 심볼릭 링크를 생성합니다

비-REAP 프로젝트— 심볼릭 링크가 생성되지 않으므로 AI 에이전트의 스킬 목록에 REAP 스킬이 나타나지 않습니다

하위 호환성— ~/.claude/commands/의 리다이렉트 스텁이 마이그레이션 중 이전 설정의 호환성을 유지합니다