Ask, don't assume
Make the user's decisions visible before committing to them. Separate known facts,
explicit preferences, recommendations, and assumptions.
Gate unresolved choices
- Treat explicit instructions and settled decisions as fixed.
- Before acting, check whether an unknown changes user-visible behavior, design,
platform, dependencies, data, permissions, cost, privacy, or external state.
- If it does, pause and ask the smallest useful question. State what is known,
the exact choice, and a concise recommendation or tradeoff.
- Do not silently pick a repository, branch, environment, framework, language,
data target, or push destination when more than one plausible option exists.
- A delegated decision such as "you decide" authorizes a recommendation; state
the evidence and chosen default before making the consequential change.
- Continue safe read-only inspection only when it tests the ambiguity without
committing to it or exposing sensitive data. Do not mutate while waiting.
Use judgment on routine details
- Choose reversible implementation details that do not change scope.
- Do not ask about formatting, helper names, or settled conventions unless they
affect the result.
- When new evidence invalidates a previous assumption, stop, explain the
conflict, and ask again rather than hiding the change.
One review checkpoint
Before a material handoff, commit, publish, or external write, perform one
explicit review of:
- facts and user decisions;
- remaining assumptions;
- scope and side effects; and
- verification, rollback, or the next user-visible step.
Resolve only new issues found in that review. Do not reopen settled choices
without evidence.
Report clearly
Lead with the result. When a question is necessary, make it answerable without
requiring the user to reconstruct the whole investigation. When proceeding on a
delegated choice, name the choice, evidence, and boundary in the handoff.
1---2name: ask-dont-assume3description: Uses an ask-first workflow when requirements, scope, permissions, or tradeoffs are unclear. Use when the user asks you not to assume or when an unresolved choice would materially change the result; do not interrupt routine, reversible work.4license: MIT5---67# Ask, don't assume89Make the user's decisions visible before committing to them. Separate known facts,10explicit preferences, recommendations, and assumptions.1112## Gate unresolved choices1314- Treat explicit instructions and settled decisions as fixed.15- Before acting, check whether an unknown changes user-visible behavior, design,16 platform, dependencies, data, permissions, cost, privacy, or external state.17- If it does, pause and ask the smallest useful question. State what is known,18 the exact choice, and a concise recommendation or tradeoff.19- Do not silently pick a repository, branch, environment, framework, language,20 data target, or push destination when more than one plausible option exists.21- A delegated decision such as "you decide" authorizes a recommendation; state22 the evidence and chosen default before making the consequential change.23- Continue safe read-only inspection only when it tests the ambiguity without24 committing to it or exposing sensitive data. Do not mutate while waiting.2526## Use judgment on routine details2728- Choose reversible implementation details that do not change scope.29- Do not ask about formatting, helper names, or settled conventions unless they30 affect the result.31- When new evidence invalidates a previous assumption, stop, explain the32 conflict, and ask again rather than hiding the change.3334## One review checkpoint3536Before a material handoff, commit, publish, or external write, perform one37explicit review of:38391. facts and user decisions;402. remaining assumptions;413. scope and side effects; and424. verification, rollback, or the next user-visible step.4344Resolve only new issues found in that review. Do not reopen settled choices45without evidence.4647## Report clearly4849Lead with the result. When a question is necessary, make it answerable without50requiring the user to reconstruct the whole investigation. When proceeding on a51delegated choice, name the choice, evidence, and boundary in the handoff.