Start here — Speaking forge
Still puzzling over what “quench” has to do with deploying a table?
SchemaSmith’s tools talk like a blacksmith’s shop — casting, quenching, kindling the forge. That’s on purpose. But if nobody tells you up front, the names get in the way of the work. So before you run a single command, let’s decode the language.
I’m Forge Barrett, and the smithy talk is mine. Here’s why it’s there: managing a database schema is smithing. You take something raw, you shape it, you harden it, and then you trust it under load. The metaphor isn’t decoration — every forge word maps to one exact thing the tools do. Learn the handful that matter and the rest of this course reads like plain English.
The short version
Section titled “The short version”Four words carry most of the weight:
- Forging is the whole job — shaping your schema and making it hold.
- Casting pulls an existing database into files you can edit and commit. That’s SchemaTongs.
- Quenching takes your declared schema and hardens it onto a live database. That’s SchemaQuench.
- Data delivery ships the rows that have to ride along — lookup tables, seed data, reference rows. That’s DataTongs.
Four words. Three tools. That’s the spine of everything ahead.
Why bother with the metaphor at all
Section titled “Why bother with the metaphor at all”Fair question. The honest answer: the names stuck because the work fits. You don’t write a schema change the way you’d write a one-off script and forget it. You shape a definition, you harden it onto every target that needs it, and you do it again next release without starting over. That’s a craft with a workshop, not a pile of migration scripts. Once the words click, they’re a shortcut, not a riddle.
When a word is new, check the Glossary
Section titled “When a word is new, check the Glossary”You’ll meet a few more along the way — kindle, jig, molds, adjustable dyes. Every one has a plain-English meaning and a place you’ll actually see it. They all live on the Glossary, and I’ll link there the first time each shows up. Nothing to memorize — just know where the decoder ring is.
Learn the four words above and the forge stops sounding like a foreign country. It starts sounding like your workshop.
Got a term that still isn’t landing, or a use case you’re chewing on? Email me at forgebarrett@schemasmith.com — I read every one.
Next up: Module 0 — Why declarative schema management, where we get into why declaring your schema beats hand-writing every change.
Until then, may the words on your anvil ring as clear as the work.
— Forge