Modelo mental

Pense em uma CLI como uma função que atravessa o limite do processo:

argumentos do terminal
        |
        v
validação do contrato
        |
        v
leitura da entrada -> processamento -> saída
        |                    |
        +--> erro             +--> stdout
                              +--> stderr
                              +--> código de retorno

O contrato precisa responder cinco perguntas:

1. Qual entrada o comando recebe?
2. Quais opções alteram o comportamento?
3. O que aparece quando a entrada é válida?
4. Como o comando comunica uma falha?
5. Como outra ferramenta sabe se a operação terminou bem?

Se essas respostas não estão claras, a CLI ainda não é uma interface confiável, mesmo que o código interno funcione.