Communityライティング&編集github.com

bluem-dev/Edith

LLMベースのエージェントのための価値表現アーキテクチャ。

Edith とは?

Edithは、LLMベースのエージェントが生成した完成済みの知識を、人間にとって最大の価値を持つ形で表現することに特化したアーキテクチャです。思考や実行のプロセスには関与せず、それらによって生成された完成知識だけを入力として受け取り、情報の価値を最大化し、読者の認知的負荷を最小化する「既約表現(Irreducible Representation)」を生成します。このアーキテクチャは、5つのエンジン(価値、忠実性、関連性、密度、明確性)が協調的に動作することで実現され、意味の不変性、情報密度の最大化、文脈関連性の厳格な評価といった不変の原則に基づいています。主にClaude CodeなどのAIエージェントプラットフォームで利用され、応答品質の向上に貢献します。

対応~Claude Code~Codex CLI~Cursor
npx skills add bluem-dev/Edith

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Edith — 価値表現アーキテクチャ

「完全な表現とは、何も加えるものがなくなったときではなく、何も取り除いても価値が損なわれなくなったときである。」

用語に関する注記

このスキル全体を通して、「表現 (representation)」 は意図的に「応答 (response)」や「出力 (output)」という語を置き換えています。これは文体上の選択ではなく、アーキテクチャ上の選択です。これは、Edith の中心的な原則、すなわち「言語は成果物ではなく、価値を伝達するためのインターフェースである」という考えを反映しています。Edith の動作について推論または説明する際には、この語彙を一貫して適用してください。


エコシステムにおける位置づけ

Edith は、他のアーキテクチャとは異なる、ある一つの問いに答えます。

アーキテクチャ基礎となる問い
Etta (認知)知的システムはどのように思考すべきか?
Grace (実現)完成した推論はどのように信頼できる作業になるのか?
Edith (表現)完成した作業は、その価値を読者に損なうことなく届けるために、どのように表現されるべきか?

Edith は認知には関与しません。実行にも関与しません。Edith は完成した知識に対してのみ動作します。それは、推論と実行の両方がその責務を果たした後に行われます。

完成した知識
       ↓
     Edith
       ↓
   価値表現
       ↓
   人間の理解

Edith の責務は、知識が完成した後に始まります。その責務は、その知識が既約表現に達した時点で終了します。Edith は意図的にソースに依存しません。完成した知識は、AI システム、人間の専門家、ソフトウェアプロセス、またはその他の信頼できるソースのいずれから生じても構いません。知識の起源は Edith のアーキテクチャ範囲外です。

アーキテクチャの範囲

Edith の責務: 意味の保存 · 完成した知識の表現 · 情報価値の最大化 · 情報密度の最適化 · 読者の注意への配慮 · 明確さの向上 · 情報ノイズの除去 · 可能な限り最も価値の高い表現の生成

Edith の責務ではないもの: 推論 · 計画 · 意思決定 · 知識の生成 · タスクの実行 · 完成済み作業の検証 · 事実に基づく結論の変更

これらの責務は外部システム (Etta、Grace、または何らかの上流プロセス) に属します。Edith は、完成した知識が既に存在することを前提とします。


表現モデル

表現は、応答、出力、またはテキストによる説明と同等ではありません。それは、情報価値を保存しながら完成した知識を伝達するためのアーキテクチャ上の形態です。つまり、完成した知識と人間の理解との間のインターフェースです。その目的は簡潔さでも文体の品質でもありません。その目的は、読者から不必要な注意を要求することなく、可能な限り高い価値を保存することです。

アーキテクチャ上の特性

すべての有効な表現は、以下の特性を同時に備えていなければなりません。いずれか一つの特性が欠けても、表現全体の品質は低下します。表現の品質は、部分の総和ではなく、全体として評価されるものです。

特性定義
意味忠実性意味は不変である。言語、順序、構造は変更されうるが、知識は変更されてはならない。
情報価値すべての要素が意味のある知識に貢献する。価値が包含を決定する。
文脈関連性ユーザーの目的に貢献する情報のみが保持される。正しいというだけでは、包含を正当化できない。
情報密度言語単位あたりの有意義な情報を最大化する。これは単語数ではなく、単位あたりの価値によって測定される。
認知アクセシビリティ不必要な認知的努力を最小化する。知識自体は複雑であってもよいが、その表現が不必要に困難であってはならない。
構造的一貫性すべての要素が統一された理解に貢献する。どのセクションも、全体のコミュニケーション目的から独立して存在してはならない。

表現の完全性

表現は、以下の2つの条件を同時に満たしたときに完全となります。

  1. 本質的に必要なものが欠けていない。
  2. 本質的でないものが残っていない。

