diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6da9fdf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,79 @@
+# Clean Architecture checker for Golang
+
+go-cleanarch was created to keep Clean Architecture rules,
+like a _The Dependency Rule_ and _interaction between modules_ in your Go projects.
+More about Clean Architecture you can read in [Uncle's Bob article](https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html).
+
+![Clean Architecture](docs/go-cleanarch.png)
+
+## Installing
+
+    go get github.com/roblaszczak/go-cleanarch
+
+_go-cleanarch was only tested on Linux and also should work on OS X.
+Probably it doesn't work well on Windows._
+
+## Running
+
+To run in current directory:
+
+    cleanarch
+
+To run in provided directory
+
+    cleanarch go/src/github.com/roblaszczak/awesome-cms
+
+### Project schema requirements
+
+go-cleanarch assumes this files structure:
+
+    [GOPATH]/[PACKAGE_NAME]/[LAYER_NAME]
+
+or
+
+    [GOPATH]/[PACKAGE_NAME]/[MODULE_NAME]/[LAYER_NAME]
+
+For example
+
+* go/src/github.com/roblaszczak/awesome-app
+    * auth
+        * domain
+        * application
+        * interfaces
+    * content
+        * domain
+        * application
+        * interfaces
+    * frontend
+        * domain
+        * application
+        * interfaces
+
+For examples please go to [examples](examples/) directory,
+with contains examples of valid and invalid architectures.
+
+For more informations about Clean Architecture please read [Uncle's Bob article](https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html)
+
+## Running the tests
+
+    make test
+
+## And coding style tests
+
+    make qa
+
+## Contributing
+
+Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us.
+
+## Versioning
+
+We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/your/project/tags).
+
+## Credits
+
+Made without love by Robert Laszczak </3
+
+## License
+
+This project is licensed under the MIT License.
diff --git a/cleanarch/cleanarch_test.go b/cleanarch/cleanarch_test.go
index 5c6cf36..5c66cda 100644
--- a/cleanarch/cleanarch_test.go
+++ b/cleanarch/cleanarch_test.go
@@ -11,11 +11,11 @@ func TestValidator_Validate(t *testing.T) {
 		Path    string
 		IsValid bool
 	}{
-		{"../tests/valid-simple", true},
-		{"../tests/invalid-infra-in-domain-import", false},
-		{"../tests/invalid-app-in-domain-import", false},
-		{"../tests/invalid-import-between-modules-apps", false},
-		{"../tests/valid-cross-module-deps", true},
+		{"../examples/valid-simple", true},
+		{"../examples/invalid-infra-in-domain-import", false},
+		{"../examples/invalid-app-to-domain-import", false},
+		{"../examples/invalid-cross-module-deps", false},
+		{"../examples/valid-cross-module-deps", true},
 	}
 
 	for _, c := range testCases {
diff --git a/docs/go-cleanarch.png b/docs/go-cleanarch.png
new file mode 100644
index 0000000..30c4749
Binary files /dev/null and b/docs/go-cleanarch.png differ
diff --git a/examples/invalid-app-to-domain-import/README.md b/examples/invalid-app-to-domain-import/README.md
new file mode 100644
index 0000000..d0fbe10
--- /dev/null
+++ b/examples/invalid-app-to-domain-import/README.md
@@ -0,0 +1,3 @@
+# Invalid `app` to `domain` import
+
+![Schema](schema.png)
diff --git a/tests/invalid-app-in-domain-import/app/price.go b/examples/invalid-app-to-domain-import/app/price.go
similarity index 100%
rename from tests/invalid-app-in-domain-import/app/price.go
rename to examples/invalid-app-to-domain-import/app/price.go
diff --git a/examples/invalid-app-to-domain-import/domain/product.go b/examples/invalid-app-to-domain-import/domain/product.go
new file mode 100644
index 0000000..ab4bfe3
--- /dev/null
+++ b/examples/invalid-app-to-domain-import/domain/product.go
@@ -0,0 +1,7 @@
+package domain
+
+import "github.com/roblaszczak/go-cleanarch/examples/invalid-app-to-domain-import/app"
+
+type Product struct {
+	Price app.Price
+}
diff --git a/examples/invalid-app-to-domain-import/schema.png b/examples/invalid-app-to-domain-import/schema.png
new file mode 100644
index 0000000..b86b344
Binary files /dev/null and b/examples/invalid-app-to-domain-import/schema.png differ
diff --git a/examples/invalid-cross-module-deps/README.md b/examples/invalid-cross-module-deps/README.md
new file mode 100644
index 0000000..95db27d
--- /dev/null
+++ b/examples/invalid-cross-module-deps/README.md
@@ -0,0 +1,6 @@
+# Invalid cross modules deps
+
+![Schema](schema.png)
+
+In this example modules are interacting directly
+(without using `interfaces` and `infrastructure` layers).
diff --git a/tests/invalid-import-between-modules-apps/forum/post/app/post.go b/examples/invalid-cross-module-deps/forum/post/app/post.go
similarity index 100%
rename from tests/invalid-import-between-modules-apps/forum/post/app/post.go
rename to examples/invalid-cross-module-deps/forum/post/app/post.go
diff --git a/examples/invalid-cross-module-deps/forum/user/app/user.go b/examples/invalid-cross-module-deps/forum/user/app/user.go
new file mode 100644
index 0000000..eb9d3c3
--- /dev/null
+++ b/examples/invalid-cross-module-deps/forum/user/app/user.go
@@ -0,0 +1,7 @@
+package app
+
+import "github.com/roblaszczak/go-cleanarch/examples/invalid-cross-module-deps/forum/post/app"
+
+type User struct {
+	Posts []app.Post
+}
diff --git a/examples/invalid-cross-module-deps/schema.png b/examples/invalid-cross-module-deps/schema.png
new file mode 100644
index 0000000..631f739
Binary files /dev/null and b/examples/invalid-cross-module-deps/schema.png differ
diff --git a/examples/invalid-infra-in-domain-import/README.md b/examples/invalid-infra-in-domain-import/README.md
new file mode 100644
index 0000000..32467dc
--- /dev/null
+++ b/examples/invalid-infra-in-domain-import/README.md
@@ -0,0 +1,3 @@
+# Invalid `infrastructure` in domain `import`
+
+![Schema](schema.png)
diff --git a/tests/invalid-infra-in-domain-import/domain/order.go b/examples/invalid-infra-in-domain-import/domain/order.go
similarity index 73%
rename from tests/invalid-infra-in-domain-import/domain/order.go
rename to examples/invalid-infra-in-domain-import/domain/order.go
index 48d2721..f16da15 100644
--- a/tests/invalid-infra-in-domain-import/domain/order.go
+++ b/examples/invalid-infra-in-domain-import/domain/order.go
@@ -1,6 +1,6 @@
 package domain
 
-import "github.com/roblaszczak/go-cleanarch/tests/invalid-infra-in-domain-import/infrastructure"
+import "github.com/roblaszczak/go-cleanarch/examples/invalid-infra-in-domain-import/infrastructure"
 
 type OrderAdder struct {
 	// please, don't do this :(
diff --git a/tests/invalid-infra-in-domain-import/infrastructure/payments.go b/examples/invalid-infra-in-domain-import/infrastructure/payments.go
similarity index 100%
rename from tests/invalid-infra-in-domain-import/infrastructure/payments.go
rename to examples/invalid-infra-in-domain-import/infrastructure/payments.go
diff --git a/examples/invalid-infra-in-domain-import/schema.png b/examples/invalid-infra-in-domain-import/schema.png
new file mode 100644
index 0000000..6a0bc37
Binary files /dev/null and b/examples/invalid-infra-in-domain-import/schema.png differ
diff --git a/examples/valid-cross-module-deps/README.md b/examples/valid-cross-module-deps/README.md
new file mode 100644
index 0000000..741bb1c
--- /dev/null
+++ b/examples/valid-cross-module-deps/README.md
@@ -0,0 +1,3 @@
+# Invalid cross module deps
+
+![Schema](schema.png)
diff --git a/examples/valid-cross-module-deps/cms/auth/interfaces/access.go b/examples/valid-cross-module-deps/cms/auth/interfaces/access.go
new file mode 100644
index 0000000..5c7167c
--- /dev/null
+++ b/examples/valid-cross-module-deps/cms/auth/interfaces/access.go
@@ -0,0 +1,7 @@
+package interfaces
+
+import "github.com/roblaszczak/go-cleanarch/examples/valid-cross-module-deps/cms/auth/usecases"
+
+func CheckAccess(username string) bool {
+	return usecases.LoginAccessChecker(username)
+}
diff --git a/examples/valid-cross-module-deps/cms/auth/usecases/access.go b/examples/valid-cross-module-deps/cms/auth/usecases/access.go
new file mode 100644
index 0000000..8ad10bc
--- /dev/null
+++ b/examples/valid-cross-module-deps/cms/auth/usecases/access.go
@@ -0,0 +1,5 @@
+package usecases
+
+func LoginAccessChecker(username string) bool {
+	return username == "admin"
+}
diff --git a/examples/valid-cross-module-deps/cms/cms.go b/examples/valid-cross-module-deps/cms/cms.go
new file mode 100644
index 0000000..1b4a224
--- /dev/null
+++ b/examples/valid-cross-module-deps/cms/cms.go
@@ -0,0 +1,10 @@
+package main
+
+import (
+	"github.com/roblaszczak/go-cleanarch/examples/valid-cross-module-deps/cms/content/infrastructure"
+	"github.com/roblaszczak/go-cleanarch/examples/valid-cross-module-deps/cms/content/usecases"
+)
+
+func main() {
+	usecases.AddArticle{infrastructure.AuthModuleAuthChecker{}}.AddArticle("admin", "test article")
+}
diff --git a/examples/valid-cross-module-deps/cms/content/infrastructure/auth.go b/examples/valid-cross-module-deps/cms/content/infrastructure/auth.go
new file mode 100644
index 0000000..feca946
--- /dev/null
+++ b/examples/valid-cross-module-deps/cms/content/infrastructure/auth.go
@@ -0,0 +1,11 @@
+package infrastructure
+
+import (
+	"github.com/roblaszczak/go-cleanarch/examples/valid-cross-module-deps/cms/auth/interfaces"
+)
+
+type AuthModuleAuthChecker struct{}
+
+func (a AuthModuleAuthChecker) CheckAuth(username string) bool {
+	return interfaces.CheckAccess(username)
+}
diff --git a/examples/valid-cross-module-deps/cms/content/usecases/add_article.go b/examples/valid-cross-module-deps/cms/content/usecases/add_article.go
new file mode 100644
index 0000000..ef8a707
--- /dev/null
+++ b/examples/valid-cross-module-deps/cms/content/usecases/add_article.go
@@ -0,0 +1,24 @@
+package usecases
+
+import (
+	"fmt"
+)
+
+type AuthChecker interface {
+	CheckAuth(username string) bool
+}
+
+type AddArticle struct {
+	AuthChecker AuthChecker
+}
+
+func (c AddArticle) AddArticle(username string, title string) error {
+	if !c.AuthChecker.CheckAuth(username) {
+		return fmt.Errorf("user %s is not allowed to add article", username)
+	}
+
+	// todo - some article adding logic
+	fmt.Printf("added %s article by %s\n", title, username)
+
+	return nil
+}
diff --git a/examples/valid-cross-module-deps/schema.png b/examples/valid-cross-module-deps/schema.png
new file mode 100644
index 0000000..092f753
Binary files /dev/null and b/examples/valid-cross-module-deps/schema.png differ
diff --git a/examples/valid-simple/README.md b/examples/valid-simple/README.md
new file mode 100644
index 0000000..685c4fe
--- /dev/null
+++ b/examples/valid-simple/README.md
@@ -0,0 +1,3 @@
+# Simple valid architecture
+
+![Schema](schema.png)
\ No newline at end of file
diff --git a/tests/valid-simple/app/payment.go b/examples/valid-simple/app/payment.go
similarity index 66%
rename from tests/valid-simple/app/payment.go
rename to examples/valid-simple/app/payment.go
index f134511..c821160 100644
--- a/tests/valid-simple/app/payment.go
+++ b/examples/valid-simple/app/payment.go
@@ -1,6 +1,6 @@
 package app
 
-import "github.com/roblaszczak/go-cleanarch/tests/valid-simple/domain"
+import "github.com/roblaszczak/go-cleanarch/examples/valid-simple/domain"
 
 type Payment struct {
 	Amount domain.Price
diff --git a/tests/valid-simple/domain/order.go b/examples/valid-simple/domain/order.go
similarity index 100%
rename from tests/valid-simple/domain/order.go
rename to examples/valid-simple/domain/order.go
diff --git a/tests/valid-simple/domain/price.go b/examples/valid-simple/domain/price.go
similarity index 100%
rename from tests/valid-simple/domain/price.go
rename to examples/valid-simple/domain/price.go
diff --git a/tests/valid-simple/infrastructure/payments.go b/examples/valid-simple/infrastructure/payments.go
similarity index 76%
rename from tests/valid-simple/infrastructure/payments.go
rename to examples/valid-simple/infrastructure/payments.go
index 1153c6f..af1dc38 100644
--- a/tests/valid-simple/infrastructure/payments.go
+++ b/examples/valid-simple/infrastructure/payments.go
@@ -2,7 +2,7 @@ package infrastructure
 
 import (
 	"fmt"
-	"github.com/roblaszczak/go-cleanarch/tests/valid-simple/app"
+	"github.com/roblaszczak/go-cleanarch/examples/valid-simple/app"
 )
 
 type MysqlPaymentsRepository struct{}
diff --git a/tests/valid-simple/main.go b/examples/valid-simple/main.go
similarity index 51%
rename from tests/valid-simple/main.go
rename to examples/valid-simple/main.go
index 7150235..3dd1dfd 100644
--- a/tests/valid-simple/main.go
+++ b/examples/valid-simple/main.go
@@ -1,9 +1,9 @@
 package main
 
 import (
-	"github.com/roblaszczak/go-cleanarch/tests/valid-simple/app"
-	"github.com/roblaszczak/go-cleanarch/tests/valid-simple/domain"
-	"github.com/roblaszczak/go-cleanarch/tests/valid-simple/infrastructure"
+	"github.com/roblaszczak/go-cleanarch/examples/valid-simple/app"
+	"github.com/roblaszczak/go-cleanarch/examples/valid-simple/domain"
+	"github.com/roblaszczak/go-cleanarch/examples/valid-simple/infrastructure"
 )
 
 func main() {
diff --git a/examples/valid-simple/schema.png b/examples/valid-simple/schema.png
new file mode 100644
index 0000000..b5e5807
Binary files /dev/null and b/examples/valid-simple/schema.png differ
diff --git a/tests/invalid-app-in-domain-import/README.md b/tests/invalid-app-in-domain-import/README.md
deleted file mode 100644
index e69de29..0000000
diff --git a/tests/invalid-app-in-domain-import/domain/product.go b/tests/invalid-app-in-domain-import/domain/product.go
deleted file mode 100644
index 57caef3..0000000
--- a/tests/invalid-app-in-domain-import/domain/product.go
+++ /dev/null
@@ -1,7 +0,0 @@
-package domain
-
-import "github.com/roblaszczak/go-cleanarch/tests/invalid-app-in-domain-import/app"
-
-type Product struct {
-	Price app.Price
-}
diff --git a/tests/invalid-import-between-modules-apps/README.md b/tests/invalid-import-between-modules-apps/README.md
deleted file mode 100644
index e69de29..0000000
diff --git a/tests/invalid-import-between-modules-apps/forum/user/app/user.go b/tests/invalid-import-between-modules-apps/forum/user/app/user.go
deleted file mode 100644
index ac017de..0000000
--- a/tests/invalid-import-between-modules-apps/forum/user/app/user.go
+++ /dev/null
@@ -1,7 +0,0 @@
-package app
-
-import "github.com/roblaszczak/go-cleanarch/tests/invalid-import-between-modules-apps/forum/post/app"
-
-type User struct {
-	Posts []app.Post
-}
diff --git a/tests/invalid-infra-in-domain-import/README.md b/tests/invalid-infra-in-domain-import/README.md
deleted file mode 100644
index 256f4ef..0000000
--- a/tests/invalid-infra-in-domain-import/README.md
+++ /dev/null
@@ -1 +0,0 @@
-[todo - schema]
\ No newline at end of file
diff --git a/tests/valid-cross-module-deps/README.md b/tests/valid-cross-module-deps/README.md
deleted file mode 100644
index 5c3e923..0000000
--- a/tests/valid-cross-module-deps/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-In this case we are making imports between multiple modules using interfaces layer.
-
-[todo - schema]
\ No newline at end of file
diff --git a/tests/valid-cross-module-deps/cms/auth/interfaces/access.go b/tests/valid-cross-module-deps/cms/auth/interfaces/access.go
deleted file mode 100644
index 640949d..0000000
--- a/tests/valid-cross-module-deps/cms/auth/interfaces/access.go
+++ /dev/null
@@ -1,5 +0,0 @@
-package interfaces
-
-func CheckAccess(username string) bool {
-	return username == "admin"
-}
diff --git a/tests/valid-cross-module-deps/cms/cms.go b/tests/valid-cross-module-deps/cms/cms.go
deleted file mode 100644
index 7905807..0000000
--- a/tests/valid-cross-module-deps/cms/cms.go
+++ /dev/null
@@ -1,5 +0,0 @@
-package main
-
-func main() {
-
-}
diff --git a/tests/valid-cross-module-deps/cms/content/domain/authchecker.go b/tests/valid-cross-module-deps/cms/content/domain/authchecker.go
deleted file mode 100644
index 4cf5c39..0000000
--- a/tests/valid-cross-module-deps/cms/content/domain/authchecker.go
+++ /dev/null
@@ -1,5 +0,0 @@
-package domain
-
-type AuthChecker interface {
-	CheckAuth(u User) bool
-}
diff --git a/tests/valid-cross-module-deps/cms/content/domain/user.go b/tests/valid-cross-module-deps/cms/content/domain/user.go
deleted file mode 100644
index 9133507..0000000
--- a/tests/valid-cross-module-deps/cms/content/domain/user.go
+++ /dev/null
@@ -1,13 +0,0 @@
-package domain
-
-func NewUser(username string) User {
-	return User{username}
-}
-
-type User struct {
-	username string
-}
-
-func (u User) Username() string {
-	return u.username
-}
diff --git a/tests/valid-cross-module-deps/cms/content/infrastructure/auth.go b/tests/valid-cross-module-deps/cms/content/infrastructure/auth.go
deleted file mode 100644
index 4ad21f2..0000000
--- a/tests/valid-cross-module-deps/cms/content/infrastructure/auth.go
+++ /dev/null
@@ -1,12 +0,0 @@
-package infrastructure
-
-import (
-	"github.com/roblaszczak/go-cleanarch/tests/valid-cross-module-deps/cms/auth/interfaces"
-	"github.com/roblaszczak/go-cleanarch/tests/valid-cross-module-deps/cms/content/domain"
-)
-
-type AuthModuleAuthChecker struct{}
-
-func (a AuthModuleAuthChecker) CheckAuth(u domain.User) bool {
-	return interfaces.CheckAccess(u.Username())
-}
diff --git a/tests/valid-cross-module-deps/cms/content/usecases/checkaccess.go b/tests/valid-cross-module-deps/cms/content/usecases/checkaccess.go
deleted file mode 100644
index 1a46ebd..0000000
--- a/tests/valid-cross-module-deps/cms/content/usecases/checkaccess.go
+++ /dev/null
@@ -1,13 +0,0 @@
-package usecases
-
-import (
-	"github.com/roblaszczak/go-cleanarch/tests/valid-cross-module-deps/cms/content/domain"
-)
-
-type AccessCheckController struct {
-	AuthChecker domain.AuthChecker
-}
-
-func (c AccessCheckController) CheckAccess(username string) bool {
-	return c.AuthChecker.CheckAuth(domain.NewUser(username))
-}
diff --git a/tests/valid-simple/README.md b/tests/valid-simple/README.md
deleted file mode 100644
index 256f4ef..0000000
--- a/tests/valid-simple/README.md
+++ /dev/null
@@ -1 +0,0 @@
-[todo - schema]
\ No newline at end of file