diff --git a/docs/bugpattern/RethrowReflectiveOperationExceptionAsLinkageError.md b/docs/bugpattern/RethrowReflectiveOperationExceptionAsLinkageError.md
new file mode 100644
index 00000000000..95e51d1db6e
--- /dev/null
+++ b/docs/bugpattern/RethrowReflectiveOperationExceptionAsLinkageError.md
@@ -0,0 +1,3 @@
+Consider using `LinkageError` instead of `AssertionError` when rethrowing
+reflective exceptions as unchecked exceptions, since it conveys more information
+when reflection fails due to an incompatible change in the classpath.