diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000000000000000000000000000000000000..15f10fa1bef29f371110ca3d159193076713f8a6
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,23 @@
+# Contributing to Moore
+
+Contributions to Moore are accepted in the form of merge requests. Code should
+conform to the C++ and Python formatting standards define by the CI. The
+checker will run automatically when you push new commits to your branch, and
+will generate a patch you can apply if the checks fail.
+
+To simplify the workflow, you can format and lint locally using
+
+```shell
+lb-format path/to/file
+flake8 path/to/file
+```
+
+Check [Git4LHCb](https://twiki.cern.ch/twiki/bin/view/LHCb/Git4LHCb) for more details.
+
+## Branches
+
+The `master` branch is used for Run 3 development and data-taking. This is the
+usual branch to open merge requests against.
+
+Some other branches track code from previous campaigns. Open an issue if you're
+unsure what branch to use.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..4f6f2d40d81e9dbc43ac983e21d6e9ce643cf21a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Moore
+
+Moore is the application for the LHCb high level trigger (HLT). This repository
+contains the application configuration code, including the definition of the
+HLT1 and HLT2 reconstruction and physics selections (lines). Reconstruction-
+and selection-specific algorithms are mostly defined in the
+[Rec](https://gitlab.cern.ch/lhcb/Rec) and
+[Phys](https://gitlab.cern.ch/lhcb/Phys) projects.
+
+Information on contributing to Moore is given in the [CONTRIBUTING
+file](CONTRIBUTING.md).