Ideia principal

Um arquivo de contexto começa acolhendo tudo o que chega. As informações sobre o prédio, os prestadores, as obras — e, misturadas a elas, as instruções que dizem como tratar um homônimo, onde colocar o limite entre pequenos e grandes devedores, como reconhecer a mesma pessoa sob dois nomes. Tudo é útil, tudo está no mesmo lugar, e o arquivo passa das mil linhas.

Esses dois conteúdos, porém, não são da mesma natureza. Uns descrevem o condomínio, os outros descrevem a maneira de descrevê-lo: é misturar a receita com os ingredientes. A regra se escreve a frio e vale até alguém mudá-la; o material se escreve ao sabor dos e-mails e nunca para de crescer. Mantê-los juntos faz com que a parte estável seja relida toda vez que a parte móvel engorda, e que você não consiga alterar uma sem atravessar a outra.

Um directives.md de um lado, um context.md do outro: a separação não resolve o problema de volume — o material continua inchando —, mas torna o resto possível. Enquanto as regras estiverem afogadas naquilo que governam, nenhum recorte posterior pode ser feito direito, porque não se sabe o que precisa ser duplicado em cada pedaço e o que precisa continuar único.

Por que isso importa

Isso indica o primeiro recorte a fazer, e ele não é o que se imagina. Diante de um arquivo grande demais, o reflexo é cortá-lo por assunto; extrair primeiro o que não é assunto — as regras — custa pouco e evita copiar as mesmas instruções em quinze arquivos temáticos.

Também fornece uma pergunta de diagnóstico aplicável a qualquer documento de trabalho compartilhado com um agente: cada parágrafo descreve o domínio, ou a forma de tratá-lo?

Nuances e limites

A fronteira nem sempre é nítida. "Os devedores de menos de cem euros são acompanhados à parte" é uma regra de tratamento que contém um fato sobre o condomínio, e ela vai precisar ser revista junto com o fato.

E a separação acrescenta um arquivo a manter: se as diretrizes não forem mais relidas, elas continuam sendo aplicadas sem que ninguém lembre por que existem.

Questões em aberto

• Onde colocar uma regra que só vale para um único arquivo temático — no arquivo de regras comum, ou junto do material que ela trata?