diff --git a/README.md b/README.md
index d69926e..fe79c7f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,23 @@
-# codex-spec
-Specs for Codex network
+## Codex Specifications
+
+Codex is building a decentralized durability engine aiming to allow users to have data persistence.
+This repository contains Codex specifications currently under discussion.
+
+Visit the official [Codex website]() for more information about the project.
+
+Note: Codex is still under active development. 
+Specifications located in this repository should be considered not production ready.
+Discussion is conducted with the intention of maturing each specification.
+
+## Contributors 
+
+Contributors are welcomed to create a new pull request with specifications.
+It is reccommened to adhere to the 1/COSS guidelines when writing specifications.
+
+Please adhere to the following guidelines:
+
+- Name and title of all specification must have the `CODEX-` prefix
+- Use [semantic breaks](https://sembr.org/)
+- It is reccomended to base specification on the Vac [template](./template.md)
+
+## License