diff --git a/README.md b/README.md
index 8227754..5b9deba 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,7 @@
 
 ## 개발
 
-- 파이썬 테스트는 스팀덱에서 실행합니다: `bash scripts/test.sh` (SSH `deck@192.168.1.50`)
+- 스크립트는 SSH 대상을 `DECK` 환경변수로 받습니다(예: `export DECK=deck@steamdeck.local`). 덱에 SSH 키 인증이 설정되어 있어야 합니다.
+- 파이썬 테스트는 스팀덱에서 실행합니다: `bash scripts/test.sh`
 - 빌드와 배포: `bash scripts/deploy.sh`. 덱의 `deck` 계정에 **sudo 비밀번호 없음 설정이 있어야** 동작합니다. 개발용 설정을 지운 뒤에는 쓸 수 없고, 다시 배포하려면 그 설정을 잠시 되살려야 합니다.
 - 설계: `docs/superpowers/specs/2026-10-24-mudfish-decky-design.md`
diff --git a/docs/superpowers/specs/2026-10-24-mudfish-decky-design.md b/docs/superpowers/specs/2026-10-24-mudfish-decky-design.md
index 3ebc477..7ab1b9c 100644
--- a/docs/superpowers/specs/2026-10-24-mudfish-decky-design.md
+++ b/docs/superpowers/specs/2026-10-24-mudfish-decky-design.md
@@ -41,7 +41,7 @@
 
 ## 3. 환경 (2026-10-24 SSH로 확인)
 
-- 스팀덱: SteamOS (holo), 커널 7.2.7, Python 3.14.6. SSH 주소 `deck@192.168.1.50`이고 키 인증이 등록되어 있다.
+- 스팀덱: SteamOS (holo), 커널 7.2.7, Python 3.14.6. SSH(`deck@<스팀덱 IP>`)는 키 인증으로 접속한다.
 - 데키로더 **v3.3.0**과 플러그인 13개가 설치되어 있다. 참고할 만한 기존 플러그인으로 `tailscale-control`(VPN 스위치)이 있다.
 - 지포스나우: Flatpak `com.nvidia.geforcenow` (user).
 - 미꾸라지 **6.6.0**이 `/opt/mudfish/6.6.0/`에 설치되어 있다. `/opt`는 `/home` 쪽 파티션(`/.steamos/offload/opt`)이라 SteamOS 업데이트 후에도 남는다.
diff --git a/scripts/deploy.sh b/scripts/deploy.sh
index de7ecf4..f183b39 100644
--- a/scripts/deploy.sh
+++ b/scripts/deploy.sh
@@ -3,7 +3,7 @@
 # Needs passwordless sudo for the deck user (development only).
 set -euo pipefail
 cd "$(dirname "$0")/.."
-DECK="${DECK:-deck@192.168.1.50}"
+DECK="${DECK:?set DECK to the Steam Deck SSH target, e.g. DECK=deck@steamdeck.local}"
 pnpm build
 tar --exclude='__pycache__' -cf - dist main.py plugin.json package.json py_modules | ssh "$DECK" '
   D=/home/deck/homebrew/plugins/mudfish-decky
diff --git a/scripts/test.sh b/scripts/test.sh
index 514355e..99f7167 100644
--- a/scripts/test.sh
+++ b/scripts/test.sh
@@ -2,7 +2,7 @@
 # Run the Python unit tests on the Steam Deck (its python3 matches the target runtime closely).
 set -euo pipefail
 cd "$(dirname "$0")/.."
-DECK="${DECK:-deck@192.168.1.50}"
+DECK="${DECK:?set DECK to the Steam Deck SSH target, e.g. DECK=deck@steamdeck.local}"
 tar -cf - py_modules tests | ssh "$DECK" '
   rm -rf /tmp/mfd-test && mkdir /tmp/mfd-test && tar -xf - -C /tmp/mfd-test &&
   cd /tmp/mfd-test && PYTHONPATH=py_modules python3 -m unittest discover -s tests -t . -v'