가이드

고급

서명 기반 잠금

REAP는 암호학적 nonce 체인을 사용하여 단계 순서를 강제합니다. 유효한 nonce 없이는 AI 에이전트가 다음 단계로 진행할 수 없습니다 — 건너뛰려고 해도 불가능합니다.

text

Stage Command          current.yml              /reap.next
─────────────          ───────────              ──────────
generate nonce ──────→ store hash(nonce)
return nonce to AI                         ←── AI passes nonce
                                               verify hash(nonce)
                                               ✓ advance stage

작동 원리

단계 명령어(예: /reap.objective)가 랜덤 nonce를 생성합니다
nonce의 SHA-256 해시가 current.yml에 저장됩니다
nonce가 JSON 응답으로 AI 에이전트에 반환됩니다
/reap.next가 nonce를 받아 해시하고 current.yml과 비교합니다
일치 → 단계 진행. 불일치 → 거부.

프롬프트 전용 vs 서명 기반

위협	프롬프트 전용	서명 기반
단계 건너뛰기	AI 준수에 의존	차단됨 — 유효한 nonce 없음
토큰 위조	해당 없음	불가능 — 단방향 해시
이전 nonce 재사용	해당 없음	차단됨 — 일회용, 단계 종속
프롬프트 인젝션	취약	nonce가 프롬프트 컨텍스트 외부에 존재

Lineage 압축

Generation이 축적됨에 따라 lineage 아카이브가 Completion 단계에서 자동으로 압축됩니다.

레벨	입력	출력	트리거	보호
Level 1	Generation 폴더 (5개 산출물)	gen-XXX-{hash}.md (40줄)	lineage > 5,000줄 + 5개 이상 Generation	최근 3개 + DAG 리프 노드
Level 2	100+ Level 1 파일	단일 epoch.md	Level 1 파일 > 100	최근 9개 + 포크 포인트

DAG 보존: Level 1 파일은 frontmatter에 메타데이터를 유지합니다. Level 2 epoch.md는 generation 해시 체인을 저장합니다. 포크 가드: 모든 로컬/원격 브랜치가 Level 2 압축 전에 스캔됩니다 — 포크 포인트가 보호됩니다. Epoch 압축된 Generation은 merge base로 사용할 수 없습니다.

진입 모드

reap init --mode로 지정합니다. Genome의 초기 구조를 제어합니다.

모드	설명
greenfield	처음부터 새 프로젝트를 만듭니다. 기본 모드입니다. Genome이 비어있는 상태에서 시작하여 성장합니다.
migration	기존 시스템을 참조하면서 새로 만듭니다. Genome이 기존 시스템 분석으로 시드됩니다.
adoption	기존 코드베이스에 REAP를 적용합니다. Genome이 템플릿에서 시작하여 첫 번째 Generation의 Learning 단계에서 채워집니다.