指南
核心概念
四层架构
REAP 由四个相互关联的层组成：
Vision
.reap/vision/
长期目标和方向。目标驱动每一代。Memory 在会话间持久化上下文。
Knowledge
.reap/genome/ + .reap/environment/
Genome（规范性——如何构建）+ Environment（描述性——现有内容）。每一代的基础。
Generation
.reap/life/
由 Vision 驱动、以 Knowledge 为基础的单个进化周期。遵循 Learning → Planning → Implementation → Validation → Completion。
Civilization
your codebase/
源代码和 .reap/ 之外的所有项目产物。代所进化的对象。经验教训反馈到 Knowledge。
核心原则
Genome 不可变性
在正常代中不会被修改。变更通过 backlog → Completion adapt 阶段。（Embryo 代允许自由修改。）
人类评判适应度
没有定量指标。人类的自然语言反馈是唯一的适应度信号。
清晰度驱动的交互
AI 根据上下文的清晰程度调整沟通深度——从主动对话到自主执行。详见自进化功能。
生命周期概览
每一代遵循五个阶段，每个阶段产生产物：
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 |
→ Lifecycle details · → Backlog & Deferral
会话上下文加载
打开 REAP 项目时，CLAUDE.md 会指示 AI 代理读取 genome、environment 和 REAP 指南。代理立即加载项目知识并了解当前状态。
进化流程
知识在代与代之间积累。每一代进化 Genome，经验教训积累在 Lineage 中：
text
Generation #1 (Genome v1)
→ Learning: explore project, build context
→ Planning → Implementation
→ OAuth2 need discovered → genome-change logged in backlog
→ Validation (partial)
→ Completion: reflect → fitness → adapt (genome v2) → commit → Archive
Generation #2 (Genome v2)
→ Learning: review updated genome, deferred tasks
→ Vision-driven goal: "OAuth2 integration + permission management"
→ ...