Opa, meu bom. Documentação é muito importante em projetos open source (mesmo se for só pra você, vai que esquece de algo no futuro).
Lendo seu texto até dá pra ver a motivação, mas não tanto os benefícios disso. Isso tudo deveria estar condensado no readme, inclusive, pra quem tá lendo já entender de cara.
Uma documentação mais completa de como usar também seria bem legal e ajudaria muito quem tivesse interesse.
De qualquer forma, parabéns pelo projeto.