js-packages start documenting conventions for js packages

That's a very good question! Maybe it's worth mentioning build step in grunt/gulp. AFAIK Mercury and Interactive Maps went this way -- we have `gulp build --type production` task which is being used by deploytools plugins.