왜 REAP인가?
AI 에이전트는 강력하지만, 구조 없이는 개발이 혼란스러워집니다. 매 세션마다 컨텍스트가 초기화됩니다. 코드 변경이 목적 없이 흩어집니다. 설계 문서가 현실에서 벗어납니다. 과거 작업에서 얻은 교훈이 사라집니다.
컨텍스트 손실
CLAUDE.md + Memory가 매 세션마다 전체 프로젝트 컨텍스트를 자동으로 복원합니다
산발적 개발
각 Generation이 구조화된 라이프사이클을 통해 하나의 목표에 집중합니다
설계-코드 괴리
구현 중 발견된 Genome 변이가 backlog를 통해 피드백됩니다
잊혀진 교훈
회고가 Genome에 축적됩니다. Lineage가 모든 Generation을 아카이브합니다
협업 혼란
Genome 우선 merge 워크플로우가 병렬 브랜치를 조율합니다 — 코드 충돌 전에 설계 충돌을 해결합니다
4계층 아키텍처
REAP는 네 개의 상호 연결된 계층으로 구성됩니다: Knowledge가 기반을 제공하고, Vision이 방향을 이끌며, Generation이 작업을 수행하고, Civilization이 진화하는 대상입니다.
Knowledge
Genome + Environment
Genome(규범적 — 아키텍처, 컨벤션, 제약)과 Environment(서술적 — 기술 스택, 소스 구조, 도메인). 각 Generation 작업의 기반입니다.
Vision
Goals + Memory
장기 목표와 방향. Vision이 각 Generation을 이끕니다 — 다음에 추구할 목표를 결정합니다. Memory는 세션 간 컨텍스트를 유지합니다.
Generation
Evolution Cycle
각 Generation은 Learning → Planning → Implementation → Validation → Completion을 거칩니다. 완료 시 lineage에 아카이브됩니다.
Civilization
Source Code
.reap/ 외부의 모든 것. Generation이 진화시키는 대상입니다. 교훈이 Knowledge로 피드백됩니다.
Generation 라이프사이클
각 Generation은 목표 정의에서 회고 및 아카이브까지 다섯 단계를 거칩니다.
Learning→Planning→Implementation⟷Validation→Completion
| 단계 | 수행 내용 | 산출물 |
|---|---|---|
| Learning | 프로젝트 탐색, 컨텍스트 구축, genome과 environment 검토 | 01-learning.md |
| Planning | 작업 분해, 접근법 선택, 의존성 매핑 | 02-planning.md |
| Implementation | AI + 인간 협업으로 구현 | 03-implementation.md |
| Validation | 테스트 실행, 완료 기준 검증 | 04-validation.md |
| Completion | 회고 + 적합도 피드백 + genome 적응 + 아카이브 (4단계) | 05-completion.md |
설치
1. 전역 설치
bash
npm install -g @c-d-cc/reap # Global installation required2. AI 에이전트(Claude Code 또는 OpenCode)를 열고, 초기화 및 시작
bash
claude
> /reap.init # Set up genome, environment, vision through guided conversation
> /reap.evolve # Run a full generation lifecycle/reap.evolve은 전체 Generation 라이프사이클 — Learning부터 Completion까지 — 을 자율적으로 수행합니다. 단계별 명령어로 수동 제어도 가능합니다.
핵심 개념
Genome 불변성
Genome은 일반 Generation 중에 수정되지 않습니다. 이슈는 genome-change backlog 항목으로 기록되고 Completion의 adapt 단계에서 적용됩니다. (Embryo Generation에서는 자유 수정이 가능합니다.)
Backlog & 지연
.reap/life/backlog/ 항목은 type: genome-change | environment-change | task를 가집니다. 부분 완료는 정상입니다 — 지연된 작업은 다음 Generation으로 이월됩니다.
Vision & Memory
Vision(.reap/vision/)이 각 Generation의 목표를 이끕니다. Memory는 AI가 세션 간 컨텍스트를 유지하기 위한 3계층 자유 형식 기록 시스템(longterm/midterm/shortterm)입니다.
Lineage
완료된 Generation은 .reap/lineage/에 아카이브됩니다. 회고가 거기에 축적됩니다. 시간이 지나면 압축됩니다 (Level 1 → gen-XXX-{hash}.md, Level 2 → epoch.md).
4계층 아키텍처
Vision(목표 + 메모리), Knowledge(genome + environment), Generation(라이프사이클), Civilization(소스 코드).
분산 워크플로우
여러 개발자나 에이전트가 별도 브랜치에서 병렬로 작업합니다. /reap.pull이 genome 우선 merge generation을 가져와 실행합니다. /reap.push가 push 전 상태를 검증합니다. 서버 불필요 — Git이 전송 계층입니다.
문서
소개
REAP란 무엇인가, 왜 사용하는가, 4계층 아키텍처.
빠른 시작
설치하고 첫 번째 Generation을 단계별로 실행합니다.
핵심 개념
Genome, 라이프사이클, Backlog & 지연을 심층적으로 다룹니다.
Life Cycle
/reap.evolve, 단계별 명령어, 마이크로 루프, completion 단계.
자기 진화
명확도 기반 인터랙션, 크루즈 모드, 메모리, 격차 기반 진화.
명령어 레퍼런스
/reap.evolve, 단계별 명령어, /reap.status — 모든 슬래시 명령어.
Hook 레퍼런스
라이프사이클 hooks: 파일 기반 이벤트 hooks, 조건, 실행 순서.
마이그레이션 가이드
v0.15에서 업그레이드 — 재개 지원이 포함된 단계별 마이그레이션.
비교
REAP가 기존 스펙 기반 개발 도구와 어떻게 다른가.
고급
서명 기반 잠금, lineage 압축, 진입 모드.