I've pushed a draft spec for the Pipes system to try and document what we currently have and also address AEROGEAR-896, AEROGEAR-895, AEROGEAR-894. https://github.com/aerogear/aerogear.org/tree/pipe_spec