diff --git "a/docs/02_ENV/ENV_01_\346\212\200\350\241\223\343\202\271\343\202\277\343\203\203\343\202\257.md" "b/docs/02_ENV/ENV_01_\346\212\200\350\241\223\343\202\271\343\202\277\343\203\203\343\202\257.md"
index b8fffdc..9381a5c 100644
--- "a/docs/02_ENV/ENV_01_\346\212\200\350\241\223\343\202\271\343\202\277\343\203\203\343\202\257.md"
+++ "b/docs/02_ENV/ENV_01_\346\212\200\350\241\223\343\202\271\343\202\277\343\203\203\343\202\257.md"
@@ -31,6 +31,7 @@
 | `path_provider` | アプリ内ファイルパスの取得 | 保存先ディレクトリの参照に使用 |
 | `permission_handler` | カメラ・ストレージの権限管理 | Android の実行時権限リクエスト |
 | `provider` | 状態管理 | Flutter 公式推奨．シンプルかつ拡張しやすい |
+| `screen_brightness` | 画面の輝度制御 | アタッチメント装着時の明るさ調整に使用 |
 
 ※ パッケージバージョンは環境構築時に最新 stable を採用し，`pubspec.yaml` で管理する．
 
diff --git "a/docs/02_ENV/ENV_02_\347\222\260\345\242\203\346\247\213\347\257\211\346\211\213\351\240\206.md" "b/docs/02_ENV/ENV_02_\347\222\260\345\242\203\346\247\213\347\257\211\346\211\213\351\240\206.md"
index edaa94c..29a8bdd 100644
--- "a/docs/02_ENV/ENV_02_\347\222\260\345\242\203\346\247\213\347\257\211\346\211\213\351\240\206.md"
+++ "b/docs/02_ENV/ENV_02_\347\222\260\345\242\203\346\247\213\347\257\211\346\211\213\351\240\206.md"
@@ -125,6 +125,24 @@
 
 接続した端末名が表示されれば OK．
 
+### 環境変数の設定 (Environment Variables)
+
+新しいターミナルを開くたびに以下の設定が必要になる場合がある．ビルドエラーが出た際に確認すること．
+
+**JAVA_HOME（Gradle ビルドに必要）:**
+
+```powershell
+$env:JAVA_HOME = "$env:USERPROFILE\scoop\apps\android-studio\current\jbr"
+```
+
+**ADB パス（実機デバッグに必要）:**
+
+```powershell
+$env:Path += ";$env:LOCALAPPDATA\Android\Sdk\platform-tools"
+```
+
+※ 上記は現在のターミナルのみ有効な一時設定．恒久化するにはシステムの環境変数に追加する．
+
 ### アプリの実行確認 (Run App)
 
 ```bash
@@ -154,3 +172,12 @@
 - USB ケーブルが「データ転送対応」であることを確認する（充電専用ケーブルでは認識されない）
 - スマートフォンの USB 接続モードが「ファイル転送（MTP）」になっていることを確認する
 - 端末のメーカー固有の USB ドライバが必要な場合がある（AQUOS の場合は SHARP 公式サイトからダウンロード）
+- `adb` コマンドが見つからない場合は，ADB パスの環境変数設定（上記「環境変数の設定」セクション）を確認する
+
+### Gradle ビルドで `JAVA_HOME is not set` エラーが出る場合
+
+JAVA_HOME の環境変数設定（上記「環境変数の設定」セクション）を確認する．Scoop 経由で Android Studio をインストールした場合，JDK は以下にある．
+
+```text
+%USERPROFILE%\scoop\apps\android-studio\current\jbr
+```
diff --git "a/docs/04_SPEC/SPEC_01_\347\224\273\351\235\242\346\251\237\350\203\275\344\273\225\346\247\230\346\233\270.md" "b/docs/04_SPEC/SPEC_01_\347\224\273\351\235\242\346\251\237\350\203\275\344\273\225\346\247\230\346\233\270.md"
index b68984e..073f2bc 100644
--- "a/docs/04_SPEC/SPEC_01_\347\224\273\351\235\242\346\251\237\350\203\275\344\273\225\346\247\230\346\233\270.md"
+++ "b/docs/04_SPEC/SPEC_01_\347\224\273\351\235\242\346\251\237\350\203\275\344\273\225\346\247\230\346\233\270.md"
@@ -54,6 +54,7 @@
 ```
 
 ※ 端末を逆さに置いて使用するため，UI 全体を 180° 回転する．操作者から見ると通常の上下配置に見える．
+※ アタッチメント（SmTIAS）により画面上部（逆さ配置時の操作側）の約 1/3 が隠れるため，UI 要素はその範囲を避けて配置する．
 
 ### UI 要素
 
@@ -61,6 +62,7 @@
 | --- | --- |
 | カメラプレビュー | インカメラ（前面カメラ）のライブ映像．UI 全体を 180° 回転して表示 |
 | シャッターボタン | 丸型ボタン．タップで撮影実行．連続タップ可（連写対応） |
+| 明るさスライダー | BottomNavigationBar の上に配置．画面の輝度を手動で調整する |
 | BottomNavigationBar | 撮影タブ（アクティブ）/ 一覧タブ |
 
 ### 動作仕様
@@ -300,6 +302,13 @@
 
 ## 非機能要件 (Non-functional Requirements)
 
+### 画面輝度
+
+- アプリ起動時に画面の輝度をデフォルト値（0.8）に設定する
+- ユーザーが明るさスライダーで任意に調整できる
+- アプリ終了時にシステムの輝度設定に復帰する
+- アタッチメント装着時に光センサーで画面が暗くなることへの対策
+
 ### パフォーマンス
 
 - 撮影から保存完了まで 2 秒以内を目標とする