Skip to main content

The DEEP Build Kit · Starter brief

Writing a PEEL paragraph

Six screens that fade a worked example: a full PEEL paragraph, a partly finished one, then the student writes their own.

For: English and humanities, ages 11–14

A starter tool for the Build with AI masterclass. Level 1 ● Blue can open it to see what a finished Respond build looks like, or remix it for their own class. It is an interactive explainer that fades a worked example, built and tested with the DEEP Build Loop: Brief it · Build it · Break it · Fix it · Teach it.

The tool is one .html file. Open it from this page, or save it and double-click it: it opens in a web browser and works offline.

The text students analyse, "The Lighthouse", is a short extract written for this activity. That means there is no published text to get permission for and no outside facts to get wrong, and every quotation can be checked against it word for word.

The brief

Learning goal. Students can write an analytical paragraph about a short text using PEEL:

  • Point: one sentence that answers the question;
  • Evidence: a short, exact quotation;
  • Explain: what particular words suggest;
  • Link: a sentence back to the question.

Who uses it. Year 7–9 students on their own, about 20 minutes. Use it just after the teacher has introduced PEEL, or as a first introduction with the teacher circulating. Afterwards the teacher reads a few of the "Your turn" paragraphs aloud, or collects them on paper.

The learning move. A worked example that fades. First a fully worked paragraph, revealed one part at a time with a "why?" prompt at each part. Then a partly worked paragraph for the student to finish. Then the student writes one alone, with a checklist. It ends with one retrieval question.

How students reach it. One .html file, opened in a web browser on the student's device. There is no login and no account, and it needs no internet. Publishing it as a link is a stretch (card 17).

Must do.

  • One idea per screen, over 6 screens.
  • Reveal the worked example one part at a time, with a "why?" question whose reason stays hidden until asked for.
  • A partly worked example (Point and Evidence given; the student writes Explain and Link).
  • A full attempt with a 4-point checklist, and a "Copy my paragraph" button that copies it to the clipboard only.
  • Show example answers only after the student has written something.
  • One retrieval question from memory, with feedback that explains. Hide Back on that last screen, so students answer without looking back.
  • Keep the extract one click away on every screen that uses it.
  • Move focus to each new screen's heading.

Must never do.

  • Show a model answer before the student has tried.
  • Mark or score students' writing, by rule or by AI.
  • Save or send what students type.
  • Use a text still in copyright without permission.
  • Add walls of text, decorative images, or a controversial topic.
  • Load anything from the internet.

Acceptance criteria.

  1. Every quotation in the examples appears word for word in the extract: each one is compared, not judged by eye.
  2. Example answers stay hidden until the student has typed something.
  3. Exactly one screen is visible at a time, and focus moves to each new screen's heading.
  4. It works with the keyboard only, at 320 px, at 4.5:1 contrast.
  5. No network requests and no storage: the page does not save what students type or send it anywhere.

Test cases (written before building).

#CaseExpected
T1Open the page and press Next"Screen 1 of 6", four parts listed, no Back button; Next goes to screen 2 and focuses its heading
T2Move through every screenExactly one screen visible each time
T3Reveal the worked example with the keyboardParts appear in the order Point, Evidence, Explain, Link, one per press; each has a "Why?" question; each reason stays hidden until asked for; then the whole paragraph. The extract opens and closes with the keyboard
T4Partly worked: press Compare with empty boxes, then write and compareA prompt, and no example; after writing in both boxes the example Explain and Link appear and take focus
T5Your turn: press Compare with nothing written; tick the checklist; write and compare; press Copy my paragraphA prompt, and no example; all 4 ticks work with Space; after writing, the 4-part possible answer appears; Copy puts exactly the paragraph on the clipboard and says so, with no request and nothing stored
T6Retrieval question: wrong answer, then (after Start again) right answerBack and Next are both hidden on screen 6; wrong: "Not quite. The answer is B." + why + a note on the chosen option; right: "Correct." + why; finish message shown
T7Quotation accuracyEvery ‘…’ quotation in the examples and hints appears word for word in the extract (or the question)
T8Start againBack to screen 1; typed text, ticks, revealed parts, examples, messages and the retrieval answer all cleared

Non-goals. It does not judge the quality of students' writing. It does not teach how to embed quotations, or subject terminology, in depth. It does not cover PEEL variants (PEE, PETAL and others). It is not a whole essay.

Reuse plan (checklist item 11). A week later, students answer the retrieval question again and write one PEEL paragraph on a new extract without the tool.

