Vibe Rounds - Socratic Ai

 For the full architecture -

The Socratic method is the spine, not a single feature

1. It's literally Module 1, and everything else builds on it. Module 1 — "Socratic Clinical Reasoning" — establishes the core contract: the objective is to push a learner to reason through a case actively rather than passively receive the answer. Every other module cross-references back to it as the "structural template" or "logical prerequisite."

2. The core mechanic is forced commitment before reveal. The Step 1.0 setup prompt explicitly instructs the AI to ask one question at a time, wait for the learner's response, and only reveal the answer after the learner has made a genuine attempt and explicitly surrendered — redirecting once with "give your best guess, differential, or next step first" if they ask for the answer without trying. This is the Socratic essence: the AI never just tells you the diagnosis — it makes you commit to a guess first, and only then guides you toward the gap in your reasoning.

3. It teaches by exposing gaps, not correcting outright. Across the whole repo, the recurring instruction is variations of: don't correct the student directly — ask one pointed question that helps them find the gap themselves (you can see this almost verbatim in the roleplay templates near the end of the file too, e.g. "Don't correct me outright — help me find the gap myself").

4. Every other module is a Socratic variant scoped to a different skill, not a different method:

• Module 12 (Devil's Advocate) = adversarial Socratic pressure for diagnostic anchoring
• Module 14 (Resource-Constrained) = Socratic forced-commitment applied under low-resource limits
• Module 15 (Illness Scripts) = deliberately diverges from Module 1's stepwise Socratic pattern to train pattern-recognition instead — but is explicitly framed as a departure from the default, proving the default is Socratic
• Module 17 (Problem Representation) = Socratic withholding applied even earlier in the reasoning chain (withholding the diagnosis attempt, not just the answer)
• Modules 4, 5, 18 (ward rounds, real-time review, rapid triage) all reuse the "Mid-Session Reasoning Checkpoint" (Step 1.4) structure as a recurring formative loop

5. The pedagogical scaffolding is Socratic-compatible by design. Bloom's Taxonomy (Step 1.5) and Fink's FLINK (Step 1.6) aren't separate teaching philosophies bolted on — they're applied through the same one-question-at-a-time, wait-for-response, affirm-then-probe loop.

6. Even the "build a case" roleplay versions preserve it. The progressive-vignette templates (Versions 3–5) release the case in chunks specifically so the Socratic question-per-chunk rhythm can repeat — vignette → one pointed question → next chunk — rather than dumping the full case and losing the reasoning checkpoints.

So the throughline is: Module 1 sets the contract (commit before reveal, probe don't correct), and the other 19 modules are that same contract re-applied to different clinical contexts (wards, polypharmacy, resource scarcity, SDOH, rapid triage) or deliberately flagged as the exception when they diverge from it.