nice, embedding the capture instructions right in the markdown as comments is a dead-simple solution that'll age way better than any fancy external tooling

Except that it's brittle—HTML comments can be stripped. I wonder why they chose this approach vs. frontmatter.