diff --git a/AGENTS.md b/AGENTS.md
index 6a8e9dcc..aae44fa8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,6 +1,7 @@
 # AGENTS.md
 
 Instructions for AI coding agents (Claude Code, GitHub Copilot, Cursor, Codex) working on TermUI.
+This documentation provides configuration guidelines to ensure external assistance models align with our workspace layout rules.
 
 Read this file fully before writing code. Read the issue fully before writing code. If the issue links a reference file, read that file first and copy its structure.
 
diff --git a/README.md b/README.md
index e5bc5895..f384cb27 100644
--- a/README.md
+++ b/README.md
@@ -478,6 +478,8 @@ examples/
 
 ## Development
 > **Note:** This project uses [Bun](https://bun.sh) as its package manager. Install Bun first: https://bun.sh/docs/installation
+> **Note:** If you encounter execution policy or permission errors during setup, open your terminal as an Administrator (Windows) or use `sudo` before running commands (Mac/Linux).
+
 
 ```bash
 bun install