O caderno de encargos: o que deve conter para ser útil

Um caderno de encargos enuncia o que se espera de um projeto ou de um fornecedor: a necessidade, o âmbito, as restrições e os critérios com que o resultado será aceite. A sua função não é descrever uma solução — isso cabe à resposta — mas definir o problema com precisão suficiente para que dois fornecedores diferentes o entendam da mesma forma e para que a aceitação possa ser pronunciada sem discussão.

Partir da necessidade, não da solução

A falha mais comum é um caderno de encargos que já contém a solução: ecrãs, tecnologias, uma arquitetura escolhida. Fecha a porta a melhores respostas, devolve-lhe o risco de conceção e torna a aceitação indefensável — não se pode recusar uma entrega que implementa exatamente aquilo que se desenhou. Enuncie a necessidade de negócio, o processo a servir e o efeito esperado; deixe o «como» para a resposta.

O que deve conter

O contexto e o objetivo prosseguido. O âmbito funcional e, com igual clareza, o que dele fica excluído. Os requisitos não funcionais — volumetria, desempenho, disponibilidade, segurança, acessibilidade, restrições de alojamento e de localização dos dados. As interfaces com o existente. As restrições de calendário e as datas inamovíveis. Os critérios de aceitação. E a governação: quem decide, quem aceita, a que ritmo.

Todo o requisito tem de ser verificável

«A aplicação tem de ser rápida» não pode ser aceite nem recusada. «Uma pesquisa responde em menos de dois segundos para 95 % dos pedidos com 200 utilizadores em simultâneo» pode. O teste é simples: para cada linha, pergunte o que mediria para dizer que está cumprida. Qualquer requisito que sobreviva sem resposta pertence à secção de contexto ou ao caixote — mantê-lo garante um litígio na aceitação.

O fora de âmbito vale mais do que o âmbito

Aquilo que um caderno de encargos exclui protege o projeto muito mais do que aquilo que inclui. Nomear o que se deixa deliberadamente de fora — o segundo país, a migração dos dados antigos, a aplicação móvel — mata a ambiguidade que de outro modo regressaria como expectativa não orçamentada ao quinto mês. É também a única forma de uma peça de alteração ser reconhecida como tal em vez de ser absorvida em silêncio.

Do caderno de encargos ao projeto no FoxPlan

No FoxPlan os requisitos vivem como objetos do projeto, cada um ligado às tarefas que o implementam e ao entregável que será aceite: a cobertura passa a ser uma leitura e não um confronto manual. O que foi excluído fica escrito ao lado do que foi acordado, e o projeto guarda um rasto duradouro daquilo com que se comprometeu — o documento que torna curta uma reunião de aceitação.