diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7ddc655
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# Hcal
+
+Digi emulation, reconstruction, veto, and (some) analysis code for the Hcal subsystem of LDMX.
+
+**Note** This code currently cannot be built independent of [ldmx-sw](https://github.com/LDMX-Software/ldmx-sw).
+If you wish to develop a specific branch here, you should clone all of ldmx-sw and then go into this
+submodule and checkout your branch from there.