Skip to content

About this project, as slides

An open training suite

Interactive lessons for people who start to use generative AI in their work, from the first prompt to building an agent.

  • 133lessons
  • 431graded checkpoints
  • 133exercises

schubergphilis.github.io/ai-training

Agenda

  1. Why the project exists A common starting point for safe and useful work with AI
  2. What the site contains Areas, courses, lessons and the model behind them
  3. How a lesson teaches Checkpoints, review and the research behind them
  4. Building with AI agents AI agents write, one maintainer decides, a harness checks

Why

Generative AI reached office work in a short time, and most people got no training in how these tools work or fail.

A common starting point

A group that learns the same words and the same basic model of the tools can discuss a result, a risk or a working method with each other.

Safe use and real use together

People stop checking a machine that does most of a task. So safety comes first, and every area returns to checking the output.

Open content

Anyone may run the courses, change a lesson to fit their own tools, or study alone with only a browser.

What

133 lessons in 6 areas, counted when the site is built. A lesson covers one topic, and each graded checkpoint tests one learning objective.

covers oneservestests one2groupsFoundations and Engineering6areasone course each35topics6coursesin 36 parts21competencies199conceptseach one a glossary entry133lessons93objectives75 base, 18 expert133exercisesand 60 habits431checkpointsand 421 for review only291behaviorsclaim, reason and example

What

Foundations is for anyone who does knowledge work and needs no programming. Engineering is for software engineers and uses real code and real tools.

LessonsTopicsCheckpointsFoundations: everyoneConceptsWhat AI models are and how they behave.20652SafetyUsing AI safely, and judging the risk ofletting an agent act.18553Using agentsDelegating work to an agent and checking whatcomes back.14443Engineering: software engineersCoding with agentsShipping software changes with a coding agent.277106Customizing agentsConfiguring an agent for a project withinstructions, skills, tools and permissions.26691Building agentsBuild an agent from a model, a loop and tools.28786

How a lesson teaches

Each lesson has the same parts in the same order. It is one page of 10 to 25 minutes, plus an exercise that the learner does in their own tools.

OpeningOne or two sentences on what the lesson doesTeaching sectionOne idea, with an example to run or predictPitfallPitfallA common mistake and what it costsCheckpointCheckpointGraded, close to the idea it testsCheckpointExerciseExerciseDone outside the page, with your own toolsRecapFinishRecapTakeaways, objectives, and the finish buttonHabitHabitOne change to try in your real work

How a lesson teaches

A wrong answer gets feedback, and a hint asks a question about the mistake. The page never reveals the answer.

ChoicePicks the one right option139Multiple choicePicks every right option31ScenarioPicks what to do in a short work situation84PredictPredicts what code or a prompt will produce62SortPuts items into groups53MatchMatches each item to one on the other side38OrderPuts steps in the right order10RepairRewrites a flawed prompt, instruction or code14

How a lesson teaches

  • Retrieval practice. Recall an idea again, instead of reading it again.
  • Spaced review. The gaps between reviews grow.
  • Habits. One change in real work, asked about again a few days later.
lessondays after the lessonReview item14113292Habit137

Building with AI agents

0255075100125150Live lessons1037100114132September 19September 26October 312345678910
  1. September 19. Repository created. Plan, interview, exploration notes, license change, first specs.
  2. September 20. First release. Prose and spelling checks. First parallel agent work: twelve issues to twelve merged pull requests.
  3. September 21. All structure moved into data files: one YAML file per area, competency, course and lesson.
  4. September 23. A second layer of agent orchestration, the "wave" process, so that one session can work through many issues.
  5. September 24. Habits. Exact versions for every dependency. The first review of the agent harness. The default agent model changed.
  6. September 25 to 27. Most lessons were written, in batches of four to ten. A security review of the whole site started.
  7. September 29. The site left its pre-release status.
  8. September 30. The repository moved to the organization's account and became public. The site got its visual identity.
  9. October 1. A Content Security Policy on every page. Markdown copies of pages and data files for AI agents. A guide for running a workshop.
  10. October 4 to 8. Lessons for the remaining gaps. A skill for triage with the maintainer. The second harness review.

Building with AI agents

Almost every commit names the AI model that helped write it. These figures are as of October 9, 2026.

  • 1,436commits
  • 17days with commits
  • 608issues, 533 closed
  • 153merged pull requests, of 154
Claude Opus 5.5868Claude Fable 5.1553claude-opus-5a model string in six commits6No model namedby the maintainer or a bot9

Building with AI agents

A dispatcher starts a wave lead, and the lead starts one builder per issue and one reviewer per branch. The maintainer has given standing approval for a wave that passes every check.

Maintainerstarts a runDispatcherpicks ready issuesWave leadBuilder 1own copy and branchReviewer 1reads, runs checksBuilder 2own copy and branchReviewer 2reads, runs checksBuilder 3own copy and branchReviewer 3reads, runs checksbranchreview, passed on to the builderapprovedbranchesWave branchbranches combinedEvery checkthe full suiteOne pull requestmerged when greenmain

Building with AI agents

How work is split

  • Each builder works in its own copy of the repositoryTwo agents that overwrite each other's work
  • Only the dispatcher, a wave lead or a coordinating session may mergeA builder or reviewer that merges its own work
  • A change to the harness merges only after a restart and a manual checkHooks or settings that were never loaded and tested reaching the main branch

The guard hook

  • Blocks a push to the main branch and a plain force pushChanges that skip review and the checks
  • Blocks commands that delete branches, repositories or issuesLoss of work that can't be undone
  • Blocks commands that skip the git hooksCommits that never ran the local checks
  • Limits long waits and polling loopsAgents that spend hours and tokens waiting

Permissions

  • Reviewers can only read, and their shell commands are on an allow-listA reviewer that changes the branch it reviews
  • Agents may not edit their own permission settingsAn agent that loosens its own limits

Untrusted text

  • Agents read issues through a filter that shows only the maintainer's textInstructions planted in a public issue comment
  • Every agent treats text in issues, pages and diffs as dataPrompt injection through content the agent reads

Checks on the output

  • A prose linter with rules for typical AI writing patternsLessons that drift into the style that marks text as machine-written
  • A fixed evaluation of the tutorA model or skill change that makes the tutor give answers away

Building with AI agents

The build writes HTML for people, and Markdown and data files for agents that read the site for a person. GitHub Pages serves the files, and the progress record stays in the learner’s browser.

BuildschemascheckpointstermscitationslinksYAML dataareas, topics, plansMDX pageslessons, guidesBibliographyone entry per sourceHTML pagesfor peopleBrowser scriptsprogress in the browserMarkdown, llms.txtand JSON dataAgentsthat read for a personLesson bundlesand tutor instructionsLearner’s agentwith the tutor skill

See more

schubergphilis.github.io/ai-training