From 8215bddea8549a0a80e2097b3674682076d05f64 Mon Sep 17 00:00:00 2001
From: debop <sunghyouk.bae@gmail.com>
Date: Fri, 14 Aug 2026 11:32:18 +0900
Subject: [PATCH] =?UTF-8?q?=EC=83=81=EC=9C=84=20AGENTS=20=EC=A7=80?=
 =?UTF-8?q?=EC=B9=A8=EC=9D=84=20=EB=AA=A8=EB=93=A0=20=EC=A0=80=EC=9E=A5?=
 =?UTF-8?q?=EC=86=8C=20=EC=9E=91=EC=97=85=EC=9D=98=20=EC=84=A0=ED=96=89=20?=
 =?UTF-8?q?=EC=A1=B0=EA=B1=B4=EC=9C=BC=EB=A1=9C=20=ED=86=B5=EC=9D=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

각 저장소와 중첩 모듈이 user-scope 및 workspace-scope AGENTS.md를 먼저 읽도록 명시해 지침 계층 누락을 방지한다.

Constraint: 저장소별 AGENTS.md는 독립된 GitHub 저장소에서 관리된다.\nRejected: workspace 문서만 수정 | repo-local overlay가 직접 계층을 명시해야 한다.\nConfidence: high\nScope-risk: broad\nDirective: 새 repo 또는 worktree AGENTS.md에도 동일한 선행 읽기 순서를 유지한다.\nTested: git diff --check, 대상 문구 전수 검색, workspace sync parity\nNot-tested: 문서-only 변경이므로 제품 코드 테스트는 실행하지 않았다.
---
 AGENTS.md                | 10 ++++++++++
 docs/workspace/AGENTS.md | 13 +++++++++++++
 2 files changed, 23 insertions(+)

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