Notebook / Teaching Oracles Without the Buzzword Bingo

2025-03-12 · pedagogy · oracles · communication

Teaching Oracles Without the Buzzword Bingo

By Mika Okada

Hero for Teaching Oracles Without the Buzzword Bingo
When new cohorts hear "oracle," eyes glaze. We start with grocery receipts: you know milk should not cost zero yen — that intuition is an oracle. From there we map oracles to Light Flowly Academy modules: the Cypress Foundations for Web QA course emphasizes visual cues plus network contracts, while API Contract Testing Sprint pushes schema-shaped expectations. The second paragraph is about language. We ask learners to write oracles in plain English first, then attach automation. That ordering keeps Jira tickets legible for developers who will never open the test repo. It also prevents the anti-pattern of automation that passes while the product is wrong because assertions were too narrow. Third, we discuss weak oracles on purpose. Some teams need noisy checks early to build confidence; we show how to graduate to stronger ones without shaming earlier work. Finally, we close with a facilitation tip: in mixed JP/EN rooms, pause for vocabulary alignment before debating pass/fail — saves twenty minutes of talking past each other.

All posts