Keeping small Java utilities maintainable
Small Java utilities have a habit of outliving their original purpose. If they solve one annoying problem well, they stick around.
That is why I try to keep them easy to read: obvious entry points, small config surfaces, clear naming, and a short README that says what the tool is for before it says how it works.
I don’t mind small rough edges in personal tools. I do mind mystery. Readability is what lets a tiny utility stay useful six months later.