Guido van Dijk
180361eda4
Eight step-by-step guides, appendices (design patterns, design card with eight filled-in examples, AI tools in education), facilitator guide and presentation. LeX Consultancy edition; screenshots from the Dutch build of the same apps. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
37 lines
2.0 KiB
Markdown
37 lines
2.0 KiB
Markdown
<!--
|
|
FOR THE EDITOR
|
|
|
|
Filled-in design card for guide 1, generated by make_examples.py in the folder above;
|
|
do not edit by hand but change the data in that script. Build: python3 build.py
|
|
STYLE: compact (smaller type, see build_guide.py)
|
|
-->
|
|
|
|
# Design card: Text at level
|
|
|
|
**For the AI Agents workshop · filled-in example for guide 1**
|
|
LeX Consultancy B.V. · 20 September 2026
|
|
|
|
This is what the card looks like once filled in. Form: **Workflow**, guide 1. Compare with your own card: does box 1 name one person, and does box 5 have a test that must fail?
|
|
|
|
| 1. Who is it for | 2. What goes in |
|
|
| --- | --- |
|
|
| An English teacher with a reading text from the course book that is too hard for half of Year 9. Has ten minutes before the lesson and does not want to rewrite it by hand. | The text (pasted, a Paragraph field) and the level from a short list: year 6, year 7, year 9, year 12 (a Select field). |
|
|
|
|
| 3. What comes out | 4. What it must stick to |
|
|
| --- | --- |
|
|
| The text rewritten at the chosen level, with all the content kept and technical terms explained in a subordinate clause; below it three comprehension questions (fact, main idea, application) without answers. | Short sentences, leave nothing out, do not replace technical terms. No knowledge base needed: the rules live in the prompts of the two LLM steps. |
|
|
|
|
**5. How you know it works**
|
|
|
|
| Test | What goes in | What must come out |
|
|
| --- | --- | --- |
|
|
| 1 | A paragraph from a geography course book, level year 7 | Shorter sentences, same facts, three questions that are about the text |
|
|
| 2 | The same paragraph, level year 12 | Barely simplified, questions at analysis level |
|
|
| 3 (the hard one) | A text with a table of figures, level year 6 | The figures stay correct; the app invents no new numbers |
|
|
|
|
**What this card decided**
|
|
|
|
- Boxes 1 and 2 decided the input fields and the first question of the app.
|
|
- Box 4 decided the form (Workflow) and what had to go into the knowledge base or the files.
|
|
- Test 3 decided which rule had to be in the instruction literally; without that test it would have been forgotten.
|