diff --git a/.cursor/rules/common-hooks.md b/.cursor/rules/common-hooks.md
index 0f9586fd1..9c62df956 100644
--- a/.cursor/rules/common-hooks.md
+++ b/.cursor/rules/common-hooks.md
@@ -16,7 +16,7 @@ Use with caution:
 - Enable for trusted, well-defined plans
 - Disable for exploratory work
 - Never use dangerously-skip-permissions flag
-- Configure `allowedTools` in `~/.claude.json` instead
+- Configure `permissions.allow` rules in `~/.claude/settings.json` (or a project's `.claude/settings.json`) instead
 
 ## TodoWrite Best Practices
 
diff --git a/docs/es/rules/common/hooks.md b/docs/es/rules/common/hooks.md
index 7f9c9a1c0..93d93b97b 100644
--- a/docs/es/rules/common/hooks.md
+++ b/docs/es/rules/common/hooks.md
@@ -12,7 +12,7 @@ Usar con precaución:
 - Habilitar para planes bien definidos y de confianza
 - Deshabilitar para trabajo exploratorio
 - Nunca usar la flag dangerously-skip-permissions
-- Configurar `allowedTools` en `~/.claude.json` en su lugar
+- Configurar reglas `permissions.allow` en `~/.claude/settings.json` (o en el `.claude/settings.json` del proyecto) en su lugar
 
 ## Buenas Prácticas de TodoWrite
 
diff --git a/docs/ja-JP/rules/common/hooks.md b/docs/ja-JP/rules/common/hooks.md
index 07356b82f..af1f67341 100644
--- a/docs/ja-JP/rules/common/hooks.md
+++ b/docs/ja-JP/rules/common/hooks.md
@@ -12,7 +12,7 @@
 - 信頼できる、明確に定義された計画に対して有効化
 - 探索的な作業では無効化
 - dangerously-skip-permissions フラグを決して使用しない
-- 代わりに `~/.claude.json` で `allowedTools` を設定
+- 代わりに `~/.claude/settings.json`（またはプロジェクトの `.claude/settings.json`）で `permissions.allow` ルールを設定
 
 ## TodoWrite ベストプラクティス
 
diff --git a/docs/ko-KR/rules/hooks.md b/docs/ko-KR/rules/hooks.md
index 1f0c2daca..0647e3aa3 100644
--- a/docs/ko-KR/rules/hooks.md
+++ b/docs/ko-KR/rules/hooks.md
@@ -12,7 +12,7 @@
 - 신뢰할 수 있는, 잘 정의된 계획에서만 활성화
 - 탐색적 작업에서는 비활성화
 - dangerously-skip-permissions 플래그를 절대 사용하지 않기
-- 대신 `~/.claude.json`에서 `allowedTools`를 설정
+- 대신 `~/.claude/settings.json`(또는 프로젝트의 `.claude/settings.json`)에서 `permissions.allow` 규칙을 설정
 
 ## TodoWrite 모범 사례
 
diff --git a/docs/pt-BR/rules/hooks.md b/docs/pt-BR/rules/hooks.md
index 5f2b85e8a..5965eb490 100644
--- a/docs/pt-BR/rules/hooks.md
+++ b/docs/pt-BR/rules/hooks.md
@@ -12,7 +12,7 @@ Use com cautela:
 - Habilite para planos confiáveis e bem definidos
 - Desabilite para trabalho exploratório
 - Nunca use a flag dangerously-skip-permissions
-- Configure `allowedTools` em `~/.claude.json` em vez disso
+- Configure regras `permissions.allow` em `~/.claude/settings.json` (ou no `.claude/settings.json` do projeto) em vez disso
 
 ## Melhores Práticas para TodoWrite
 
diff --git a/docs/tr/rules/common/hooks.md b/docs/tr/rules/common/hooks.md
index f36ab2b2d..3b19377e6 100644
--- a/docs/tr/rules/common/hooks.md
+++ b/docs/tr/rules/common/hooks.md
@@ -12,7 +12,7 @@ Dikkatli kullan:
 - Güvenilir, iyi tanımlanmış planlar için etkinleştir
 - Keşifsel çalışmalar için devre dışı bırak
 - Asla dangerously-skip-permissions flag'i kullanma
-- Bunun yerine `~/.claude.json` içinde `allowedTools` yapılandır
+- Bunun yerine `~/.claude/settings.json` (veya projenin `.claude/settings.json` dosyası) içinde `permissions.allow` kurallarını yapılandır
 
 ## TodoWrite En İyi Uygulamalar
 
diff --git a/docs/zh-CN/rules/common/hooks.md b/docs/zh-CN/rules/common/hooks.md
index 91c142173..8fd600a8f 100644
--- a/docs/zh-CN/rules/common/hooks.md
+++ b/docs/zh-CN/rules/common/hooks.md
@@ -13,7 +13,7 @@
 * 为受信任、定义明确的计划启用
 * 为探索性工作禁用
 * 切勿使用 dangerously-skip-permissions 标志
-* 改为在 `~/.claude.json` 中配置 `allowedTools`
+* 改为在 `~/.claude/settings.json`（或项目的 `.claude/settings.json`）中配置 `permissions.allow` 规则
 
 ## TodoWrite 最佳实践
 
diff --git a/docs/zh-TW/rules/hooks.md b/docs/zh-TW/rules/hooks.md
index 1be8003a4..83f6d090d 100644
--- a/docs/zh-TW/rules/hooks.md
+++ b/docs/zh-TW/rules/hooks.md
@@ -28,7 +28,7 @@
 - 對受信任、定義明確的計畫啟用
 - 對探索性工作停用
 - 絕不使用 dangerously-skip-permissions flag
-- 改為在 `~/.claude.json` 中設定 `allowedTools`
+- 改為在 `~/.claude/settings.json`（或專案的 `.claude/settings.json`）中設定 `permissions.allow` 規則
 
 ## TodoWrite 最佳實務
 
diff --git a/rules/common/hooks.md b/rules/common/hooks.md
index 54394083e..4e0947ff0 100644
--- a/rules/common/hooks.md
+++ b/rules/common/hooks.md
@@ -12,7 +12,7 @@ Use with caution:
 - Enable for trusted, well-defined plans
 - Disable for exploratory work
 - Never use dangerously-skip-permissions flag
-- Configure `allowedTools` in `~/.claude.json` instead
+- Configure `permissions.allow` rules in `~/.claude/settings.json` (or a project's `.claude/settings.json`) instead
 
 ## TodoWrite Best Practices