ガイド

ビジョン

ビジョンは方向を導くレイヤーです。人間がプロジェクトの行き先を定義し — 目標、マイルストーン、優先順位を設定します。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 の目標を提案