diff --git a/.gitignore b/.gitignore
index 11b529f..f07503c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -29,4 +29,7 @@
 __pycache__/
 *.pyc
 
-onap_sandbox
+# jjb local testing
+venv-jjb
+job-configs
+
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..ab690d9
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,23 @@
+# Makefile for testing JJB jobs in a virtualenv
+
+.PHONY: test clean
+
+VENV_DIR      ?= venv-jjb
+JJB_VERSION   ?= 2.0.0
+JOBCONFIG_DIR ?= job-configs
+
+$(VENV_DIR):
+	@echo "Setting up virtualenv for JJB testing"
+	virtualenv $@
+	$@/bin/pip install jenkins-job-builder==$(JJB_VERSION) pipdeptree
+
+$(JOBCONFIG_DIR):
+	mkdir $@
+
+test: $(VENV_DIR) $(JOBCONFIG_DIR)
+	source $(VENV_DIR)/bin/activate ; \
+	pipdeptree ; \
+	jenkins-jobs -l DEBUG test --recursive -o $(JOBCONFIG_DIR) jjb/ ;
+
+clean:
+	rm -rf $(VENV_DIR) $(JOBCONFIG_DIR)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..30d7499
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# ci-management for CORD
+
+This repo holds configuration for the Jenkins testing infrastructure used by
+CORD.
+
+The best way to work with this repo is to check it out with `repo`, per these
+instructions: [Downloading testing and QA
+repositories](https://guide.opencord.org/getting_the_code.html#downloading-testing-and-qa-repositories)
+
+> NOTE: This repo uses git submodules. If you have trouble with the tests or
+> other tasks, please run: `git submodule init && git submodule update` to
+> obtain these submodules, as `repo` won't do this automatically for you.
+
+## Testing job definitions
+
+[Documentation for Jenkins Job Builder
+(JJB)](https://docs.openstack.org/infra/jenkins-job-builder/index.html)
+
+JJB job definitions can be tested by running:
+
+```shell
+make test
+```
+
+Which will create a python virtualenv, install jenkins-job-builder in it, then
+try building all the job files.
+