These specs are well-written -- nice work!

My one main suggestion is to adopt the `include pattern`/`exclude pattern` terminology here rather than `keep pattern`/`discard pattern`.  (I think `keep` and `discard` are great verbs to use in doc strings, though!)