はじめに

イントロダクション

REAP（Recursive Evolutionary Autonomous Pipeline）は、AIと人間が協力してアプリケーションを世代ごとに段階的に進化させる開発パイプラインです。各AIセッションを独立したタスクとして扱うのではなく、REAPは構造化されたライフサイクルとGenomeと呼ばれる生きた知識ベースを通じて継続性を維持します。

4層アーキテクチャ

Vision

Goals + Memory

.reap/vision/

Knowledge

Genome + Environment

.reap/genome/ + .reap/environment/

Generation

進化サイクル

.reap/life/ → .reap/lineage/

Civilization

ソースコード

your codebase/

Vision長期的な目標と方向性。Visionが各世代を駆動し、次に追求すべき目標を決定します。Memoryは3層の自由形式記録システムで、AIがセッション間でコンテキストを持続させます。
KnowledgeGenome（規範的 — アーキテクチャ、コンベンション、制約）とEnvironment（記述的 — 技術スタック、ソース構造、ドメイン）。各世代の作業の基盤となります。
GenerationVisionに駆動され、Knowledgeに基づく単一の進化サイクル。Learning → Planning → Implementation → Validation → Completionに従います。
Civilizationソースコードおよび.reap/外のすべてのプロジェクトアーティファクト。世代が進化させるもの。教訓はKnowledgeにフィードバックされます。

なぜREAP？

課題	REAPの解決策
コンテキストの喪失 — エージェントが毎セッションでプロジェクトコンテキストを忘れる	CLAUDE.md + Memory — 毎セッションでgenome、environment、reap-guideをロード。Memoryがセッション間でコンテキストを持続。
散在した開発 — 明確な目標なくコードが変更される	Generationモデル — 各世代は構造化されたライフサイクルで一つの目標に集中
設計とコードの乖離 — ドキュメントがコードから乖離する	Backlogを通じたGenome変更 — 実装中に発見された設計の欠陥を記録し、Completionのadaptフェーズで適用
忘れられた教訓 — 過去の作業からの知見が失われる	LineageとMemory — 教訓がgenomeとmemoryに蓄積され、世代がアーカイブ・圧縮される
コラボレーションの混乱 — 並行作業が競合する変更を引き起こす	分散ワークフロー — Genome優先のmergeがコードの前に設計を調整、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)