Design Philosophy

One Thing
Done Well

Small tools earn trust when their boundaries are clear.

There is always pressure for a useful tool to become a platform. Add dashboards, alerts, incidents, log search, traces, user management, workflow automation, analytics, and eventually the original idea is surrounded by everything it might one day touch.

OpenTrace starts from a narrower belief: background work should be able to explain what it is doing. That is the job. Accept operational events, preserve them, and make the current shape of the work visible.

Scope is a feature

A clear scope makes adoption easier. A team should not need to redesign its observability stack just to see whether an import is running, how far a scraper got, or which milestone a worker reached. The smaller the promise, the easier it is to test honestly.

Do not compete with everything

Logs, metrics platforms, exception trackers, and infrastructure dashboards already solve important problems. A focused tool does not need to replace them. It can sit beside them and answer the question they were not primarily built around: what is this operational process doing right now?

Depth beats breadth

Doing one thing well means spending attention on the shape of that thing. Events should be easy to emit. Payloads should be readable. Progress should be obvious. The path from a running job to a useful status view should stay short.

The useful constraint

The constraint is not a lack of ambition. It is the product boundary. OpenTrace is more valuable if it remains easy to understand, easy to run, and easy to remove than if it tries to become the centre of every operational workflow.