diff --git a/binary-class/README.md b/binary-class/README.md
new file mode 100644
index 0000000..cb2b59d
--- /dev/null
+++ b/binary-class/README.md
@@ -0,0 +1,25 @@
+# Binary Classification
+
+Custom taxonomy for tagging of known binary files
+
+## type
+
+<dl>
+<dt>good</dt>
+<dd>Known good/safe</dd>
+<dt>bad</dt>
+<dd>Known bad/malicious<dd>
+<dt>unknown</dt>
+<dd>Not yet known</dd>
+</dl>
+
+# Machine-parsable Binary Taxonomy
+
+The repository contains a [JSON file including the machine-parsable tags](machinetag.json)
+along with their human-readable description. The software can use both
+representation on the user-interface and store the tag as machine-parsable.
+
+~~~~
+binary-class:type="good"
+~~~~
+
diff --git a/binary-class/machinetag.json b/binary-class/machinetag.json
new file mode 100644
index 0000000..31a38e1
--- /dev/null
+++ b/binary-class/machinetag.json
@@ -0,0 +1,30 @@
+{
+  "namespace": "binary-class",
+  "description": "Custom taxonomy for types of binary file.",
+  "version": 1,
+  "predicates": [
+    {
+      "value": "type",
+      "expanded": "Binary Type"
+    }
+  ],
+  "values": [
+    {
+      "predicate": "type",
+      "entry": [
+        {
+          "value": "good",
+          "expanded": "Known Good/Safe"
+        },
+        {
+          "value": "malicious",
+          "expanded": "Known Bad/Malicious"
+        },
+        {
+          "value": "unknown",
+          "expanded": "Not yet known"
+        }
+      ]
+    }
+  ]
+}