← Journal

Design reversibility before publishing the procurement

Reversibility becomes real when it is described as an operable, tested, and funded capability.

Public procurementArchitectureReversibility

Reversibility is not an exit clause

In many digital projects, reversibility appears late. It becomes a contractual paragraph promising the return of data and documentation at the end of the engagement. That promise matters, but it is insufficient. An unusable export, unmaintained documentation, or a procedure that has never been exercised can satisfy the wording while making a transfer impossible in practice.

Reversibility should be designed as a capability of the system. It describes how another team can understand, operate, change, and when necessary replace the service without relying on tacit knowledge held by the outgoing supplier.

Define what must remain under control

Before publication, the buyer can map the elements it must continue to control. The list goes beyond source code. It includes data, business rules, architectural decisions, deployment chains, secrets, access rights, operating procedures, and the useful history of incidents.

Four questions make each requirement testable:

  1. in what format is the asset delivered;
  2. how often is it updated;
  3. who can verify that it is complete;
  4. what operation proves that it can be reused.

This framing prevents decorative inventories. Documentation is not available merely because a repository exists. It is available when someone who did not build the system can complete a defined task by relying on it.

Separate assets, access, and capability

Transfers often fail because three different subjects have been merged. Assets are the elements being handed over. Access is the set of permissions required to use them. Capability is the practical ability to understand and operate the whole.

A code repository without decision history is an incomplete asset. An administrator account without a rotation procedure is fragile access. A single training session at the end of a contract does not create durable capability. Procurement material becomes clearer when these dimensions have separate evidence and accountable owners.

Put evidence into the delivery rhythm

Waiting for the final weeks to test reversibility turns exit into an emergency project. A stronger approach asks for regular evidence throughout delivery. Examples include restoring a service into a neutral environment, rebuilding a component from automation, exporting and reimporting representative data, or having the receiving team perform an operational procedure.

These exercises should not become heavy theatre. Their value comes from frequency and proximity to real work. They expose implicit knowledge, proprietary dependencies, and operations that are not truly automated while there is still time to address them.

Fund the exit

Reversibility has a cost. Maintaining documents, keeping environments reproducible, organising access, and supporting another team all take time. If that effort is neither estimated nor planned, it becomes residual work and loses against visible features.

The commercial model should make transfer possible without creating contradictory incentives. It may distinguish continuous preparation, evidence exercises, and a potential transition period. The point is not to prescribe one arrangement. It is to make responsibilities and costs discussable before they become urgent.

Evaluate capability rather than promises

During evaluation, useful responses describe an observable method: artefacts, update frequency, evidence environments, named roles, and acceptance conditions. A general statement of compliance says little about the actual ability to transfer a service.

The question is not only, “What will the buyer receive at the end?” It is also, “What could the buyer take over today, with which team, in how many steps, and with what evidence?”

Designed early, reversibility does more than prepare for a break. It improves the daily quality of the system. Dependencies become visible, decisions remain documented, and the organisation preserves its ability to arbitrate throughout the engagement.