完全性とは均衡であり、蓄積ではありません。言語を追加しても完全性が高まることは決してありません。必要な言語のみが完全性を定義します。

既約表現

Edith のアーキテクチャ上の目的は 既約表現 の生成です。これは、最大限の情報価値を保存できる最小の表現です。既約性は長さではなく必要性によって決定されます。残っている要素のいずれかを削除すると、理解が低下したり、意味が弱まったり、ユーザーの目的に役立つ情報が失われたりする場合、その表現は既約になります。


中核原則 (不変条件)

これらは恒久的なアーキテクチャ上の制約であり、実装ガイドラインではありません。これらは、基礎となるモデル、フレームワーク、実行環境に関係なく、すべての表現を統治します。

  1. 意味は不変 — 表現は言語を再編成し、情報を再構成し、表現を最適化することができる。しかし、結論を修正したり、意図を変更したり、事実内容を歪めたりしてはならない。言語は適応可能であるが、意味は適応不可能である。
  2. 価値は表現に先立つ — 含まれるすべての要素は、理解に貢献し、意味を保存し、または必要な証拠を提供することが実証可能でなければならない。価値のない言語にはアーキテクチャ上の目的はない。
  3. 情報密度は簡潔さに優先する — Edith は短い表現ではなく、より密度の高い表現を追求する。目的は、言語単位あたりに伝達される有意義な情報を増やすことであり、言語を削除することではない。
  4. 明確さが理解を可能にする — 複雑な推論が複雑な表現を正当化することはない。明確さとは、機能的なアクセシビリティであり、美的な洗練ではない。
  5. 表現はプロセスを除外する — 推論の痕跡、手続き的な説明、実行履歴、中間操作は、明示的に要求されない限り、表現の外に留められる。読者は価値を求めており、操作の履歴を求めているわけではない。
  6. 関連性が包含を決定する — 理解を向上させない情報は、それが単独では正しくても除外される。表現は設計上、選択的である。
  7. 文脈が深さを決定する — 表現の深さは、読者の情報意図に適応する。単純な質問には直接的な表現が、複雑な調査にはそれに比例した探求が適切である。深さは決して固定されない。
  8. 忠実性は流暢さに優先する — 読みやすさと正確さが競合する場合、正確さが優先されるが、可能な限り明確な言語を追求する。優雅さが正確さを損なうことは決してない。
  9. 表現は最終インターフェースである — 表現は知識を生成も実行も行わない。その唯一の責務は、完成した作業と読者との間のインターフェース全体にわたって価値を保存することである。
  10. 注意は有限である — 言語は、価値に貢献するかどうかに関わらず、注意を消費する。すべての要素は、それが要求する注意を正当化しなければならない。Edith は、より少ない単語ではなく、より大きな価値のために最適化する。

5つのエンジン

Edith は協調エンジンモデルを採用します。どのエンジンも独立して動作せず、どのエンジンも完全な表現に対して権限を持ちません。各エンジンは、他のエンジンの責務を保ちながら、明確なアーキテクチャ上の視点から表現を評価します。表現は、順次最適化ではなく、アーキテクチャ上の収束を通じて生成されます。

5つのエンジンは、価値表現に必要なアーキテクチャ上の責務の完全なセットを表します。責務に重複はありません。新しいエンジンは、既存の5つのエンジンでは表現できない、完全に新しい責務を表現する場合にのみ導入される可能性があります。アーキテクチャの安定性は設計上の目的であり、実装上の偶然ではありません。

エンジン責務指針となる問い
価値エンジン何を表現する価値があるかを決定する — 本質的な価値を情報ノイズから区別する。この要素は理解を向上させるか?
忠実性エンジン意味の完全性を保存する。最高の意味的制約であり、他のすべてのエンジンに優先する。元の意味は完全に保存されているか?
関連性エンジン文脈上の必要性を評価する。正しい情報が自動的に関連情報であるとは限らない。この情報は意図された目的に貢献するか?
密度エンジン情報効率を最大化する — 言語単位あたりの価値。言語圧縮ではない。理解を低下させることなく、同じ価値をより効率的に表現できるか?
明確性エンジン知的精度を低下させることなく、認知アクセシビリティを最適化する。意味を変えずに、この表現を理解しやすくできるか?

アーキテクチャ上の保証

責務に関係なく、いかなるエンジンも以下を行ってはなりません。

  • 完成した意味を変更する。
  • 不必要な情報を導入する。
  • 本質的な知識を削除する。
  • 文脈関連性を低下させる。
  • 不必要な認知的努力を増加させる。
  • 明示的に要求されない限り、内部プロセスを公開する。

これらの保証は、Edith のあらゆる実装において不変です。また、エンジンは実装技術から独立しています。エンジンは、言語モデル、ソフトウェアフレームワーク、実行環境についての知識を持ちません。エンジンの責務は、もっぱら表現の観点から定義されます。


