The example: session 1 of Principles of Microeconomics

Andreas, 2 October 2026: "we now have a spectacular use case. This is very good, and it should be the example of how to set it up." This page is that example. It lists what was done, in order, with the files it made. Every step is a button in the app and a command underneath. The course is courses/micro101, built from the OpenStax book Principles of Microeconomics 3e (CC BY-NC-SA 4.0).

The setup, once per course

  1. New course. Home, New course, a title. The code and the dates came later.
  2. Books. Course, Books: the OpenStax PDF dropped in and ticked. The licence was read from the PDF's copyright page.
  3. Build the book index. The button in the library. 1704 chunks with chapter, section and printed page. Ten test queries return the right chapter and page for 7 of them. The misses are the wording of the queries.
  4. Chapters into sessions. Chapter 2 dragged into session 1's Video lane. A section of a chapter can be dragged on its own.
  5. Describe the session. Click the session, eight questions. "Suggest answers from the material" read the chapter and filled every answer with its page. The teacher's own words go on top.
  6. Dates. Settings, Dates: typed, or read from a timetable link.
  7. Voice. Course, Voice: Fish Audio for English, the clone from twelve read cards. The key and the model id live in the Keychain, never in a file.

The chain, one button at a time

Each step is drafted by the model the teacher chose, Claude Opus here. Its gate checks it. It is left as a draft for the teacher. The session's next-step button always says what comes next.

StepWhat it makesGateTime, cost
Draft the plansessions/s01/plan.md: goals, rubric rows, seven segments, the worked example with Alphonso's $10citations resolve in the indexabout two minutes, under $2
Draft the slidesdecks/L1_*.tex, 30 frames, 28 in the video, 109 stepsbuilds three ways, zero overfull boxes, the scannersabout ten minutes, under $5
The adversarysessions/s01/adversary.md: a second model reads the transitions and the difficultyfindings with Agree and Dismissa few minutes
Draft the narrationscripts/s01_*.md: one block per slide, [click] at each step, 2205 wordssteps match the slide pages, both prose checksabout five minutes
Voiceaudio/s01/, 109 clips in the teacher's own voicethe transcript check, 0.953 on averageabout 18 cents
Videovideo/s01_async.mp4, 13 minutes 17 seconds, and its compressed copyone page per clipabout two minutes
Draft the notesnotes/s01.qmd and its PDF, nine pagesreview questions at the end, no solutions, no verbatim narration, both prose checksabout five minutes
Draft the quizquizzes/quizdata_s01.py and the quiz, ten questionsthe hint rule, the numbers checkedabout three minutes
Draft the problem setdecks/A1_.tex and decks/S1_.tex, six tasksbuilds, every rubric row trainedabout five minutes
Draft the in-person deckdecks/IP1_*.tex, 21 frames, nothing the video did not coverbuilds, the scannersabout five minutes
Write the companioninperson/s01_companion.tex, 11 A5 pagesbuilds, page 1, both prose checks on the text read backabout five minutes
Speaker notes and PowerPointscripts/s01_speaker.md, decks/L1_*.pptxone note per slideabout three minutes
Make the surveysegments/s01_segments.json, sessions/s01/survey.mdoptions equal the segmentsinstant, no model

Times and costs are what the runs of 1 October took on one Mac with Claude Opus. They are not promises.

What the teacher does with it

Read each draft in the app and press Approve, or edit it in the block editor and let it go back to draft. Three things the agents could not decide came back as questions. The letter for income. Whether the production possibilities frontier belongs in session 1. A chapter placed in the in-person lane that the video does not cover. Pronunciation is fixed by listening and choosing. pipeline/pronounce.py made five spellings of "economics" in the teacher's voice, and the chosen one went into lexicon.json.

Then Settings, Publish: a dry run, a tick, and the push to TavlAI or Canvas, where everything arrives unpublished.

The files, for a reader without the app

sessions/s01/plan.md, decks/L1_async.pdf, scripts/s01_scarcity_choice_and_the_.md, video/compressed/s01_async.mp4, notes/s01_notes.pdf, quizzes/s01_review_quiz.md, decks/A1_.pdf, decks/S1_.pdf, decks/IP1_.pdf, inperson/s01_companion.pdf, decks/L1_.pptx, sessions/s01/survey.md. The PDFs, the audio and the video are built products. They are not in the repository. The sources are.