diff --git a/docs/education/README.md b/docs/education/README.md index 5aea0983..443a5617 100644 --- a/docs/education/README.md +++ b/docs/education/README.md @@ -13,6 +13,7 @@ - [What every page also teaches](#what-every-page-also-teaches) - [How this connects to the other guides](#how-this-connects-to-the-other-guides) - [About the examples](#about-the-examples) + - [Learn with an AI tutor](#learn-with-an-ai-tutor) - [Licence](#licence) @@ -140,6 +141,23 @@ Every example uses placeholders in place of real names: ``, skill, you change your own settings, not the example text. If you ever see a real project name written into a skill, that is a bug. +## Learn with an AI tutor + +Each lesson in the progression above has a matching AI tutor prompt in +[`ai-tutors/`](../../ai-tutors/README.md). Load one into any capable chat +model and it teaches that lesson interactively — walking through the ideas one +at a time, running the exercises, and checking your answers against the lesson +keys. + +**How to load a tutor:** open the matching `lesson-*.md` file under `ai-tutors/`, +find the `---` separator, and paste everything below that line as the system +prompt. The notes above the separator are for you; only the text below goes to +the model. See [`ai-tutors/README.md`](../../ai-tutors/README.md) for +tool-by-tool instructions (claude.ai Projects, Open WebUI, API). + +The tutors are companions to the readable pages, not replacements for them. +Every lesson in this progression stands on its own without a model. + ## Licence Everything in `docs/education/` is under the Apache License 2.0 (PRINCIPLE 17). diff --git a/docs/education/training/README.md b/docs/education/training/README.md index e73099fe..ce6de1c6 100644 --- a/docs/education/training/README.md +++ b/docs/education/training/README.md @@ -12,6 +12,7 @@ - [Delivery formats](#delivery-formats) - [Prerequisites](#prerequisites) - [Placeholders](#placeholders) + - [Learn with an AI tutor](#learn-with-an-ai-tutor) - [Licence](#licence) @@ -99,6 +100,22 @@ control. Specific technical prerequisites are stated in each lesson. Exercises use `` wherever a real project name would appear. Substitute your own project name when working through the activities. +## Learn with an AI tutor + +Each lesson in the module map above has a matching AI tutor prompt in +[`ai-tutors/`](../../../ai-tutors/README.md). Load one into any capable chat +model and it teaches that lesson interactively — working through the +objectives, exercises, and self-check questions one step at a time. + +**How to load a tutor:** open the matching `lesson-*.md` file under `ai-tutors/`, +find the `---` separator, and paste everything below that line as the system +prompt. The notes above the separator are for you; only the content below goes +to the model. See [`ai-tutors/README.md`](../../../ai-tutors/README.md) for +tool-by-tool instructions (claude.ai Projects, Open WebUI, API). + +These prompts are companions to the lesson wrappers, not a replacement for the +source pages or in-person instruction. + ## Licence Apache License 2.0 (PRINCIPLE 17). Contributions carry a `Generated-by:` note