Modelo mental

Pense em uma CLI como uma funcao que atravessa o limite do processo:

argumentos do terminal
        |
        v
validacao do contrato
        |
        v
leitura da entrada -> processamento -> saida
        |                    |
        +--> erro             +--> stdout
                              +--> stderr
                              +--> codigo de retorno

O contrato precisa responder cinco perguntas:

1. Qual entrada o comando recebe?
2. Quais opcoes alteram o comportamento?
3. O que aparece quando a entrada e valida?
4. Como o comando comunica uma falha?
5. Como outra ferramenta sabe se a operacao terminou bem?

Se essas respostas nao estao claras, a CLI ainda nao e uma interface confiavel, mesmo que o codigo interno funcione.