Diversio Engineering
Systems

Systems behind the tools

Workflows, stack choices, guardrails, and design decisions behind Diversio Engineering.

Stack

The stack behind the work

The technologies and foundations we rely on, organized by the part of the engineering system they support.

Application stack

Django, Python, React, TypeScript, and PostgreSQL at the product layer

The core application stack favors mature backend ergonomics, typed frontend workflows, and a relational data model that holds up under product complexity.

Why it fits: This combination gives us a practical balance of shipping speed, reviewability, and long-lived application maintainability across backend and frontend work.

Django
Python
React
TypeScript
PostgreSQL
Design and UI foundation

A shared design system and design workflow keep product surfaces aligned

Frontend work sits on top of a shared design system, with design exploration and implementation moving through the same reusable component language instead of one-off page decisions.

Why it fits: A durable UI layer improves consistency, keeps review conversations focused on behavior instead of re-litigating presentation from scratch, and lowers the cost of iteration across multiple product surfaces.

Diversio Design System
Figma
React
TypeScript
Platform and infrastructure

AWS, Terraform, and Terragrunt keep infrastructure repeatable

Infrastructure is treated as part of the engineering system, with managed cloud primitives, infrastructure as code, and orchestration that stays legible across many stacks and environments.

Why it fits: The goal is not novelty. It is repeatability, safer change management, and infrastructure work that can be reasoned about with the same care as product code.

AWS
Terraform
Terragrunt
Delivery and automation

GitHub Actions and CircleCI automate the delivery paths that need to stay boring

CI and release automation are part of the operating model, not afterthoughts. Different repositories lean on different automation surfaces depending on how they deploy and what they need to validate.

Why it fits: Keeping build, packaging, and deployment paths explicit makes change safer, easier to audit, and easier to recover when something drifts.

GitHub Actions
CircleCI
Also in this layer
GitHub
Data and analytics

Product analytics and event contracts matter because instrumentation is part of the product

Analytics work is treated as a real engineering surface, not a bolt-on. Events, data flow, and implementation patterns need to stay clear enough that teams can trust what gets measured.

Why it fits: Instrumentation is only useful when it stays close to the product behavior it describes and when engineers can evolve it without turning the data model into folklore.

Mixpanel
PostgreSQL
Developer environment

cmux, Zed, Pi, Docker, and flexible local tooling keep daily work moving

Daily engineering work depends on more than the application stack. Editors, terminals, local containers, remote sandboxes, and quick connectivity tools all affect how quickly an engineer can understand a problem and move through it.

Why it fits: We embrace open tools that reduce friction in the daily loop: editor choices that stay fast, terminal workflows that make session handoff easier, sandboxes that isolate risky work, and connectivity tools that help expose or test systems without heavyweight setup. cmux has become the primary daily driver in that environment, with Ghostty still very much in the mix.

cmux
Zed
Pi
Docker
sandboxes.cloud
ngrok
Also in this layer
Ghosttytmuxnvm
Workflow and publishing tooling

Bruno, Astro, uv, Ruff, and agentic tooling support the way we ship

We invest in tools that improve context recovery, review quality, API visibility, and the speed at which repeated engineering work becomes reusable instead of staying trapped in local setup.

Why it fits: Open-source tooling earns its place when it makes daily engineering work simpler, easier to review, and easier to share across the team. Docs, request definitions, local workflow tools, and agentic helpers all benefit from staying close to the code they support.

Bruno
Astro
uv
Ruff
Agentic Tools
Related writing →
Exploration and analysis

Google Colab, Jupyter notebooks, and IPython help us work through messy problems quickly

Not every useful engineering task starts as product code. We also lean on notebooks and interactive Python workflows for one-off analysis, data shaping, exploratory debugging, and validating ideas before they harden into more permanent tooling.

Why it fits: These tools reduce friction when the job is to inspect, experiment, or explain a problem clearly. We treat them as practical companions to the main stack, not as second-class workflows.

Google Colab
Jupyter
IPython
Python

Developer Experience

2 highlights in this area.

01

A multi-repo workspace that reduces context switching

A unified local workspace, branch-aware worktrees, and shared tooling make it easier to move across product, platform, and tooling work without losing context.

Why it matters

The monolith story and the open tooling docs both reflect the same principle: engineering context should be cheap to recover.

Related writing →
02

Performance work measured before it is celebrated

CI and workflow improvements are treated as engineering changes that should be baselined, measured, and explained rather than justified by instinct alone.

Why it matters

Writing and utility docs already reflect a measurement-first posture for CI, delivery, and developer-experience changes.

Related writing →

Security

1 highlight in this area.

01

Workflow security treated as code, not paperwork

GitHub Actions are reviewed as executable infrastructure, with dedicated guardrails that keep workflow changes pinned, auditable, and easier to trust.

Why it matters

The workflow-security docs make the operating model easy to inspect, discuss, and reuse.

Agentic Tooling

1 highlight in this area.

01

Review flows that preserve context across passes

Agentic review tools, wrapper commands, and review memory help reviewers focus on what changed instead of re-reading the same history from scratch.

Why it matters

Marketplace plugins already expose the reusable pieces of this workflow, including review orchestration and structured review memory.

Browse the tooling →

Documentation

1 highlight in this area.

01

Docs written for operators, not just for marketing

Short routing docs, deeper runbooks, and first-principles explanations turn repeated engineering pain into reusable system knowledge.

Why it matters

The tools repo already uses repo-local docs, generated deep-doc pages, and a strong “why this exists” style.

Read the docs model →

Product Systems

1 highlight in this area.

01

API workflows anchored in source-controlled request definitions

Request collections, docs generation, and reviewable API workflows are kept close to the code so interfaces can evolve with better visibility and less drift.

Why it matters

The Bruno API plugin and related writing show the shape of this approach in the open.

Related writing →