diff --git a/scripts/phab2github/README.md b/scripts/phab2github/README.md
new file mode 100644
index 0000000..64fa404
--- /dev/null
+++ b/scripts/phab2github/README.md
@@ -0,0 +1,45 @@
+This folder contains a set of scripts to mirror Phabricator *Revisions* to GitHub *Pull Requests*.
+
+# Problem statement
+The LLVM project performs code reviews on [Phabricator](https://reviews.llvm.org) and the source 
+code is stored on [GitHub](https://github.com/llvm/llvm-project). While there are many nice CI 
+system integrations available for GitHub (e.g. buildkite, CircleCI, GitHub Actions), there are not 
+that many for Phabricator. The current setup of the pre-merge tests is quite some effort to maintain 
+and does not scale well with additional build agents. User do not have access to the bulid status.
+
+One of the challenges is that Phabricator maintains patches, that might not be based on a git 
+commit. And even if they are based on a git commit, that commit might be local to the user and 
+not available in the public repository.
+
+# Proposal
+Instead of integrating a CI system with Phabricator, move all the information to Github and trigger 
+the builds from there.
+
+1. Create a service that mirrors all Revisions form Phabricator into GitHub Pull Requests. 
+1. Then use the usual CI integration for GitHub to build and test these revisions.
+1. On Phabricator, add links to the builds.
+1. At the end of the build, a script uploads the results to Phabricator (as we have it now).
+
+If that works well, we can also use this to demonstrate the workflow of Github Pull Requests to the 
+LLVM community.
+
+# Work items
+
+This is the list (and order) of the work items for this idea.
+We will start with this on a fork of the LLVM repository.
+Cancel the effort if some thinks would not work or the community objects.
+
+* [ ] For each Revision create a branch. Create a PR from that.
+* [ ] Layer the diffs on top of each other in the git log.
+* [ ] Figure out what to do with chained Revisions.
+* [ ] Find a way to copy the description and the comments from the Revision to the PR. 
+* [ ] Also sync Revisions that do not trigger Harbormaster at the moment and provide feedback as 
+well.
+* [ ] Clean up old branches and PRs. 
+* [ ] Add more build machines to buildkite and move beta testers to new infrastructure.
+* [ ] Move all pre-merge tests to new infrastructure.
+
+
+Optional: 
+* [ ] Create branches and PRs on LLVM repository, allow people to click the "Merge" button on the PR, 
+reducing the manual work to land a patch. 
\ No newline at end of file
diff --git a/scripts/phab2github/__init__.py b/scripts/phab2github/__init__.py
new file mode 100644
index 0000000..e69de29