Chapter 8: Hallucination example and explanation conflates two techniques - incorrectly attributes it to the wrong technique

Open
#48 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
jupyter-notebook
Domain
ai, documentation

Research direction

Start with the Chapter 8 lesson and inspect the hallucination example and its two prompt modifications. Compare scratchpad-only, metacognitive-only, and combined versions, then revise the explanation so the techniques are tested independently or their separate contributions are clearly acknowledged.

Written by the indexing model from the issue text.

Description

Issue Summary
Chapter 8's main example conflates two distinct prompt modifications and incorrectly attributes hallucination reduction to the scratchpad technique, when the metacognitive instruction appears to be the primary (or sole) effective component.

The Problem
The lesson states:

"a great way to reduce hallucinations on long documents is to make Claude gather evidence first. In this case, we tell Claude to first extract relevant quotes, then base its answer on those quotes."

However, the "improved" prompt makes two simultaneous changes:

Adding scratchpad for evidence gathering
Adding explicit metacognitive instruction: "consider whether it answers the user's question or whether it lacks sufficient detail"

Experimental Findings
Testing reveals that:

❌ Scratchpad alone (without metacognitive instruction): Still hallucinates
✅ Metacognitive instruction alone (without scratchpad): Prevents hallucination
✅ Both combined: Prevents hallucination

This suggests the metacognitive instruction - which essentially gives Claude permission to acknowledge insufficient information - is doing the heavy lifting, not the scratchpad mechanism, which is contrary to the the lesson/text.

Why This Matters
This is a confounding variable problem. The tutorial teaches that scratchpad/evidence-gathering prevents hallucinations, but doesn't isolate this variable. The actual effective technique appears to be explicitly prompting the model to evaluate information sufficiency, which is a well-known hallucination mitigation strategy distinct from chain-of-thought reasoning.

Suggested Fix
The lesson should either:

Test each technique independently to demonstrate their individual effects
Acknowledge both components and clarify that the metacognitive check (giving an "out") may be more critical than the evidence-gathering structure
Provide a cleaner example where the scratchpad technique can be isolated and its specific benefits demonstrated

Dominant language
Jupyter Notebook
Stars
39.5k
Forks
4.4k
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from anthropics/prompt-eng-interactive-tutorial

All issues in anthropics/prompt-eng-interactive-tutorial

Similar issues

More AI Infra & Agents issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.