시작하기

소개

REAP(Recursive Evolutionary Autonomous Pipeline)는 AI와 인간이 협업하여 연속적인 Generation을 통해 애플리케이션을 점진적으로 진화시키는 개발 파이프라인입니다. 각 AI 세션을 독립된 작업으로 취급하는 대신, REAP는 구조화된 라이프사이클과 Genome이라는 살아있는 지식 기반을 통해 연속성을 유지합니다.

4계층 아키텍처

Vision

Goals + Memory

.reap/vision/

Knowledge

Genome + Environment

.reap/genome/ + .reap/environment/

Generation

Evolution Cycle

.reap/life/ → .reap/lineage/

Civilization

Source Code

your codebase/

Vision장기 목표와 방향. Vision이 각 Generation을 이끕니다 — 다음에 추구할 목표를 결정합니다. Memory는 AI가 세션 간 컨텍스트를 유지하기 위한 3계층 자유 형식 기록 시스템입니다.
KnowledgeGenome(규범적 — 아키텍처, 컨벤션, 제약)과 Environment(서술적 — 기술 스택, 소스 구조, 도메인). 각 Generation 작업의 기반입니다.
GenerationVision에 의해 주도되고 Knowledge에 기반한 단일 진화 사이클. Learning → Planning → Implementation → Validation → Completion을 따릅니다.
Civilization.reap/ 외부의 소스 코드와 모든 프로젝트 산출물. Generation이 진화시키는 대상입니다. 교훈이 Knowledge로 피드백됩니다.

왜 REAP인가?

문제	REAP 솔루션
컨텍스트 손실 — 에이전트가 매 세션마다 프로젝트 컨텍스트를 잊음	CLAUDE.md + Memory — 매 세션마다 genome, environment, reap-guide를 로드합니다. Memory가 세션 간 컨텍스트를 유지합니다.
산발적 개발 — 명확한 목표 없이 코드가 수정됨	Generation 모델 — 각 Generation이 구조화된 라이프사이클로 하나의 목표에 집중합니다
설계-코드 괴리 — 문서가 코드에서 벗어남	Backlog를 통한 Genome 변이 — 구현 중 발견된 설계 결함이 기록되고, Completion adapt 단계에서 적용됩니다
잊혀진 교훈 — 과거 작업의 인사이트가 소실됨	Lineage & Memory — 교훈이 genome과 memory에 축적되고, Generation이 아카이브되어 압축됩니다
협업 혼란 — 병렬 작업이 충돌하는 변경으로 이어짐	분산 워크플로우 — Genome 우선 merge가 코드 전에 설계를 조율하고, DAG lineage가 병렬 브랜치를 추적합니다

프로젝트 구조

text

my-project/
├── src/                          # Civilization (your code)
└── .reap/
    ├── config.yml                # Project configuration
    ├── genome/                   # Prescriptive knowledge (how to build)
    │   ├── application.md        #   Project identity, architecture, conventions
    │   ├── evolution.md          #   AI behavior guide, evolution principles
    │   └── invariants.md         #   Absolute constraints (human-only edits)
    ├── environment/              # Descriptive knowledge (what exists now)
    │   ├── summary.md            #   Always loaded — tech stack, source structure
    │   ├── domain/               #   Domain knowledge (on-demand)
    │   ├── resources/            #   External reference docs (on-demand)
    │   ├── docs/                 #   Project reference docs (on-demand)
    │   └── source-map.md         #   Code structure + dependencies (on-demand)
    ├── vision/                   # Long-term goals and direction
    │   ├── goals.md              #   North star objectives
    │   └── memory/               #   AI memory (longterm/midterm/shortterm)
    ├── life/                     # Current generation
    │   ├── current.yml
    │   └── backlog/
    ├── lineage/                  # Completed generation archive
    └── hooks/                    # Lifecycle hooks (.md/.sh)