Forneça Exemplos
Um exemplo concreto vale um parágrafo de descrição. Se você quer a saída em um formato específico, mostre o formato. Essa é a forma mais rápida de eliminar ambiguidade.
Format the data nicely.
Transform this array of users into a summary object.
Input:
[{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]
Desired output:
{ total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }
Write the transform function and a test matching this example.
Exemplos fixam nomenclatura, estrutura e capitalização que as palavras sozinhas deixam vagas. Quando possível, inclua o exemplo como um teste — aí "make the test pass" vira uma instrução inequívoca. O truque se generaliza: uma resposta de amostra de uma (Application Programming Interface — Interface de Programação de Aplicações, o jeito como um programa pede dados a outro) fixa um parser, um par antes/depois fixa uma refatoração, uma captura de tela ou um esboço em ASCII fixa um layout. Sempre que você se pegar escrevendo uma descrição longa de um formato, pare e mostre uma instância desse formato.