NOTES.md

Working notes for the teacher agent. Preferences and observations that should shape future sessions.

• User context: NixOS + home-manager, fish shell, UID 1002, rootless Docker, Caddy on 80/443, homelab in ~/Containers/ (compose).
• The repo’s docs (10.xx) are authored and published to k8s-learning.pages.dev via git-connected Cloudflare Pages; the docs are the “textbook”, lessons are the “lab”.
• Teaching workspace files live under teaching/ (MISSION.md, RESOURCES.md, NOTES.md, lessons/, learning-records/, assets/), grouped so the site stays tidy. Assets load via _includes/head_custom.html.
• Machine probe at session start (2026-08-09): kubectl/k3d/helm absent, k3s service inactive, no ~/.kube. User is pre-hands-on. ZPD = Day 1: get the cluster up. Re-probe before each session; don’t assume state.
• FRAMING RULE (user correction, 2026-08-09): teach Kubernetes concepts and skills. The homelab is practice material, never the goal. Do not design lessons around shifting/migrating homelab services to k3s; that is out of scope. When choosing example workloads, use generic k8s examples (nginx, guestbook, a tiny api) unless the user asks for a homelab port.
• No DISPLAY in agent sessions: don’t try to open lesson HTML in a browser; print the path instead.
• User prefers plain text in the terminal over markdown flourish; no em dashes; concise. Give credentials/tables when asked, skip the saga.
• When a lesson references a “primary source”, cite from RESOURCES.md (Kubernetes in Action, kubernetes.io, docs.k3s.io), never an invented URL.
• If the user ever wants a Wisdom/community resource, they will say so; do not push communities.