Sep 8, 2024
Notes on Engineering Workflow
Thinking about how I approach technical work and systems thinking.
For a while, I was focused on just shipping features. It felt good to see things live, but I started to realize that the way I was building wasn't scaling well in my own head.
I found myself with too many scattered notes and too much context living only in my memory. This works when a project is small, but as soon as you hit real complexity—payments, admin workflows, infra changes—instinct isn't enough.
I decided to take a step back and look at how I actually work. I remember a specific incident where I spent three hours debugging a production database lockout, only to find a note I'd written to myself two months prior—buried in a random 'temp.txt' file—warning me about that exact concurrency edge case.
That was the turning point.
What was broken
The old way had predictable problems:
- project notes in random places
- decisions made without being written down
- repeated debugging of the same class of issues
- deployment steps remembered, not documented
- no clean bridge between building, learning, and publishing
The result was friction. Not glamorous friction. Just the slow drag that keeps good engineers from turning experience into systems.
What I wanted instead
I wanted a workflow that helped me do four things consistently:
- capture ideas before they disappear
- turn project work into reusable patterns
- document decisions while they are still fresh
- convert real engineering work into public proof
That last point matters. A lot of good engineers do strong work and leave no visible trail. Then later, when they want to show depth, they have to reconstruct everything from memory.
My new principles
Write while building
If something was important enough to figure out, it is important enough to note down. Not in a polished article immediately, but in a form I can reuse later.
Prefer systems over bursts of motivation
Motivation is unreliable. A repeatable flow for notes, docs, checklists, and case studies is much more useful.
Keep public output close to real work
I do not want generic content. I want posts, tools, and project pages that come directly from things I have actually wrestled with.
Think in terms of reliability
Even when working as a full stack engineer, the better question is often not “does this work?” but “what happens when this behaves badly?”
That mindset changes how you build.
What this means going forward
This workflow reset is not just about productivity. It is about identity. I want the way I work to reflect the kind of engineer I am becoming: someone who can build, operate, document, and improve systems with intent.
That means:
- clearer project timelines
- stronger documentation
- more architecture thinking
- better deployment discipline
- more deliberate public writing
Final thought
A lot of engineering growth comes from cleaning up invisible habits. This is one of those moments for me. I’m not rebuilding my workflow because things were impossible. I’m rebuilding it because the next level of engineering demands more structure than instinct alone can provide.