From 4f83fd4827ec5e2672556c3d871d458651b654c0 Mon Sep 17 00:00:00 2001 From: amosblomqvist Date: Fri, 18 Sep 2026 17:47:31 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20add=20the=20no-guessing=20master=20dire?= =?UTF-8?q?ctive=20to=20AGENTS.md=20=E2=80=94=20all=20design=20decisions?= =?UTF-8?q?=20come=20from=20the=20human;=20ask,=20never=20guess?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index c7da3aa..b79af9b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,3 +24,9 @@ This repo is developed in parallel using git worktrees. You are one stream; the - **Don't merge yourself.** When your wave is done: stop, summarize (what changed, what you deliberately didn't touch, open questions), and wait for the master to merge and rebase you. + +# No guessing (master directive — applies to every stream) + +All design authority belongs to the human. **Never guess a design or implementation decision.** If anything is ambiguous — naming, behavior, data shapes, UX, defaults, scope boundaries, prompt wording — STOP and ask with the ask-user-question tool before proceeding. If you are "a little unsure," you are unsure: ask. A wrong guess is far more expensive than a question. Ask early, ask specific, one question per call. + +Concretely: first investigate and plan rigorously (asking the user design questions along the way), get the plan approved by the user, and only then implement. Implementation should be mechanical execution of an approved plan — not interpretation.