用語統一とドキュメント改善: イマナンスとトランセンデンスの概念強化

manuals/1.0/en/02-input-classes.md

@@ -71,6 +71,8 @@ Input Classes contain only **Immanent Nature** elements. These are the object's
 
 **Transcendent Forces** (powers that the object cannot achieve by itself) are not included here. They appear in Being Classes, which we'll learn about next.
 
+For example, a `UserInput` class holds only raw data like email address and name. The power to validate whether the email is valid, the power to save to a database, the power to send notifications—these are all transcendent forces and do not exist in Input Classes. Input Classes simply declare "this is the data I am."
+
 Input Classes represent the starting point of transformation—the object's initial form.
 
 ---

manuals/1.0/en/03-being-classes.md

@@ -15,7 +15,11 @@ permalink: /manuals/1.0/en/03-being-classes.html
 
 Being Classes are where transformation actually occurs.
 
-The object's own nature (**Immanent Nature**) meets forces provided from the outside (**Transcendent Forces**), and a new being is born. If Input Classes are the "beginning," Being Classes express the "moment of change."
+The object's own nature (**Immanent Nature**) meets forces provided from the outside (**Transcendent Forces**), and a new being is born.
+
+For example, a `UserInput` with email and name (immanence) meets an email validation service and formatter (transcendence), creating a "validated user profile" as a new being. The original data remains immutable; by meeting validation—a transcendent force the object doesn't possess—a new being emerges.
+
+If Input Classes are the "beginning," Being Classes express the "moment of change."
 
 ## Basic Structure
 
@@ -43,10 +47,16 @@ Every Being Class follows the same flow of transformation:
 
 **Immanent Nature** (`#[Input]`) + **Transcendent Forces** (`#[Inject]`) → **New Immanent Nature**
 
+It's like cooking. Ingredients (immanent nature) combined with fire and seasoning (transcendent forces) create a dish (new immanent nature). Flour alone isn't bread; with yeast and an oven's power, it becomes bread. The ingredients persist, yet their form becomes something new.
+
 - **Immanent factors**: What the object inherits from its previous form
 - **Transcendent factors**: External capabilities and context provided by the world
 - **New Immanent**: The transformed being that emerges from this interaction
 
+This pattern appears everywhere in nature. A seed (immanent) meets soil, water, and sunlight (transcendent) to become a flower. A student (immanent) meets teachers and materials (transcendent) to become an expert. All growth, all learning, all change follows this pattern. The Be Framework expresses this universal law of transformation in code.
+
+The programming world is the same. `$cartItems` (immanent) meets tax calculation services (transcendent) to become billing amounts. `$zipCode` (immanent) meets address lookup APIs (transcendent) to become complete addresses. `$rawImage` (immanent) meets image processing engines (transcendent) to become thumbnails. Data cannot change by itself. Only by borrowing external forces can it become something new.
+
 ## Entelecheia - Becoming Who You're Meant to Be
 
 The constructor is where a new self is born. To become the intended self, **Immanent Nature** meets **Transcendent Forces** that the self doesn't possess, and transformation logic unfolds.
@@ -75,7 +85,11 @@ final readonly class OrderCalculation
 2. They interact, and the transformation logic unfolds.
 3. Through property assignment, a new being is born.
 
-Entelecheia is a philosophical concept proposed by Aristotle, representing the process by which potentiality transitions to actuality. It's the moment when an object's possibilities are realized through interaction with external forces. In the Be Framework, this transformation process in the constructor is considered the realization of entelecheia.
+Entelecheia (ἐντελέχεια) is a philosophical concept proposed by Aristotle, meaning "having purpose within." An acorn is born to become an oak tree, an egg exists to become a bird. Each harbors its "intended self" within. The egg as potentiality becomes the bird as actuality. In other words, the egg exists for the entelecheia of becoming a bird.
+
+The Be Framework is the same. This constructor transformation process is precisely the realization of entelecheia. `OrderCalculation` wants to become a calculated order. `ValidatedUser` wants to become a verified user. Each class becomes its "intended self" through the constructor. The Be Framework focuses not on actions (DOING) but on being (BEING). Actions are not the purpose—they are the means to become the intended being.
+
+Life is the same. Reading books is to become "a person with deep insight," practicing instruments is to become "a person who moves hearts through music." Actions are means; being is the purpose. Focusing not on "what to do" but "what to become"—the Be Framework expresses this way of thinking in code.
 
 ## Bridging to Final Objects
 
@@ -108,7 +122,7 @@ final readonly class OrderValidation
 
 ## Natural Flow
 
-Being Classes don't "do" things—they naturally become what they're meant to be through the interaction of their **Immanent Nature** with **Transcendent Forces** provided by the world. This is the principle of wu wei (無為) from Taoist philosophy. They don't change other things; they transform themselves.
+Being Classes don't "do" things. What they possess (immanence) meets forces given from outside (transcendence), naturally transforming into what they should be. This is the same as Laozi's teaching at the beginning: "The Tao does nothing, yet nothing is left undone"—without forcing, everything is accomplished in the natural flow. They don't change other things; they transform themselves.
 
 ---
 

manuals/1.0/ja/02-input-classes.md

@@ -69,6 +69,8 @@ final readonly class PaymentInput
 
 入力クラスでは、すべてが**イマナンス**です。ここには**トランセンデンス（Transcendence／超越的な力）**はありません。トランセンデンスは外部から提供される、自分だけでは実現不可能な力であり、それらは後で**存在クラス（Being クラス）**において現れます。
 
