Classify the claim before changing the prompt.
source pathThe expected file entered the current instruction chain.
within budgetThe retained user message reached this model request.
probabilisticThe proposed action happened to comply in this turn.
deterministicA non-model boundary rejects every forbidden action.
Give hard rules a real owner.
AGENTS.md“Do not push without approval.” Useful guidance, but the model may still propose or call the action.
Influences behaviorapproval + branch ruleThe tool and GitHub reject an unauthorized push or merge regardless of model output.
Enforces behaviorChoose by lifetime, not convenience.
$DSH_HOME/AGENTS.mdOne fixed file, no global local-overlay.
repo/AGENTS.mdVersioned policy from project root to cwd.
AGENTS.local.mdLoads after base candidates in that directory.
src/AGENTS.mdDiscovered after structured fs work reaches it.
SKILL.mdLoaded when the task matches or the user invokes it.
Baseline first. Nested context later.
Shell navigation is not discovery.
bash: cd srcNo persistent shell state and no reliable structured filesystem boundary.
Does not load nested instructionsread: src/index.tsA successful first-party fs result reaches the descendant scope.
Queues nested instructionsOne path currently has two meanings.
Applies to every Session.
Applies only while editing DSH configuration.
rc.2 provides no second official global path, so these policies cannot be separated in the same file. Treat it as global. Use direct task instructions, an explicit Skill, or a separate configuration repository for local guidance.
Budget preserves specificity.
Prove the active chain.
- 01Fresh Session shows expected source labels.
- 02Direct user correction remains authoritative.
- 03Nested read queues one additional scope.
- 04Edit replaces instead of accumulating copies.
- 05Removal creates a durable removal notice.
- 06Budget notice names omitted and truncated paths.
- 07No secret appears in rendered instructions.
- 08Hard safety rules have a deterministic policy owner.
Primary evidence.
- Why AGENTS.md can appear not to constrain the model #4731
- Official rc.2 agent-instructions lifecycle
- User-role framing and precedence text
- Root walk and bounded loading
Keep the complete scope runbook.
The canonical guide covers visibility proof, authority, scope, refresh, budgets, concrete rules, deterministic enforcement, adversarial testing, and acceptance.
Read the complete guide