diff --git a/local_upgrade.md b/local_upgrade.md
new file mode 100644
index 0000000..82c89f1
--- /dev/null
+++ b/local_upgrade.md
@@ -0,0 +1,3 @@
+linter-coffeelint will prefer to use the version of CoffeeLint you have installed in your project (`npm install --save-dev coffeelint`).
+
+If you've been directed here it means your local coffeelint is in some way incompatible with linter-coffeelint. You need to upgrade with `npm install --save-dev coffeelint@latest`