diff --git a/pkg/README.md b/pkg/README.md
new file mode 100644
index 00000000..3aa989ff
--- /dev/null
+++ b/pkg/README.md
@@ -0,0 +1,3 @@
+The `pkg` directory is deprecated.
+Please do not add new packages to this directory.
+Existing packages will be moved elsewhere eventually.