Vendor-neutral agent architecture
Retain architectural choices when agent vendors or protocols change
A platform decision risks binding workflow logic to one vendor's conventions. The decision is how to retain architectural choices when agent vendors or protocols change. The work begins with your actual workflow and looks for the evidence that separates intended behaviour from a consequential exception. It is particularly relevant to enterprise architects and sourcing stakeholders. A useful outcome is an explicit account of what was examined, what remains uncertain, and which decision the evidence can support.
The interaction contracts relationship
- Dependency maps
Establish the basis for stable contract.
- Necessary adapter
Name the implementation-specific behaviour retained.
- Vendor-neutral architecture proposal
Retain the scoped finding and its unresolved dependencies.
Decision
Frame the decision around stable contract
Questions and the evidence they need
- Stable contract
- Inspect dependency maps for the relevant constraint or observation.
- Necessary adapter
- Inspect interface contracts for the relevant constraint or observation.
- Exit exercise
- Inspect data export routes for the relevant constraint or observation.
The decision is how to retain architectural choices when agent vendors or protocols change. This is relevant to enterprise architects and sourcing stakeholders when a platform decision risks binding workflow logic to one vendor’s conventions. Name the affected workflow, the consequence of a wrong decision, and the owner who can act on the result. The initial discussion should establish which evidence is already available and which uncertainty is material enough to investigate.
The specific failure hypothesis is that business rules become embedded in proprietary orchestration features with no documented alternative. It remains a hypothesis until examined in the deployment. Existing internal tests or operating records may already resolve it; identify the uncovered question before commissioning additional work.
Mechanism
Portability needs explicit vendor-specific boundaries
Relationships within interaction contracts
- Stable contract
- Separate business meaning from supplier interfaces.
- Necessary adapter
- Name the implementation-specific behaviour retained.
- Exit exercise
- Check replacement and evidence-export dependencies.
What this specialty examines
Vendor-neutral architecture should identify the decisions the enterprise wants to retain. Separate business contracts, data ownership and approval rules from vendor-specific adapters where useful. Portability has boundaries; some specialized features may remain deliberate dependencies.
The review should identify portable contracts, necessary vendor-specific adapters and realistic exit scenarios. Identify the normal route, relevant exceptions and the authoritative record of the outcome. Inspect the relevant business-system record, enforcement event or process evidence alongside any reported status. Keep incomplete cases visible, with an explanation of what their absence prevents the owner from concluding.
The tradeoff to make explicit
For this decision, abstraction preserves options while unnecessary abstraction adds cost and can obscure useful features. Compare the available design or operating choices against the same intended outcome. If one option removes a required control or changes the task boundary, describe that difference before treating its apparent simplicity, speed or lower effort as an improvement. The decision should expose the tradeoff instead of burying it in an aggregate score.
Preparation
Connect the working inputs to the boundary being examined
Evidence packet for stable contract
Illustrative working format
- Dependency maps
- Match this description to the deployed or proposed boundary being examined.
- Interface contracts
- Fix the participating revisions, task semantics, and unsupported combinations.
- Data export routes
- Establish permitted access, provenance, and which task conditions it represents.
- Operational requirements
- Confirm the applicable revision and who resolves disputed interpretation.
Start with dependency maps, interface contracts, data export routes and operational requirements. Identify the owner, revision and operating context of each source. Sanitised examples may support initial design, but differences from actual conditions should remain explicit. Where direct access is unsuitable, a customer-controlled evidence or execution route may be considered, with agreed handling and retention.
The scope also needs the integration owner, agreed expectations for a representative interaction case, and the authority to inspect the relevant boundary. Specify what evidence would distinguish the failure in which business rules become embedded in proprietary orchestration features with no documented alternative from acceptable behaviour. If stakeholders disagree about intended behaviour, resolve the interpretation before classifying the observed difference as a defect.
How the work proceeds
Carry stable contract through to an accountable finding
From the scoped material to a decision record
- Dependency maps
Agree the task meaning at the sending boundary.
- Necessary adapter
Apply the scoped check to exit exercise.
- Vendor-neutral architecture proposal
Record the evidence, open dependencies, and the owner’s next decision.
Fix the interaction contract and versions
Assemble dependency maps, interface contracts, data export routes and operational requirements with enterprise architects and sourcing stakeholders. Identify the participating implementations, interface revisions, authority assumptions and intended business result. Prepare messages and task-state examples from both sides, including an interrupted exchange and a disputed or incomplete outcome. The preparation output is a paired contract fixture showing what each participant expects and which differences would prevent the workflow from completing correctly.
Run and compare both sides of the exchange
Evaluate a realistic replacement scenario rather than claiming abstraction alone guarantees exit. Inspect exportable evidence, configuration, identity and operating procedures. Document which components would need rebuilding and which contracts remain stable.
Choose the contract or integration change
Summarise the comparison in a vendor-neutral architecture proposal with portability boundaries and migration dependencies. Classify each mismatch as interface validation, business meaning, identity, task state or operating behaviour. Decide whether to change a participant, add an explicit adapter rule, narrow supported combinations or defer the connection. Validate the affected pair again and preserve limitations that translation cannot resolve, especially around cancellation, authority and partial completion.
Indicative artefact
Make the vendor-neutral architecture proposal usable by its owner
Vendor-neutral architecture proposal
Illustrative working format
- Vendor-neutral architecture proposal
- Identify the assessed workflow, revision, and decision boundary.
- Portability boundaries
- Link supporting and contrary observations to inspectable evidence.
- Migration dependencies
- Name the missing evidence, responsible owner, and condition for revisiting the decision.
A useful decision artefact is a vendor-neutral architecture proposal with portability boundaries and migration dependencies. Supporting material may include selected cases, configuration or process records, evidence references, a disagreement log and prioritised actions. Retain the case selection rationale and material disagreements alongside the result; otherwise the result may be mistaken for complete coverage.
Illustrative scenario
Examine exit exercise through a constructed exception
A constructed case and its decision paths
Illustrative scenario
- Stable contract
Replacing a provider exposes an undocumented dependency in the task-state model.
- Necessary adapter
Exercise a replacement provider against the business task contract.
- Exit exercise
Document the adapter dependency and portability limit exposed by the change.
Consider a fictional situation: an enterprise wants to replace an agent provider but discovers approval logic exists only inside that provider’s workflow designer. The scenario is illustrative, with no client engagement, executed test or measured improvement implied.
For proprietary approval logic, consider whether the authoritative rule can live in an enterprise-controlled service. The vendor may still orchestrate work around it. That choice preserves an important decision boundary without requiring every feature to be vendor-independent.
Scope and next action
Keep the conclusion within named implementations and revisions
Confirm fit before the next commitment
- Stable contract
- This review is limited to named implementations and revisions.
- Dependency maps
- The relevant owner must confirm access and the intended operating conditions.
- Vendor-neutral architecture proposal
- Untested peers require their own compatibility evidence.
Compatibility is assessed for named implementations, versions, features and workflows. It does not establish universal conformance, vendor endorsement or interoperability with untested peers. Any engagement depends on an agreed scope, qualified team, authorised access and confirmed availability. Bring the affected workflow, its current configuration or process, the triggering change and the evidence already available. The immediate scope question is prompted by the situation in which a platform decision risks binding workflow logic to one vendor’s conventions; confirm which missing observation would change the owner’s next action.
Ways to engage
Related engagement scopes
AI Agent Protocol Interoperability Lab
Find where connected agents disagree. Exercise message contracts, identity propagation and failure recovery across your selected integrations.
Continue exploring
Related insights and resources
How to design a joint AI evaluation lab
A joint lab should be a governed way to create decision evidence across organisations, with shared methods but explicit ownership of systems, data and conclusions.
Agent protocols are creating a new control surface
Protocols make tools and agents interoperable, but they also standardise discovery, delegation and context exchange. Those interfaces need explicit trust and policy controls.
A practical security review for an MCP server
Review an MCP server as a privileged protocol adapter: verify tool semantics, OAuth boundaries, token audience, downstream delegation, input handling, isolation, logging and consent.