Skip to content

// Foundations · ~2 min read

Reflection / Self-Critique

Reach for it when: a first draft is cheap and a second pass catches real mistakes.

After this lesson you can: Add a limited draft → critique → revise loop that checks the draft against a rubric.

// 60-second mental model

How to hold it in your head

Generate something. Criticize it against a checklist. Revise once (or twice). Ship the revision — not the first draft.

Reflection is a generate → critique → revise loop with a limited number of passes. In Self-Refine (2023), the same model writes feedback on its own output and revises until a stop condition; Reflexion (2023) adds memory of past attempts. This lesson makes the critique concrete with an explicit rubric.

How this differs

Three lessons use a draft → check → revise loop. Reflection: the same model critiques its own draft against a rubric. Evaluator-Optimizer: a separate scorer returns a number, and you revise until it clears a threshold. Critic-Actor: a separate critic returns pass or revise with notes, and after a capped number of retries a human decides.

// Mini architecture

Draft → critique against rubric → revise (bounded)

A task and a rubric go to a Generator, which writes draft 1. A Critic lists issues against the rubric. If there are no issues or the pass limit is reached, the draft is final; otherwise the Generator revises and the Critic checks again.

The critic never invents new goals — it only scores the draft against the rubric you gave it.

// Mini-project

Rubric-backed email rewrite (stub)

Generator and critic stubs

Goal: Rewrite a blunt outreach email until a stub critic reports zero rubric failures or hits maxPasses=2.

  1. Start with a canned rude draft.
  2. Rubric: clarity, no blame, one clear ask, under 120 words.
  3. Critic stub returns structured `{ pass, failures[] }`.
  4. Generator revises only the failing dimensions.
  5. Stop at pass or maxPasses; print draft history.
  6. Refuse a third pass even if the critic still complains.

Wire real models later. The point is bounded reflection with a rubric — not endless self-talk.

// Common failure

What goes wrong

Symptom

Endless revise loops — the critic always finds one more nit.

Fix

Hard maxPasses plus a “good enough” rule: ship when failures are only style nits, or when passes are exhausted.

// Self-reflection

Sit with this

Which of your prompts ship first drafts that a cheap critique pass would have caught?

Sources

Session only. Nothing is saved.