diff --git a/AGENTS.md b/AGENTS.md
index 6353793..1eefe44 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,15 @@
 # AGENTS.md - bluetape4k .github
 
+## Guidance hierarchy
+
+Before applying this repository overlay, read and follow the guidance in this
+order:
+
+1. User scope: `${CODEX_HOME:-$HOME/.codex}/AGENTS.md`.
+2. Workspace scope: `/Users/debop/work/bluetape4k/.github/docs/workspace/AGENTS.md`.
+
+Apply both broader scopes before repository-specific rules.
+
 This repository inherits the workspace guidance from `../AGENTS.md`.
 Read and follow the workspace root guide first. This file only adds
 organization-profile, workflow-template, and workspace-guide rules.
diff --git a/docs/workspace/AGENTS.md b/docs/workspace/AGENTS.md
index 637250d..2fb4663 100644
--- a/docs/workspace/AGENTS.md
+++ b/docs/workspace/AGENTS.md
@@ -1,5 +1,18 @@
 # AGENTS.md - bluetape4k Workspace Root
 
+## Guidance hierarchy
+
+Before any task in this workspace, read and follow the applicable guidance in
+this order:
+
+1. User scope: `${CODEX_HOME:-$HOME/.codex}/AGENTS.md`.
+2. Workspace scope: this canonical file; the workspace-root `AGENTS.md` is its
+   synchronized copy.
+3. Repository/worktree scope: every applicable repository or nested worktree
+   `AGENTS.md` on the target path.
+
+Apply broader scopes before repository-specific rules.
+
 This directory is the local workspace for the bluetape4k GitHub organization.
 Each child directory is an independent Git repository. This file applies to all
 repositories below this directory; repo-local `AGENTS.md` files add narrower