Build. Deploy.
Simplify.
A small space for engineering notes,
cloud infrastructure and developer tools.
Thoughtful systems.
Useful tools. Clear notes.
01 / AREAS OF EXPLORATION
Small ideas. Practical work.
Three directions, one approach:
make the complex easier to work with.
Cloud Infrastructure
Practical notes on modern cloud architecture and operations.
Start with the fundamentalsDeveloper Tools
Small utilities designed to simplify everyday engineering work.
Explore the approachExperiments
Exploring new ideas across systems, networks and software.
Follow the process02 / ENGINEERING NOTES
A few things worth keeping.
Short reads on building with intention.
Select a note to read it here.
INFRASTRUCTUREStart with a system you can explain.
A useful architecture starts with a clear request path. Write down where a request enters, what handles it, and where the response comes from. If that description is difficult to follow, the system may be carrying more complexity than it needs.
Give every component a purpose. Keep configuration changes small, record the previous state, and decide how to verify the result before making a change. A repeatable process is often more valuable than another layer of infrastructure.
Keep the path clear. Make changes reversible. Check the result.
DEVELOPER TOOLSMake the repeated task the easy task.
A good small tool solves a task you can describe in one sentence. Start with something repeated: formatting a file, checking a response, or comparing two configurations. Make the input obvious and the output easy to inspect.
Handle missing input clearly, report failures honestly, and document one working example. Keep the first version narrow enough to understand in a single reading. Add options only when a real use case calls for them.
One clear purpose is a strong starting point.
EXPERIMENTSChange one thing. Learn something useful.
Before an experiment, write down the question and what you expect to observe. Capture a baseline, change one variable, and compare the result under similar conditions. Keep enough context to repeat the experiment later.
A result that contradicts the initial idea is still useful. Record what happened, what remains uncertain, and which question to test next. Small, documented experiments turn a collection of guesses into a body of understanding.
A clear question makes even a small experiment worthwhile.
03 / ABOUT ZSH CODE
Stay curious.
Keep it simple.
ZSH Code is a personal space for exploring how software is built, deployed and maintained.
It brings together engineering notes, ideas for useful tools and small experiments. The focus is on understanding the fundamentals and making everyday work a little clearer.