Definição curta

Regra de tratamento escrita e permanente, que diz a um agente como tratar o material que entra em um contexto — e não o que esse material contém.

Definição detalhada

No sentido corrente, uma diretriz é uma instrução imperativa emitida por uma autoridade; no sentido da computação, é uma orientação dirigida a um compilador, e não ao programa. Os dois sentidos compartilham um traço útil aqui: a diretriz não pertence ao conteúdo que ela governa.

Nos artigos deste blog, o termo designa uma orientação de tratamento escrita por quem detém o contexto, guardada à parte do material — um arquivo directives.md diante de um context.md — e aplicada a cada ingestão sem precisar ser pedida de novo. Ela é escrita a frio, prescreve, e não data nada.

Dois níveis coexistem sob a mesma palavra. As diretrizes genéricas valem para qualquer assunto: agregue, historize, separe por tema. As diretrizes de negócio só valem para um contexto dado e codificam um conhecimento de campo: resolver um homônimo de prestador pelo sentido do e-mail, reconhecer uma mesma pessoa sob o nome de solteira e o nome de casada, separar os devedores de menos de cem euros dos demais.

Uso de campo contra uso normativo: uma diretriz quase sempre nasce na conversa falada com o agente, e só vira diretriz no sentido adotado aqui no momento em que é escrita em um arquivo para valer todas as vezes.

Uso no domínio

Entra em jogo nos raciocínios sobre a estruturação da informação que entra em um contexto — a passagem de um arquivo único para um sistema com vários arquivos, a repartição entre o que deve ser duplicado em cada arquivo temático e o que deve continuar único, e a avaliação da maturidade de um contexto pelo volume de suas regras específicas.

Sinônimos e variantes

"regra de tratamento" quando a ênfase recai sobre a função; "diretriz de negócio" quando a ênfase recai sobre seu caráter local; "orientação" no uso falado, antes da escrita.

Não confundir com

• Contexto — espaço de trabalho durável que reúne, em torno de um objetivo, as fontes, as notas, as decisões e os rascunhos de um mesmo assunto. A diretriz diz como tratar o que entra ali; ela não é material do contexto, e é isso que justifica alojá-la em seu próprio arquivo.
• Memória de sessão — registro escrito ao longo das trocas do que foi feito, decidido e deixado em suspenso, destinado a ser recarregado. Ela data tudo e não prescreve nada; a diretriz prescreve e não data nada.
• prompt — instrução dirigida a um modelo para um pedido específico, consumida junto com ele. A diretriz sobrevive ao pedido e se aplica aos seguintes sem ser reescrita.
• Destilação — operação que reduz um material ao que ele ensina. A diretriz é a orientação que governa a operação, não o resultado obtido.

Exemplos

"Quando uma pessoa é citada pelo sobrenome, encontrar o nome correspondente; se dois prestadores têm o mesmo nome, usar o sentido do e-mail para desambiguar." Orientação inútil para um leitor humano do condomínio, indispensável para o agente que trata os e-mails no lugar dele.

"Separe os pequenos devedores, abaixo de cem euros, dos grandes devedores." Uma regra de tratamento que carrega de passagem um fato sobre o condomínio — caso em que a fronteira com o material é a mais tênue.

Ambiguidades / debates

A palavra circula em dois sentidos que nada distingue na fala: a orientação pontual dada em uma conversa, e a regra permanente escrita em um arquivo. É a segunda que vale aqui, e a diferença é operacional — só a regra escrita se aplica quando não há ninguém para lembrá-la.