diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..ba5446d73685c53ea81b6609ca8bb2a078e9f436
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# irstea/phpstan-config
+
+Configuration pour phpstan/phpstan.
+
+Inclut les extensions PHPStan pour les outils suivant :
+
+- Doctrine
+- Symfony
+- PHPUnit
+- [beberlei/assert](https://github.com/beberlei/assert)
+- [phpspec/prophecy](https://github.com/phpspec/prophecy)
+
+### Installation
+
+```shell
+composer require --dev irstea/phpstan-config
+```
+
+### Configuration
+
+Exemple :
+
+```neon
+includes:
+    - vendor/irstea/phpstan-config/phpstan.neon
+
+parameters:
+    paths:
+        - src
+        - tests
+
+    symfony:
+        container_xml_path: %currentWorkingDirectory%/var/cache/test/srcApp_KernelTestDebugContainer.xml
+
+```
+
+cf. https://github.com/phpstan/phpstan#configuration pour plus de détails.
+
+### Usage
+
+```shell
+vendor/bin/phpstan analyse
+```