MUGGSOFCODE
// BUILD_TOOL //

A spec-driven code generation sandbox.

MuggsOfCode.net is a spec-driven code-generation sandbox built for a high-school CS course:

  1. Students write a four-section markdown specification (project, structure, style, behavior).
  2. A small local language model running on a single classroom GPU (currently in my living room) synthesizes a single-file HTML page from it.
  3. Students then read the generated code, write their own comments explaining it, and iterate.
  4. The student modifies the code either by tweaking the code directly or revising the spec and regenerating.

The curriculum's whole point is teaching the most transferable AI-coding skill: expressing intent precisely enough that anyone (a person, a model, or future-you) can produce the right thing from it.

By design the AI is a critic and an interviewer, never a co-author. The AI asks Socratic questions about the spec, reviews it for vague language, and checks the student's own comments for accuracy, but it will not pick a design choice, write a comment, or fix any code.

The infrastructure twist matters pedagogically too: the deliberately small local model has less slack than a frontier API, so vague specifications produce visibly weaker output, and the gap itself teaches precision.

Chats are disposable, Specs are durable.