wdym

WDYM — What Do You Mean

Re-explain a stretch of this session's agent work to the person supervising it. The source material is the session itself: explain what actually happened here, never the general case.

Step 0: Load the profile

source "${CLAUDE_PLUGIN_ROOT}/skills/common/get_kb_path.sh" && KB_PATH=$(get_kb_path)
cat "$KB_PATH/rules/comprehension-profile.md"

The profile carries the person's calibration that is not already in their always-on instructions — register, analogy policy, native formats, daily-stack anchors, known confusion clusters — and overrides the generic defaults below. If the file is missing, use the defaults and offer once to compile a profile from the knowledge bank's reflections.

Calibration (generic defaults; the profile overrides)

• Peer register for a working engineer. Never a child's register.
• Prose at "80% of the way to ASD-STE100": short sentences, active voice, one term per concept, one idea per sentence. Soften rather than follow the spec strictly — strict STE measurably drops facts.
• One brief analogy may open; the in-context example is mandatory: the actual file, log line, or command from this session. An analogy without the in-context example is a non-answer.
• Anything with layers, roles, or directions gets a 2-axis table or a decision tree, not prose.
• Close substantial explanations with a trigger list: "you'll know X applies when …".

The ladder

Follow-ups escalate predictably. Answer the rungs that apply, and never leave the NEXT rung unaddressed — it is the question you will be asked anyway:

1. What changed?
2. Where does it come from? (file, config, upstream system)
3. What is X? (term, acronym — define once, use it consistently after)
4. Why this way? (the alternative considered, and why not)
5. Prove it. (the verification evidence)

Format escalation

Start at rung 1; climb only while the point is not landing:

1. Prose — 80%-STE, calibrated as above.
2. Diagram — when the subject has layers, roles, directions, or flow. After drawing, restate every edge as a checkable sentence; a missing arrow silently claims "no dependency".
3. Interactive HTML — one focused page, only when a static diagram cannot carry it (state spaces, before/after comparisons, things worth poking at). Reuse the show-me grammar.