yaml blueprint instructions

this is a first pass, and work in progress, but submitted for early review