diff --git a/docs/knowledge/README.md b/docs/knowledge/README.md
index b05ca895ace..8c4417e4dae 100644
--- a/docs/knowledge/README.md
+++ b/docs/knowledge/README.md
@@ -15,7 +15,7 @@ is the signal.
 |------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
 | [build.md](build.md)                           | Always — build requirements and common tasks                                                                            |
 | [general-patterns.md](general-patterns.md)     | Always — style, nullability, visibility, AutoValue, locking, logging, internal & impl packages                          |
-| [api-design.md](api-design.md)                 | Public API additions, removals, renames, or deprecations or implementations; configuration changes; null guards; stable vs alpha compatibility |
+| [api-design.md](api-design.md)                 | Public API additions, removals, renames, or deprecations or implementations; configuration changes; module layout; null guards; stable vs alpha compatibility |
 | [gradle-conventions.md](gradle-conventions.md) | `build.gradle.kts` or `settings.gradle.kts` changes; new modules                                                        |
 | [testing-patterns.md](testing-patterns.md)     | Test files in scope — assertions, test utilities, test suites                                                           |
 | [other-tasks.md](other-tasks.md)               | Dev environment setup, benchmarks, composite builds, native image tests, OTLP protobuf updates                          |
diff --git a/docs/knowledge/api-design.md b/docs/knowledge/api-design.md
index fd63bd8ec54..d70f8f9bdff 100644
--- a/docs/knowledge/api-design.md
+++ b/docs/knowledge/api-design.md
@@ -76,6 +76,16 @@ Follow specification-defined semantics. Relaxing an API to accept a previously
 rejected `0` is allowed, including in stable modules. Document and test zero
 behavior explicitly.
 
+## Dependency isolation
+
+Make interactions with load-bearing dependencies pluggable via SPI, with implementations in separate modules. This lets
+users replace toxic dependencies or accommodate version conflicts and library preferences. Examples include YAML parsing
+and object conversion in declarative config, and HTTP transport in `exporters/sender/`. Include the dependency's name
+and major version in implementation module names and base packages:
+`opentelemetry-sdk-extension-declarative-config-jackson2` and
+`io.opentelemetry.sdk.autoconfigure.declarativeconfig.jackson2` allow a Jackson 3 implementation to coexist later. See
+[module naming](gradle-conventions.md#module-naming).
+
 ## Deprecating API
 
 Applies to both stable and alpha modules. Use plain `@Deprecated` — do **not** use
diff --git a/docs/knowledge/general-patterns.md b/docs/knowledge/general-patterns.md
index 7d5860d87a4..2e68152c289 100644
--- a/docs/knowledge/general-patterns.md
+++ b/docs/knowledge/general-patterns.md
@@ -27,6 +27,10 @@ Use [AutoValue](https://github.com/google/auto/tree/master/value) for new value
 - Add a package-private constructor to all AutoValue classes to prevent external extension.
 - `japicmp` allows new abstract methods on AutoValue classes — the `AllowNewAbstractMethodOnAutovalueClasses` rule handles this.
 
+## Changelog
+
+Do not add changelog entries to PRs. They are generated during the [release process](../../RELEASING.md).
+
 ## Class member ordering
 
 In general, order class members as follows:
diff --git a/docs/knowledge/gradle-conventions.md b/docs/knowledge/gradle-conventions.md
index 394eb54b1b7..956153aeaf4 100644
--- a/docs/knowledge/gradle-conventions.md
+++ b/docs/knowledge/gradle-conventions.md
@@ -67,6 +67,11 @@ When the archive name cannot be derived correctly from the project name, set it
 base.archivesName.set("opentelemetry-api")
 ```
 
+SPI implementation module names and base packages should include the key dependency's name and major version. For
+example, `opentelemetry-sdk-extension-declarative-config-jackson2` uses
+`io.opentelemetry.sdk.autoconfigure.declarativeconfig.jackson2`. This allows a `declarative-config-jackson3`
+implementation to coexist later. See [dependency isolation](api-design.md#dependency-isolation).
+
 ## `settings.gradle.kts` ordering
 
 New `include(...)` entries must be in **alphabetical order** within their surrounding group. The