diff --git a/README.md b/README.md
index c5db6b98254e934446db097bbce8737c329c6c99..3e0e9e13055f45f3bdafc17ce4fc4423d9fe519b 100644
--- a/README.md
+++ b/README.md
@@ -21,4 +21,38 @@
 
 Mostly required IntelliJ IDEA for Kotlin.
 
-    idea . &
\ No newline at end of file
+    idea . &
+
+
+## source
+
+### package / naming conventions
+
+main package
+
+    unibz.      univerity name
+    cs.         computer science faculty name
+    semint.     project name
+    kprime      subproject name
+
+main class entry point
+
+    Starter     where all it starts and components get put toghether
+
+technology free packages
+
+    domain/     where aggregates, entities, values lives
+    usecase/    where domain components play toghether using services, repositories interfaces
+
+technology depenent packages
+
+    adapter/    where services, repositories implementations lives
+    support/    where domain indipendent sherable implementation components lives
+    
+
+## classes conventions
+
+* A UseCase will return allways a UseCaseResult.
+* A UseCase may use only domain, service, repository components.
+* An Adapter ha always to implement a service or repository interface.
+* A domain component has to depends on nothing.