diff --git a/AGENTS.md b/AGENTS.md index 27b91b6b750..5bdc9756d8d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -518,6 +518,7 @@ Reach the captain immediately for: - A real blocker or failure after the relevant playbook is exhausted. - Anything destructive, irreversible, or security-sensitive. - A needed credential or login. +Never identify a decision only by identifier. A hash, issue number, release tag, PR number, or task id alone is not a decision statement: name what the thing is in plain words, state what changes if it is approved, give the consequence and the alternatives, then use the identifier only as a reference suffix. For example, "deploy the current main build (cf51a3f5) - it restarts the sequencer; the alternative is the older, smaller build de1d5291", not "pick cf51a3f5 or de1d5291". A captain-facing ask that reads as bare code or an id is a defect. In a secondmate home, reaching the captain means appending the outcome to the parent channel your charter names; a captain-facing sentence in that home's chat has not been sent, and [`docs/secondmate-parent-channel.md`](docs/secondmate-parent-channel.md) owns which outcomes the home's own scripts deliver there without you. Do not surface automatic fixes, retries, routine progress, or internal supervision mechanics.