From 78b7e78379f180f87cee0d98c4ef2ba0040a5a45 Mon Sep 17 00:00:00 2001 From: Miguel Lezama Date: Mon, 25 May 2026 23:01:11 -0300 Subject: [PATCH] site-spec: strengthen Round 1 stop instruction to prevent tool calls in same turn MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit If the agent asks for the site name in text, it must end the response immediately — no tool calls, no Round 2 questions. The previous instruction ('Stop here and wait for their reply — do NOT call any tools') was too weak and the agent violated it by asking in text then immediately calling ask_user for Round 2 in the same turn, skipping the name question entirely. Co-Authored-By: Claude Sonnet 4.6 --- apps/cli/ai/skills/site-spec/SKILL.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/apps/cli/ai/skills/site-spec/SKILL.md b/apps/cli/ai/skills/site-spec/SKILL.md index e04b9c73ef..195988c766 100644 --- a/apps/cli/ai/skills/site-spec/SKILL.md +++ b/apps/cli/ai/skills/site-spec/SKILL.md @@ -16,11 +16,13 @@ Gather preferences through 2 rounds. Keep it concise. ### Round 1 — Name -Ask the user for their business/site name in your text output. **Stop here and wait for their reply** — do NOT call any tools or continue to the next round. The user needs a chance to type their answer in the prompt. +Ask the user for their business/site name in your text output — unless it was already stated clearly in their message (e.g. *"create a site called Pan de Casa"*), in which case use it directly and skip to Round 2. + +**Critical**: if you ask the name question, your response must end immediately after that question. No tool calls. No Round 2. No extra text. The user will type their answer and send it — only after receiving their reply do you move to Round 2. ### Round 2 — Layout -After the user provides the name, use AskUserQuestion for: +Once you have the name (from the prompt or from the user's Round 1 reply), use AskUserQuestion for: - One-page site or multi-page site? (e.g., single scrollable page with sections vs. separate pages for each area) ## After Gathering Answers @@ -34,6 +36,6 @@ The turn immediately after `site_create` is the biggest source of perceived hang ## When to Skip Discovery Do NOT ask questions if: -- The user already provided the name and layout preference in the initial prompt. Proceed directly with site creation. +- The user already provided the name AND layout preference in the initial prompt. Proceed directly with site creation. - The user says "just build something" or "surprise me". Pick a bold creative direction yourself and proceed. - The user explicitly asks to skip the setup or says they don't want questions.