New here? Get the free field guide →

← Blog

EdTech: Building Tools That Outlive the Person Who Built Them

SpecDevShip · · 2 min readedtechuse-cases
Contents

Education technology has an unusual lifecycle: a tool built by one small team or even one developer often ends up running, mostly unattended, for years — a school district's scheduling tool, a university department's grading utility, a learning platform's quiz engine — long after its original builder has moved on to something else.

Why documentation matters more the longer something runs unattended

Most software gets touched often enough that tribal knowledge stays roughly current in someone's head. EdTech tools frequently don't — they run quietly, mostly correctly, for a long time, and then something breaks and whoever's on call has to reconstruct years-old context from scratch. A real spec trail — approved requirements, findings docs, a product.md stating what the tool is actually for and not for — is what makes that reconstruction take an afternoon instead of a week.

Accessibility and correctness as non-functional requirements worth writing down

spec-requirements's explicit prompt to consider non-functional requirements — accessibility chief among them for anything students will use directly — matters more in edtech than in most categories, both because compliance obligations are frequently real (many institutions have binding accessibility requirements) and because the population of students using a tool is unusually diverse in ability, device, and connectivity. Writing this down as an explicit requirement, not an assumed afterthought, is exactly what EARS-format requirements are built to make visible rather than implicit.

Investigation discipline for grading and assessment logic specifically

Any bug touching how a grade, score, or assessment result gets calculated deserves the same root-cause rigor fintech applies to money — because to a student, an incorrectly calculated grade carries real, if smaller-scale, stakes. "Probably an off-by-one in the rubric weighting" is not an acceptable place to stop investigating before shipping a fix that affects real students' recorded grades.

Product identity for tools built by people who won't maintain them forever

A product.md is disproportionately valuable for edtech specifically because the handoff to a new maintainer — a new hire, a different department, a contracted developer years later — is nearly guaranteed to happen eventually, often without much overlap with whoever built the original version. Writing down what the tool is for, who it's for, and what it deliberately doesn't try to do is the clearest gift you can leave the person who inherits it.

EdTech tools rarely get glamorous engineering attention for their entire lifespan. A workflow that produces good documentation as a side effect of normal development, rather than requiring separate dedicated effort, is what keeps them maintainable long after anyone's paying close attention.

Get the free field guide. A short, practical eBook walking through the whole workflow — the tier decision framework, the investigate-before-you-fix discipline, and how the approval gates hold up day to day.

Grab your copy →