The dh tools have a lot of magic to them. Arguably it works rather well, but figuring out how exactly to build a package correctly is difficult. The documentation is pretty bad, so if you want to do anything slightly different than the standard, you going spelunking in the debian directory of existing packages.

Debian could fix a lot of the troubles with the existing Debian Helper tools by improving the documentation.