ELD Record

Context Delta の収集から知識移転まで、4フェーズで開発知識を永続化する。

Phase 1: Context Delta 収集

1-A. 開発プロセス知見の収集

作業中の重要な判断・発見を抽出する。

意思決定:

何を決定したか、なぜそう決めたか
検討した他の選択肢と却下理由
効いた制約条件、受け入れたトレードオフ

エラー解決策:

症状と根本原因
解決策と再発防止策

パターン発見:

どのコンテキストで、どの問題を、どう解決するパターンか
結果と影響

1-B. プロジェクト情報の体系的収集

プロジェクト構造をスキャンし、知識ベースを構築する。

プロジェクトスキャン:
```
scripts/scan_project.py <project_path>
```
カテゴリ: project-info, architecture, dependencies, api, config

Phase 2: 検証

Codex CLIによるクロスバリデーション

収集した知見を Codex CLI で検証する。

mcp__codex-cli__codex(
  prompt="Verify this claim against the file content:
    Claim: <claim_text>
    File: <file_path>
    Content: <file_content>
    Respond: MATCH | MISMATCH | PARTIAL
    Reason: <brief explanation>"
)

Codex結果	アクション
MATCH	検証済みとして記録
PARTIAL	修正後、再検証
MISMATCH	破棄

ハッシュベース検証

scripts/validate_claims.py <project_path> --claims <claims.json>

Phase 3: 構造化・配置

収集・検証済みの知見を適切な場所に永続化する。

構造化の原則

1記録 = 1関心事: 粒度を適切に保つ
検索可能性: タグ/キーワードを付与
文脈保持: なぜそうなったかの経緯を含める

出力先の選択

知見の種類	出力先	形式
タスク固有の学び	tasks/lessons.md	Markdown
検証済み原則・ADR	docs/	ADR
プロジェクト共通原則	ルートCLAUDE.md	Markdown
ドメイン固有ルール	フォルダCLAUDE.md	Markdown

ADR形式

# ADR-XXX: タイトル
## Status
Accepted | Deprecated | Superseded by ADR-YYY
## Context
決定が必要になった背景
## Decision
決定内容
## Consequences
結果と影響

Phase 4: 知識移転

セッション間・メンバー間での知識の連続性を確保する。

移転対象

明示的知識: ドキュメント化された設計判断、ADR、規約、API仕様
暗黙的知識: 経緯、試行錯誤、却下した選択肢と理由、既知の問題と回避策
コンテキスト知識: プロジェクト背景、技術的制約の由来、チームの慣習

引き継ぎドキュメント構造

# Knowledge Transfer: [プロジェクト/機能名]

## 1. 現状サマリー
### 完了したこと
- [成果]

### 進行中
- [タスク]: [進捗%] [次のアクション]

### 未着手
- [タスク]: [優先度] [依存関係]

## 2. 重要な決定事項
| 決定 | 理由 | 日付 | 参照 |
|------|------|------|------|

## 3. 既知の問題と注意点
- [課題]: [回避策]

## 4. キーファイル
| ファイル | 役割 | 備考 |
|---------|------|------|

## 5. 次のアクション
1. [ ] [最優先タスク]

移転タイミング

シーン	実施内容
セッション終了	セッションノート作成
担当者交代	フル引き継ぎドキュメント
新メンバー参加	オンボーディング資料
マイルストーン	進捗サマリー
プロジェクト完了	振り返りと学びの記録

実行フロー

Collect (Phase 1)
  → 知見の抽出
    → Verify (Phase 2)
      → Codex cross-check + hash validation
        → Structure (Phase 3)
          → tasks/lessons.md / ADR / CLAUDE.md へ配置
            → Transfer (Phase 4)
              → 引き継ぎドキュメント生成

フェーズは必要に応じて個別実行も可能。ユーザーの要求に応じて適切なフェーズから開始する。

References

引き継ぎドキュメント例 - Phase 4の具体的な出力例。初回の引き継ぎ作成時に参照

Scripts

scripts/scan_project.py - プロジェクト構造スキャン（Phase 1-B）
scripts/validate_claims.py - ハッシュベース検証（Phase 2）

品質原則

Epistemic Humility: 推測を事実として扱わない。unknownと言う勇気を持つ
Evidence First: 因果と証拠を中心にする
Source of Truth: 真実は常に現在のコード。要約はインデックス
Minimal Change: 最小単位で変更し、即時検証する

eld-record