가이드

비전

비전은 방향을 이끄는 레이어입니다. 인간이 프로젝트의 방향을 정의하고 — 목표, 마일스톤, 우선순위를 설정합니다. AI는 adapt 단계에서 비전을 참조하여 갭을 분석하고 다음 목표를 제안하지만, 비전은 인간이 소유합니다.

구조

text

.reap/vision/
  goals.md              # North star objectives and milestones
  docs/                 # Planning documents, specs, design notes
  memory/               # AI memory (3-tier)
    longterm.md          #   Project lifetime — lessons, decision rationale
    midterm.md           #   Multi-generation — ongoing plans, agreed directions
    shortterm.md         #   1-2 sessions — next session handoff, immediate context

목표

goals.md는 프로젝트의 장기 목표를 체크리스트로 포함합니다. adapt 단계에서 AI가 비전과 현재 상태 간의 갭을 분석하여 다음 Generation의 목표를 제안합니다. 완료된 목표는 자동으로 체크됩니다.

markdown

# Vision Goals

## Ultimate Goal
Build a self-evolving development pipeline.

## Goal Items
- [x] Core lifecycle implementation
- [x] Merge lifecycle
- [ ] README rewrite for v0.16
- [ ] External project validation

메모리

메모리는 AI가 세션과 Generation 간에 맥락을 유지하는 자유 형식 기록 시스템입니다. genome(수정 제한이 있는)이나 lineage(압축되는)와 달리 메모리는 항상 접근 가능하고 자유롭게 쓸 수 있습니다.

계층	역할	판단 기준
Shortterm	세션 핸드오프 — 다음 세션에 넘길 맥락	"지금 당장 필요한가?"
Midterm	진행 중인 트랙 — 여러 Generation에 걸친 작업	"아직 완료되지 않은 큰 트랙인가?"
Longterm	설계 교훈 — 반복 참조할 가치가 있는 것	"같은 실수를 막는가?"

업데이트 시점

Reflect 단계 — 메모리를 업데이트하기 자연스러운 시점 (shortterm은 매 Generation 필수)
언제든지 — 유용한 맥락이 발생하면 어떤 단계에서든 메모리를 업데이트할 수 있음
Shortterm 정리 — 처리된 항목 제거

메모리에 쓰지 말 것

코드 변경 세부 사항 — environment에 속함
테스트 수나 빌드 상태 — artifact에 속함
이미 genome에 있는 원칙 — 중복 금지

갭 기반 진화

Completion의 adapt 단계에서 AI는:

goals.md를 읽고 백로그를 스캔
미완료 목표와 대기 중인 작업을 식별
현재 프로젝트 상태와 교차 참조
가장 영향력 있는 갭에 기반하여 다음 Generation의 목표를 제안