codebook.md

description of how things work in the project.