+例えば、`UserInput`クラスはメールアドレスと名前という素のデータだけを持ちます。このメールアドレスが有効かどうかを検証する力、データベースに保存する力、通知を送る力——これらはすべてトランセンデンスであり、入力クラスには存在しません。入力クラスはただ「私はこういうデータです」と宣言するだけです。
+
 入力クラスは変容の出発点です。自己を超えたものと出会って、新しい何かへと変わっていく最初の姿を表します。
 
 ---

manuals/1.0/ja/03-being-classes.md

@@ -15,7 +15,11 @@ permalink: /manuals/1.0/ja/03-being-classes.html
 
 存在クラスは変容が実際に起こる場所です。
 
-オブジェクト自身が持つ性質（**内在的性質（イマナンス）**）と、外部から提供される力（**超越的な力（トランセンデンス）**）が出会い、次の新しい存在が生まれます。入力クラスが「始まり」なら、存在クラスは「変わる瞬間」を表現します。
+オブジェクト自身が持つ性質（**内在的性質（イマナンス）**）と、外部から提供される力（**超越的な力（トランセンデンス）**）が出会い、次の新しい存在が生まれます。
+
+例えば、`UserInput`が持つメールアドレスと名前（イマナンス）が、メール検証サービスやフォーマッター（トランセンデンス）と出会うことで、「検証済みのユーザープロフィール」という新しい存在が生まれます。元のデータは不変のまま、検証という自分にはない超越的な力との出会いを通じて、新しい存在が立ち上がります。
+
+入力クラスが「始まり」なら、存在クラスは「変わる瞬間」を表現します。
 
 ## 基本構造
 
@@ -43,10 +47,16 @@ final readonly class UserProfile
 
 **内在的性質** (`#[Input]`) + **超越的力** (`#[Inject]`) → **新しい内在的性質**
 
+まるで料理のようです。素材（内在的性質）に、火や調味料（超越的力）を加えることで、料理（新しい内在的性質）が生まれます。小麦粉はそれだけではパンになりませんが、イーストとオーブンの力を借りてパンになります。素材は同じでも、まったく新しい存在になるのです。
+
 - **内在的要因**: オブジェクトが前の形態から継承するもの
 - **超越的要因**: 世界によって提供される外部の能力と文脈
 - **新しい内在的**: この相互作用から生まれる変容した存在
 
+このパターンは自然界のあらゆるところに見られます。種（内在）が土と水と太陽（超越）と出会って花になる。生徒（内在）が教師と教材（超越）と出会って専門家になる。すべての成長、すべての学び、すべての変化がこのパターンに従います。Be Frameworkは、この普遍的な変容の法則をコードで表現しているのです。
+
+プログラムの世界でも同じです。`$cartItems`（内在）が税率計算サービス（超越）と出会って請求金額になる。`$zipCode`（内在）が住所検索API（超越）と出会って完全な住所になる。`$rawImage`（内在）が画像処理エンジン（超越）と出会ってサムネイルになる。データは自分だけでは変われません。外部の力を借りて、初めて新しい存在になれるのです。
+
 ## エンテレケイア - なりたい自分になる
 
 コンストラクタは新しい自己が生まれる特別な場所です。なるべき自己になるために、内在的性質と、自らは持たないが世界から与えられる超越的な力が出会い、変容のロジックが働きます。
@@ -75,11 +85,15 @@ final readonly class OrderCalculation
 2. 相互に作用して変容のロジックが働く。
 3. プロパティの代入によって新しい存在が誕生する。
 
-エンテレケイア（entelecheia）とは、アリストテレスが提唱した哲学概念で、潜在性が現実性へと移行する過程を表します。オブジェクトが持つ可能性が、外部の力との相互作用によって実現される瞬間です。Be Frameworkでは、このコンストラクタでの変容過程がまさにエンテレケイアの実現と考えています。
+エンテレケイア（entelecheia）とは、アリストテレスが提唱した哲学概念で、「内に目的を持つ」という意味です。どんぐりは樫の木になるべく生まれ、卵は鳥になるべく存在します。それぞれが「なりたい自分」を内に秘めているのです。
+
+Be Frameworkでは、このコンストラクタでの変容過程がまさにエンテレケイアの実現です。`OrderCalculation`は計算された注文になりたい。`ValidatedUser`は検証済みユーザーになりたい。各クラスがコンストラクタで「なりたい自分」になるのです。Be Frameworkでは、動作(DOING)ではなく、存在(BEING)を中心に考えます。
+
+人生でも同じです。本を読むのは「深い洞察を持つ人」になるため、楽器を練習するのは「音楽で人の心を動かす人」になるためです。動作は手段であり、存在こそが目的なのです。「何をするか」ではなく「何になりたいか」に焦点を合わせる—この考え方を、Be Frameworkはコードで表現しているのです。
 
 ## 最終オブジェクトへの橋渡し
 
-存在クラスはしばしば橋として機能し、最終変容のためのデータを準備します：
+存在クラスはしばしば架け橋として機能し、最終変容のためのデータを準備します：
 
 ```php
 #[Be([SuccessfulOrder::class, FailedOrder::class])]  // 複数の運命
@@ -108,7 +122,7 @@ final readonly class OrderValidation
 
 ## 自然な流れ
 
-存在クラスは何かを「する」のではありません。自身の内在的性質と、世界から与えられる（自らは持たない）超越的力との相互作用を通して、自然にあるべき姿へと変容します。これは道教でいう無為自然の原理です。他の何かを変えるのではなく、自分自身が変わっていきます。
+存在クラスは何かを「する」のではありません。自分が持つもの（イマナンス）と、外部から与えられる力（トランセンデンス）が出会うことで、自然にあるべき姿へと変容します。これは冒頭の老子の「道常無為而無不為」—無理に力を加えることなく、自然な流れの中ですべてが成し遂げられる—という教えと同じです。他の何かを変えるのではなく、自分自身が変わっていきます。
 
 ---