Land decoder-refactor design doc + Phase -1 subclass-compatibility warnings (#386)