diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..76a4e8e
--- /dev/null
+++ b/Makefile
@@ -0,0 +1 @@
+# note: call scripts from /scripts
\ No newline at end of file
diff --git a/README.md b/README.md
index 5e068af..3b740e9 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,5 @@
 # Standard Go Project Layout
 
+This is a basic layout for Go application projects. It represents the most common directory structure with a number of small enhancements along with several supporting directories common to any real world application.
+
+
diff --git a/api/.keep b/api/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/assets/.keep b/assets/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/build/ci/.keep b/build/ci/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/build/package/.keep b/build/package/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/cmd/_your_app_/.keep b/cmd/_your_app_/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/configs/.keep b/configs/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/deployments/.keep b/deployments/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/.keep b/docs/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/examples/.keep b/examples/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/githooks/.keep b/githooks/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/init/.keep b/init/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/internal/app/_your_app_/.keep b/internal/app/_your_app_/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/internal/pkg/_your_private_lib_/.keep b/internal/pkg/_your_private_lib_/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/pkg/_your_public_lib_/.keep b/pkg/_your_public_lib_/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/scripts/.keep b/scripts/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/test/.keep b/test/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/third_party/.keep b/third_party/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/.keep b/tools/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/vendor/.keep b/vendor/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/web/app/.keep b/web/app/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/web/static/.keep b/web/static/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/web/template/.keep b/web/template/.keep
new file mode 100644
index 0000000..e69de29