Check of learning (checklist item 12). The teacher marks that paragraph against the four checklist points. How many students have an Explain that names what particular words suggest? Compare with the "Your turn" paragraphs from the first lesson.

The faded brief

Copy this, fill in the four [YOUR CLASS: …] gaps with your partner, then give it to your AI tool with the .html file.

Learning goal. [YOUR CLASS: in one sentence, what kind of paragraph, about what kind of text or source? e.g. PEEL about a history source, or PEE about a poem]

Who uses it. [YOUR CLASS: year group, when in the lesson, and what they have already been taught]

The learning move. A worked example that fades: fully worked with "why?" prompts, then partly worked, then the student's own attempt with a checklist, then one retrieval question.

How students reach it. One .html file, opened in a web browser. No login, no account, no internet needed.

Must do. One idea per screen. The worked example is revealed one part at a time, with a "why?" at each part. Example answers only after the student has written something. A 4-point checklist and a "Copy my paragraph" button (clipboard only). One retrieval question with feedback that explains, with no Back button on that screen. Keyboard and phone width must work. [YOUR CLASS: the text or source students will use (your own, out of copyright, or one you have permission for), and the three questions: worked, partly worked, your turn]

Must never do. Model answers before an attempt; scoring students' writing; saving or sending what they type; copyrighted text without permission; decoration; loading anything from the internet.

Acceptance criteria.

  1. [YOUR CLASS: how will you check that every quotation matches your text exactly? For example, find each quotation in your text and compare it word for word, with your partner.]
  2. Examples stay hidden until the student has written something.
  3. One screen at a time.
  4. Keyboard, 320 px and contrast all work.
  5. No network requests or storage.

Test cases. Keep T1–T6 and T8 above. Rewrite T7 for your text.

How it was tested

  • An automated browser test ran every test case above at 320 px wide, using the keyboard only. All passed.
  • All 17 quotations in the examples and hints were compared with the extract: each appears word for word, apart from ‘lonely’, which is taken from the question.
  • Accessibility: text contrast at least 4.5:1, a visible focus outline at every Tab stop, controls at least 24 × 24 px, no sideways scroll at 320 px, nothing moves, and no issues found by the axe-core accessibility checker. Each text box has a visible label.
  • The page made no network requests and stored nothing; it tells students it does not save or send what they type.
  • Not tested: real screen readers, Safari and Firefox, or real phones. Try it on a class device before you use it.

What went wrong in testing, and the fix

  • Back was still on the last screen, so students could go back and look before answering the memory question. Fix: Back is hidden on screen 6, and T6 checks that the keyboard cannot reach it.
  • Start again left old messages on screen, such as "Write your paragraph first". Fix: Start again clears them, and T8 checks it.
  • A Check button stayed on screen after answering, because a layout rule overrode the setting that hides it. Fix: hidden things now stay hidden.

The teacher's build checklist (12 points)

#CheckHow this starter meets it
1One learning goalWrite one PEEL paragraph about a short text
2Students think, not just click"Why?" at each worked part; students write the Explain and Link, then a whole paragraph
3Retrieval built inIt ends with a question answered from memory
4Feedback explainsWhy, plus a note on the chosen wrong option; example answers to compare against a checklist
5Guidance matches the learnerFull example → partial → independent: the guidance fades
6Nothing decorativeNo images, points or fun facts; one short extract
7Visuals integratedOne idea per screen; each part labelled P, E, E, L where it appears
8Few controlsBack and Next; on screen 3 a reveal button and a reason button per part; on screens 4 and 5 a Compare button (screen 5 adds Copy and four ticks); on screen 6 Check my answer and Start again
9Facts checkedEvery quotation is compared with the extract word for word; the extract is invented, so it has no outside facts
10AccessibleSee How it was tested above
11ReusedReuse plan in the brief
12I'll know if it workedA paragraph on a new extract a week later, marked against the checklist

Remix ideas

  1. "Replace the extract and all three questions with this history source and these questions: [paste]. Keep the same screens, the same 'why?' prompts adapted to the new text, and quotations in ‘single quotes’ copied exactly. Change nothing else."
  2. "Change PEEL to PEE (Point, Evidence, Explain) everywhere, including the checklist and the retrieval question. Change nothing else."
  3. "Add a second 'Your turn' screen with a new question on the same extract, after screen 5, in exactly the same format. Change nothing else."

DEEP Education Network · Build with AI · Two rules: no student names or data anywhere; nothing student-facing calls AI.