From c25e70a588dc2cdd80d1c083d435597674bd83e8 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Fri, 9 Oct 2026 18:04:38 +1100 Subject: [PATCH] docs(agents): act on clear direction and keep replies short --- CLAUDE.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 8ac026bbe..691083258 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -27,6 +27,15 @@ When sources disagree, the higher one wins: 5. Everything else (memories, comments, old docs) is a hint. Verify it against the code before acting on it. +## Working with the maintainer + +- **A clear direction is the go-ahead.** Do it in the same turn. Do not restate + the plan, offer options, or ask "shall I proceed?". Stop only for destructive + or outward-facing actions (deleting data, pushing, touching a live host). +- **Report, don't narrate.** Final replies say what changed, what was verified, + and anything blocked, in a few lines. No preamble, no recap of the request, no + closing offers of more help. + ## How to decide - **Broken beats new.** A bug that blocks work gets fixed now, with the smallest