notes: updated
docs: updated flows and specs