The Problem

Having source code is not enough to maintain an arbitrary website. The agent must be able to obtain a working environment where the project actually runs and behaves predictably.

The existing MODX runtime already points in a useful direction: a specific technology can have its own runtime adapter while project management remains generic. However, it is not yet clear which part of this approach should become a common infrastructure contract.

What Needs to Be Understood

We need to define a minimal reproducible runtime description: which dependencies, services, versions, commands, and readiness indicators are actually required by the common platform, and which details should remain inside a specific project or adapter.

Docker looks like a natural means of unification and is already used in practice, but the task should not be prematurely reduced to a specific Docker Compose format. The important result is that the project can be predictably started, stopped, inspected, and restarted.

Related to universal connection of an existing project, state beyond source code, and the existing MODX runtime task.