入门
简介
REAP(递归进化自治流水线)是一个 AI 与人类协作的开发流水线,通过连续的代逐步进化应用程序。REAP 不是将每次 AI 会话视为孤立任务,而是通过结构化的生命周期和名为 Genome 的活知识库来维持连续性。
四层架构
Vision
目标 + Memory
.reap/vision/
Knowledge
Genome + Environment
.reap/genome/ + .reap/environment/
Generation
进化周期
.reap/life/ → .reap/lineage/
Civilization
源代码
your codebase/
- Vision长期目标和方向。Vision 驱动每一代——它决定下一步追求什么目标。Memory 是一个三层自由格式记录系统,供 AI 在会话间持久化上下文。
- KnowledgeGenome(规范性——架构、约定、约束)和 Environment(描述性——技术栈、源码结构、领域)。每一代工作的基础。
- Generation由 Vision 驱动、以 Knowledge 为基础的单个进化周期。遵循 Learning → Planning → Implementation → Validation → Completion。
- Civilization源代码和 .reap/ 之外的所有项目产物。代所进化的对象。经验教训反馈到 Knowledge。
为什么选择 REAP?
| 问题 | REAP 解决方案 |
|---|---|
| 上下文丢失——代理每次会话都会丢失项目上下文 | CLAUDE.md + Memory——每次会话加载 genome、environment 和 reap-guide。Memory 在会话间持久化上下文。 |
| 开发分散——代码修改没有明确目标 | 代模型——每一代通过结构化的生命周期专注于一个目标 |
| 设计与代码脱节——文档与代码不一致 | 通过 Backlog 的 Genome 变更——实现过程中记录设计缺陷,在 Completion adapt 阶段应用 |
| 经验教训遗忘——过去工作的见解丢失 | Lineage 与 Memory——经验教训积累在 genome 和 memory 中,代被归档和压缩 |
| 协作混乱——并行工作导致变更冲突 | 分布式工作流——Genome 优先的合并在代码之前解决设计冲突,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)