| name | eld-record |
| context | fork |
| description | Context Delta の収集・検証・構造化・知識移転を一貫実行する。開発知識をtasks/lessons.mdやADRとして永続化する。「記録して」「知識を整理して」「引き継ぎ資料を作って」等で使用。 |
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
Scripts
scripts/scan_project.py - プロジェクト構造スキャン（Phase 1-B）scripts/validate_claims.py - ハッシュベース検証（Phase 2）
