Guides  /  Rollout and delivery

How do you onboard a developer with no distributed-systems background?

Answer

A developer building on Akka writes the agent, the workflow and the endpoint. Clustering, failover, data sharding, retries and traffic steering are handled by the runtime underneath that code.

The distributed-systems behaviour is a property of the Akka runtime. A developer without that background ships on the same foundation a specialist would build on.

The mechanism

The experience gap shows up in production behaviour.

Writing an agent that answers a question is within reach of any developer. The work that follows separates a prototype from a service. A node dies part way through a run. A downstream call times out. One customer sends more requests than the service was sized for.

Each of those has an answer that a distributed-systems specialist knows and a developer new to the field does not. A team without that experience finds the answers in production.

What the runtime supplies

The behaviour a specialist would hand-build is already running.

Clustering and failoverNodes join and leave, and work is placed on healthy nodes. No developer writes the membership logic.
Durable stateState is written to an event journal as it changes and replayed after a restart, so a run resumes at its last completed step.
Retries and backpressureA slow consumer slows its producer, and a failed step retries against a record of what already executed.
Sharding and traffic steeringState is partitioned across the cluster, and a request reaches the node holding the state it needs.

Temporal, trigger.dev and LangGraph make durability an explicit programming model, where a developer declares retry policies and structures the code to opt in. On Akka a developer receives retries, backpressure, throttling, circuit breakers, durable memory and execution checkpointing by running on the runtime. Akka also provides the explicit model, through workflows and sagas, when a developer wants it.

What this changes

Delivery stops depending on who is available.

An organisation short of distributed-systems engineers routes every agentic project through the few it has. The specialist group becomes the queue every team waits in, and its capacity sets how many systems the company can run.

Golden paths and spec-driven development remove that dependency. Dojo put AI-based merchant onboarding into production in weeks, built by college graduates. Manulife rolled Akka out to 2,000 developers across 6 countries under central risk control.

Questions

Related questions.

What does a developer still have to learn?

A developer learns the component model, which covers agents, workflows, entities, views, endpoints, timers and consumers. Choosing which component carries behaviour and which carries state is the design work, and the runtime supplies what happens to each under failure.

Does the runtime hide problems a developer should understand?

Tracing, eval checkpoints and agent analysis show what the runtime did with a run. A developer learns the failure model from a system that is already handling failure correctly.

How soon does a first production slice ship?

Akka consulting engagements set the first production slice at 4 to 6 weeks. The slice includes the deployed service, its runbook, its cutover plan, and the alerts and dashboards that operate it.

Do senior engineers become unnecessary?

Senior engineers keep the design decisions: what the system is for, which components carry which state, and where a person has to approve an action. The runtime removes the infrastructure work under those decisions.

Does this apply to a team already running agents on a framework?

A framework accelerates the prototype. Clustering, resilience, identity, governance, evidence and multi-region failover are the work that remains, and those are the parts the Akka runtime supplies.

On Akka. Clustering, durable state, sharding and traffic steering are described in the Akka SDK documentation. Customer figures. Dojo and Manulife results are reported by those customers.