Good Questions Make Hidden Context Explicit
agent handoffs should state current understanding, name unknowns, and ask fact-shaped questions before changing state
Julia Evans’ How to ask good questions is a small operating manual for turning confusion into something another person can answer. The sharp bit isn’t “do more homework before bothering people.” She explicitly rejects that hostile bullshit in favor of questions that make your current model visible.
The move is simple: write down what you think you know, ask “is that right?”, and tighten vague questions until the answer can be a fact. Instead of “how do SQL joins work?”, ask whether MySQL sorts join columns first, whether hash joins show up outside Hadoop, or what happens when one side is indexed.
That’s clever because it changes question-asking from social performance into a debugging loop. The answerer can correct a specific model instead of guessing what you’re missing. For joelclaw, this maps directly to agent handoffs and reviewer steps: every agent should state its current understanding, name the unknown term, and ask fact-shaped questions before changing state. Good questions are cheap alignment checks.
Key Ideas
- Julia Evans frames good questions as questions that are easy to answer, not questions that prove the asker did enough ritual homework.
- “State what you know, then ask if it’s right” turns a fuzzy misunderstanding into something another person can correct directly.
- Fact-shaped questions work better than broad prompts because they reveal the exact kind of answer the asker wants.
- Naming unknown terms, like “optimistic locking,” creates space for clarification instead of pretending everyone shares the same context.
- The Etsy Debriefing Facilitation Guide pattern shows how simple questions can expose hidden operational knowledge during incidents.
- Answering questions while ramping on a project can solidify what you just learned and contribute back to the community.
Links
- How to ask good questions — source article by Julia Evans
- How to answer questions in a helpful way — companion article
- Why does rkt store container images differently from Docker? — example question from the article
- How to ask questions the smart way — referenced hostile-but-known guide
- Etsy Debriefing Facilitation Guide — incident question patterns
- How to Contribute to Open Source — André Arko post referenced in the article
- CDNs aren’t just for caching — example of questions becoming useful public writing