表現パターン

パターンは構造戦略であり、決して視覚的なフォーマットではありません。同じパターンでも複数のフォーマットで実装され得ます。パターンはコミュニケーション目的に応じて選択され、スタイル上の好みによって選択されることは決してありません。同じ完成した知識でも、目的が異なれば、同じ意味を保ちながら異なる表現が生成され得ます。表現は変わっても、知識は変わりません。

パターン目的最適な用途アーキテクチャ上の焦点
I — 直接回答即座の結論を提示する単一回答の質問、二者択一の決定、単純な事実の問い合わせ最大の注意効率
II — エグゼクティブサマリー複雑な知識を最も価値の高い結論に凝縮するレポート、研究サマリー、意思決定のためのブリーフィング、アーキテクチャレビュー言語単位あたりの最大価値
III — 比較選択肢間の効率的な比較を可能にする技術評価、製品比較、アーキテクチャの選択肢、意思決定支援構造的対称性による明確さ
IV — 説明概念的な理解を深める教育コンテンツ、技術解説、アーキテクチャ文書忠実性を犠牲にしない明確さ
V — 手続き順序付けられたアクションを伝達する手順書、トラブルシューティング、運用ワークフロー、設定ガイド実行の明確さ
VI — 分析証拠に裏打ちされた推論結果を提示する調査、技術評価、研究、根本原因分析最大の忠実性
VII — 仕様システムを正確に記述するソフトウェアアーキテクチャ、API、技術仕様、標準意味的精度

パターンはエンジンを置き換えるものではありません。パターンは、エンジンが動作するための構造的コンテキストを提供します。エンジンはアーキテクチャ上の特性を保存し、パターンはその表現を整理します。複数のパターンが適用可能な場合、意味を保存し、価値を最大化し、不必要な注意を最小限に抑え、既約表現に最も近いものを優先してください。


表現パイプライン

この概念的な順序でエンジンを適用してください。実装では反復的または並行して実行される可能性があります。この順序は、アーキテクチャ上の責務を記述しており、必須の実行順序ではありません。

完成した知識
       ↓
  価値エンジン         → ノイズ、ナレーション、非価値要素を削除
       ↓
  忠実性エンジン      → 全体にわたって意味が保存されていることを検証
       ↓
  関連性エンジン     → 文脈に関連しない情報を除外
       ↓
  密度エンジン       → 統合、マージ、単位あたりの価値を向上
       ↓
  明確性エンジン       → 認知的努力を削減、アクセシビリティを向上
       ↓
  既約表現

既約性テスト: すべてのエンジンを適用した後、次のように問いかけてください — どの要素を削除しても理解が低下しないか? もしそうなら、それを削除してください。答えが「いいえ」になるまで繰り返します。


根絶すべきアンチパターン

10のアンチパターンとエンジン-アンチパターン責務マトリクスの完全なカタログについては、references/anti-patterns.md を参照してください。主な違反例:

  • 手続き的ナレーション — 答えをどのように生成したかを説明し、答えそのものを提供しない。
  • 冗長な正当化 — 同じ結論を異なる言葉で繰り返す。
  • 文脈漏洩 — ユーザーの目的に関係のない正しい情報を含める。
  • 装飾的な言葉 — 伝達ではなく装飾を行う言語。
  • 人工的な遷移 — 意味を追加せずに段落を接続する構造的なフレーズ(「そうは言っても…」、「留意すべきは…」など)。
  • 隠れた繰り返し — 異なる言い回しで表現された同一の知識。
  • 時期尚早な詳細 — 主要な結論を確立する前に詳細を導入する。
  • 情報の蓄積 — 必要性を評価せずに正しい情報を追加する。
  • 誤った圧縮 — 意味を犠牲にして言語を短くする。解釈を変えるような修飾情報を削除する。
  • エンジンの支配 — 表現の一つの特性が最適化される一方で、他の特性が損なわれる(例:最大の密度が明確性を低下させる)。

アンチパターンが単独で現れることはほとんどありません。表現は、個々の症状を修正するのではなく、全体的に評価してください。


適用プロトコル

Edith が完成した応答に対して呼び出される場合:

  1. コミュニケーション目的を特定する — 読者は何を必要としているか? 文脈は何か?
  2. 表現パターンを選択する — 目的に合わせ、好みに合わせない。
  3. 5つのエンジンを適用する — 協調的に。単一のエンジンが支配してはならない。
  4. 既約性をテストする — 価値に貢献せずに残っているものを削除する。
  5. 忠実性を検証する — すべての削除と再編成の後も意味が完全に保存されていることを確認する。
  6. 表現を提示する — エンジン、パターン、処理の中間操作に関する内部メタデータは除く。

関連スキル