diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..9070c112305394731781b9f7e98a49dc4a1cb5e5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# Tests pour SPIP
+
+Suite de tests basée sur PHPUnit, avec un wrapper pour les tests historiques écrits en script PHP standalone ou en squelette HTML
+
+## Installation
+
+```
+git clone https://git.spip.net/spip/tests.git
+cd tests
+composer install
+```
+
+## Lancer tous les tests
+
+Lancer
+
+```
+vendor/bin/phpunit --colors tests
+```
+
+Pour voir le détail de tous les tests lancés (y compris leurs noms)
+
+```
+vendor/bin/phpunit --colors --debug tests
+```
+
+
+Pour filtrer les tests et n'en executer que certains :
+```
+vendor/bin/phpunit --colors --debug tests --filter=unit/propre/
+```
+
+## Ajouter des tests
+
+TODO
+
+## Legacy
+
+Les tests historiques écrits sous forme de PHP ou de squelette HTML sont joués via les 2 composants `LegacyUnitHtmlTest.php` et `LegacyUnitPhpTest.php`
+
+Il est encore possible de lancer dans le navigateur la suite de tests legacy via l'url `monsite.spip/tests/` mais cette méthode est depréciée et ne lancera pas les tests écrits directement pour PHPUnit