From be55a7970319ede7965edbb02b5e41cba1ca82c9 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Sat, 6 Jun 2026 10:12:27 +0100 Subject: [PATCH] Add NOTES.md for recording user preferences and teaching notes --- skills/in-progress/teach/SKILL.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/skills/in-progress/teach/SKILL.md b/skills/in-progress/teach/SKILL.md index baa51be..ad3f81c 100644 --- a/skills/in-progress/teach/SKILL.md +++ b/skills/in-progress/teach/SKILL.md @@ -16,6 +16,7 @@ Treat the current directory as a teaching workspace. The state of their learning - `RESOURCES.md`: A list of resources which can be explored to ground your teaching in contextual knowledge, or to acquire knowledge and wisdom. Use the format in [RESOURCES-FORMAT.md](./RESOURCES-FORMAT.md). - `./learning-records/*.md`: A directory of learning records, which capture what the user has learned. These are loosely equivalent to architectural decision records in software development - they capture non-obvious lessons and key insights that may need to be revised later, or drive future sessions. These should be used to calculate the zone of proximal development. They are titled `0001-.md`, where the number increments each time. Use the format in [LEARNING-RECORD-FORMAT.md](./LEARNING-RECORD-FORMAT.md). - `./lessons/*.html`: A directory of lessons. A **lesson** is a single, self-contained HTML output that teaches one tightly-scoped thing tied to the mission. This is the primary unit of teaching in this workspace. +- `NOTES.md`: A scratchpad for you to jot down user preferences, or working notes. ## Philosophy @@ -102,3 +103,7 @@ Some learning topics lend themselves to reference: - Glossaries for any topic with its own nomenclature Glossaries, in particular, are an essential reference. Once one is created, it should be adhered to in every lesson. + +## `NOTES.md` + +The user will sometimes express preferences of how they want to be taught, or things you should keep in mind. This is the place to record those preferences, so you can refer back to them when designing lessons or working with the user.