write first part of documents for Consilient
add partial skeleton and utils code