# Protocol Independence

> A design rule that domain logic is written against ports, and each transport protocol reaches it through its own adapter.

Record: `architecture:protocol-independence`
Kind: principle
Layer: [Resource Core](https://banes-lab.com/records/layer/resource-core.md)
Severity: recommended
Scope: integration, service boundary
Canonical: https://banes-lab.com/ontology#architecture-protocol-independence

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Standards Compliance](https://banes-lab.com/records/architecture/standards-compliance.md) and before [Configuration Externalization](https://banes-lab.com/records/architecture/configuration-externalization.md).

## Repair

- Refactored by: Add Port, Add Protocol Adapter
- Detected by: protocol imports in core layer
- Violated by: HTTP/gRPC/etc. types in domain core
- Measured by: protocol leakage count
- Enforced by: import rules

## Requires

- [Adapter/Port Abstraction](https://banes-lab.com/records/lexicon/adapter-port-abstraction.md)

## Reinforces

- [Portability](https://banes-lab.com/records/architecture/portability.md)
- [Replaceability](https://banes-lab.com/records/architecture/replaceability.md)

## Enables

- [Protocol Swap](https://banes-lab.com/records/lexicon/protocol-swap.md)

## Conflicts with

- [Protocol-Coupled Domain Logic](https://banes-lab.com/records/lexicon/protocol-coupled-domain-logic.md)

## In tension with

- [Protocol-Specific Features](https://banes-lab.com/records/lexicon/protocol-specific-features.md)

## Tensions

- [Protocol Independence / Protocol-Specific Features](https://banes-lab.com/records/tension/protocol-independence-protocol-specific-features.md)

## Severity

- [recommended](https://banes-lab.com/records/vocabulary/severity-recommended.md)

## Category

- [Portability / Infrastructure / Deployment](https://banes-lab.com/records/architecture-category/portability-infrastructure-deployment.md)

## Linked from

- [Portability / Infrastructure / Deployment](https://banes-lab.com/ontology/principles/architecture-category-portability-infrastructure-deployment.md)
- [Core Modular Design](https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md)
- [Portability / Infrastructure / Deployment](https://banes-lab.com/ontology/lexicon/lexicon-category-portability-infrastructure-deployment.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)