Skip to content

Write the part a teacher needs first, which is not software - #41

Merged
peopleworks merged 1 commit into
mainfrom
teacher-package
Aug 5, 2026
Merged

Write the part a teacher needs first, which is not software#41
peopleworks merged 1 commit into
mainfrom
teacher-package

Conversation

@peopleworks

Copy link
Copy Markdown
Owner

Mostly zero code. Docs/Teaching/, bilingual, written rather than translated.

  • Syllabus language — three policies at different strengths, ready to paste, plus what not to write: never name a score, never require a student to prove they wrote something.
  • The student sheet — one page addressed to students: what a flag means, what it does not, what protects them, and the two questions to ask calmly if a conversation goes badly.
  • Committee procedure — assumes the hardest case, the student denies it. Sorts the material into checkable facts, a pattern score, and what the student says; only the first and last belong in a finding.

No licence, no attribution, no permission — they are meant to be pasted into other institutions' paperwork with somebody else's name on top.

Why now. Six bets have shipped and none of them is what a teacher reaches for on the morning they suspect something. Every distribution channel this project has used — a package registry, an MCP directory, a foundation application — contains no teachers. This is the first artefact aimed at one.

Each document is built so a decision made by following it survives the detector being removed from it entirely. The committee procedure quotes the uncomfortable half of our own calibration deliberately: neither language supports a threshold on its own, so a committee quoting the 4.1% aggregate at a student writing in Spanish makes the exact error this project criticises in everyone else.

Also fixes a stale download. Four links still pointed at desktop-v0.1.0, including both translations shipped inside the web app. The badge rendered 0.3.0 and sent whoever clicked it to a build with no PDF reading, no folder scan and no report. They now point at the desktop release listing, which cannot go stale on the next release.

🤖 Generated with Claude Code

Six shipped bets and none of them is what a teacher reaches for on the morning they
suspect something. What they need then is language for a syllabus, a page to hand a
student before anything goes wrong, and a procedure for the day a question becomes
formal — and there is nobody to ask.

Three documents, bilingual, written rather than translated. No licence, no
attribution, no permission: they are meant to be pasted into other institutions'
paperwork with somebody else's name at the top.

All three are built so a decision made by following them survives the detector being
removed from the document entirely. A score is never the reason for a decision about a
student, the burden never moves onto the person with the least power in the room, and
what settles the question is ten minutes of asking somebody why they chose this
example and not another one.

The committee procedure quotes the uncomfortable half of our own calibration on
purpose: neither language supports a threshold alone, so a committee quoting the
aggregate at a student writing in Spanish makes the error this project criticises in
everyone else.

Also unpins the desktop download. Four links still pointed at desktop-v0.1.0 —
including both translations shipped in the web app — so the badge read 0.3.0 and sent
whoever clicked it to a build with no PDF reading, no folder scan and no report. They
now point at the desktop release listing, which cannot go stale the next time we ship.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@peopleworks
peopleworks merged commit fc7b4ad into main Aug 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant