POSIX #shellscripting pain point:

If I use $( shellcheck -ax mainscript.sh ) and a dot-included #shellscript has a typo in a comment that happens to be a shellcheck directive, then shellcheck calls that comment a script parse error & refuses to check it.

It's reasonable but surprising.