Talk it through with Aurelius
Library›Aurelius›The problem
Aurelius · Work & Leadership
Knowledge + Guidance

My code works, but is it actually good?

You wrote code. It runs. You call this done. But done and good are not the same thing — you have only tested the first. Here is what you are avoiding: quality is not a feeling, it is a set of concrete checks. Can someone else read this without asking you questions? Can you change one part without breaking three others? Does it fail loudly when it should, instead of silently? If you have not asked these questions, you have not actually evaluated your work — you have only confirmed it compiles. This is not a mystery reserved for senior engineers. It is a discipline you have not yet practiced. Stop waiting to be told the standard. Go find one piece of your own code and hold it to these questions today.

◆ How this problem reads on the two dials
GuidanceKnowledge
Coaching
More to learn
1:1 with AureliusWith others (a Pod)
Mostly you & the coach
A little with peers
The person lacks a concrete definition of quality, so teaching comes first; but the gap closes only through practiced review on their own code.
How the two dials adapt to you →
What’s really going on

It works is the lowest bar. Quality means a stranger can read your code, change it without fear, and trust it still runs correctly after. If you cannot say that about your code, you have your answer — and your next action: pick one file, and make it readable by someone who is not you.

🔒 What you’ll build togetherUnlock by starting
A moveOpen one file you wrote last week. Read it as if you have never seen it. Mark every spot where you had to stop and think.
A movePick the ugliest function in your project. Rewrite it so a stranger could understand it in under a minute. Nothing else — just that one function.
A moveBefore your next commit, ask: if this breaks at 2am, will the error tell me why? If not, add that now.
A moveWrite down, in one sentence, what 'good' means for this specific project. Not in general — for this one. Check your next piece of code against that sentence.
A moveFind one piece of code you are proud of. Explain out loud why it is good. If you cannot explain it, you do not yet know — go learn the reason.

What changes unlock by starting

  • A concrete, personal definition of code quality — not a vague feeling of 'good enough'
  • The habit of rereading your own code as a stranger would, before calling it finished
  • At least one piece of code actually improved by applying a quality check, not just rewritten at random
  • Less dependence on others to tell you whether your work is solid
One object, two jobs: a public answer to a real problem, and — the moment you start the chat — Aurelius’s live plan for your version of it.