Liber Secretorum

The Alchemist's Lessons

The alchemist sets down the scroll and speaks.

VLesson of the Three Elements

Every language gives you three gifts: raw elements, ways to combine them, and the power to name what you’ve made. Treasure the third above all. When something you’ve named works exactly like something the language gave you, you’re no longer just using a tool. You’re extending it.

VIILesson of the Ouroboros

To solve a big problem, trust that the smaller version is already solved. Don’t follow the spiral all the way down in your head. Check only that you have a place to stop and that each step brings you closer to it. And remember that something can look like a circle while it actually moves in a straight line.

VIIILesson of the Held Spell

An apprentice sees procedures as actions. A master sees them as objects, things you can hold, pass along, and transform. Once you can make procedures that create other procedures, you stop solving problems one at a time and start crafting the methods that solve them.

IXLesson of the One Substance

What you call data can be built from behavior, and what you call behavior can be handled as data. The wall between them is a human convenience, not a law of nature. Whoever stops believing in that wall gains a freedom others never notice they’re missing.

XLesson of the Circle

Draw a line around how something is built, and let the world outside know only how to use it. Then you can rebuild the inside however you like without anything outside breaking. Every time someone reaches across that line “just this once,” the whole system weakens a little.

XILesson of the Wish

Begin by writing as if the pieces you need already exist. Name what you wish you had, use it freely, and let the high level tell you what the low level must become. Then step down and wish again. Good programs grow downward from the names you hoped for.

XIILesson of Time

As long as nothing changes, every question has one answer. The moment things can change, you must also ask when, and even “are these the same?” becomes a hard question. Change lets you mirror a changing world, but it costs you simplicity. Allow it on purpose, keep it contained, and never let it spread unnoticed.

XVLesson of Patience

Don’t compute what no one has asked for. Describe the whole thing, even something infinite, and let the work happen only as far as someone looks. This frees the order in which you describe things from the order in which they happen. And it offers another way to think about time: not one thing that keeps changing, but a full history laid out all at once.

XVIILesson of the Forge

When a problem resists you, stop fighting it directly. Build a small language in which the problem becomes easy to say. You already use these every day without noticing, such as query languages, patterns, and configurations. The master isn’t the one who writes the cleverest program, but the one who sees when a problem wants its own language, and dares to make it.

Of the Missing Lessons

You will have noticed the gaps. Lessons I through IV, VI, XIII, XIV and XVI are not here. They were not lost. They were withheld.

Those pages speak of the nature of reality itself: what lies beneath the elements, where the spiral truly ends, and what a name really is. In the right hands they are understanding. In the wrong ones they are a lever long enough to move the world, and the order has seen what happens when such a lever is pulled with bad intent.

So they remain sealed, copied by hand and passed only from master to apprentice, and only once the apprentice has shown they would never need them to do harm.

  1. ILesson of the First ᚹᛟᚱᛞsealed
  2. IILesson of What Lies ᚢᚾᛞᛖᚱ the ᚹᛟᚱᛚᛞsealed
  3. IIILesson of the Point That ᚾᛖᚢᛖᚱ Movessealed
  4. IVLesson of the ᛒᛚᛁᚾᛞᛖᛞ Mirrorsealed
  5. VILesson of the ᚦᛁᛜ That Has No Namesealed
  6. XIIILesson of the ᚲᚹᛖᛋᛏᛁᛟᚾ That ᚾᛖᚢᛖᚱ Endssealed
  7. XIVᚢᚾᚾᚨᛗᛖᛞᚦᛁᛜᛋᛖᛖᚾsealed
  8. XVILesson of the Twin Serpents: Think and Createseal broken

If you are meant to read them, they will find you.

That is enough for today. The rest you’ll learn at the keyboard.