入门

简介

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)