Skip to content

Add recipe: Socratic AI dialogue for technical learning#10

Open
lawrenceberry wants to merge 1 commit into
mainfrom
recipe/socratic-deep-dive
Open

Add recipe: Socratic AI dialogue for technical learning#10
lawrenceberry wants to merge 1 commit into
mainfrom
recipe/socratic-deep-dive

Conversation

@lawrenceberry

Copy link
Copy Markdown

Summary

  • Adds socratic-deep-dive recipe card to _data/recipes.yml
  • Adds companion page _recipes/socratic-deep-dive.md (renders at /cookbook/socratic-deep-dive/)
  • Documents the workflow of using targeted, iterative AI dialogue to build deep understanding of a complex technical topic — faster and more precisely than a textbook

Recipe content

Case study: An 18-exchange Gemini conversation starting from "how do IMEX RK methods work?" that built precise understanding of IMEX-Rosenbrock-Wanner ODE solvers, ending with a commissioned 4,000-word synthesis document.

Three principles documented:

  1. Enter at the boundary of your understanding
  2. Ask for elaboration on specific parts, not general follow-ups
  3. Test understanding by proposing your own hypothesis

Key insight: The stiffness question for CMB Einstein-Boltzmann equations (ARK vs PRK) emerged from a student-formed hypothesis — this is the kind of domain-connected learning a textbook cannot produce on demand.

Test plan

  • script/cibuild exits 0 ("It builds!")
  • /cookbook/socratic-deep-dive/ returns 200 on local server
  • /cookbook/ returns 200 (card visible)
  • id, filename, and frontmatter all agree on socratic-deep-dive

🤖 Generated with Claude Code

…rning

Documents the workflow of using targeted, iterative AI dialogue to build
deep understanding of a technical topic — illustrated by an 18-exchange
session on IMEX Runge-Kutta and Rosenbrock ODE solvers that produced a
4,000-word reference document covering theory through CMB application.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 5, 2026 12:03

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new AI Cookbook recipe documenting a “Socratic deep dive” workflow for targeted, iterative AI dialogue to build technical understanding, with both a card entry and a long-form companion page rendered under /cookbook/.

Changes:

  • Added a new long-form recipe page at /cookbook/socratic-deep-dive/ with frontmatter aligned to the recipe schema and content starting at ## (no duplicate H1).
  • Appended a matching recipe card entry to _data/recipes.yml so the recipe appears in the cookbook index and links to the companion page.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
_recipes/socratic-deep-dive.md Adds the companion long-form recipe page with matching id and cookbook content.
_data/recipes.yml Registers the new recipe card (matching id) so it appears on /cookbook/ and links to the long-form page.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants