README with design intent and developer notes