Objetivo: ao final, o consultor obtém a saída já no formato do entregável, e sabe usar um exemplo próprio como referência de formato.
| Você vai usar em… | Peça assim |
|---|---|
| Slide de comitê | "Bullets de no máximo 10 palavras, no máximo 5 por slide, sem sub-bullets" |
| Tabela comparativa | "Tabela com as colunas X, Y, Z. Uma linha por item. Células curtas" |
| E-mail ao cliente | "E-mail de no máximo 200 palavras, tom formal-cordial, com um pedido de ação claro no final" |
| Seção de documento | "Seção em markdown com subtítulos, no padrão do exemplo abaixo" |
| Planilha | "CSV com cabeçalho, colunas X, Y, Z, uma linha por item, sem células mescladas" |
| Checklist operacional | "Checklist numerado, cada item começando com verbo no infinitivo, com critério de conclusão" |
| Ata de reunião | "Ata com: participantes, decisões tomadas, pendências com responsável e prazo, próximos passos" |
A instrução mais eficiente de todas:
Escreva a seção de regras de negócio desta spec seguindo exatamente o
mesmo padrão do exemplo abaixo — mesma estrutura, mesmo nível de
detalhe, mesma convenção de nomenclatura.
EXEMPLO:
[cole aqui uma seção que você já escreveu e que representa o padrão da casa]
Um exemplo transmite de uma vez: estrutura, tom, densidade, vocabulário, convenção de nomes, o que fica implícito e o que é explicitado. Nenhuma lista de adjetivos faz isso.
Onde encontrar seus exemplos: um entregável antigo bem-feito, um template da Wayon, uma seção de spec que passou pela revisão sem apontamento.
Para entregável longo, duas etapas custam menos que uma:
Etapa 1: "Proponha apenas a estrutura de seções, com uma linha
dizendo o que vai em cada uma. Não escreva o conteúdo."
Etapa 2: (depois de aprovar) "Agora escreva a seção 3."
Se você está descrevendo o mesmo formato pela terceira vez, você já perdeu tempo suficiente. Escreva uma skill (módulo 1.5) e ele aplica sozinho da próxima vez, sem você pedir.
Sinais de que é hora: mesmo template toda semana, mesma estrutura de e-mail, mesmo padrão de nomenclatura, mesmo checklist de revisão.
Correto. Sai pronto para o slide.
Objetivo não é um formato. Você vai receber prosa mais curta e reformatar de qualquer jeito.
São dez minutos de reformatação que você podia ter economizado com uma linha.
Três adjetivos que podem significar cinco coisas diferentes. Ele vai escolher uma.
Melhores práticas segundo quem? Não é verificável e não é o padrão da casa.
Correto. Um exemplo transmite estrutura, tom, densidade e convenção de nomes de uma vez.
Correto. É o caso central de skill — módulo 1.5.
Melhor que digitar de novo, e ainda depende de você lembrar de colar toda semana.
Quatro repetições já pagaram o tempo de escrever a skill, e a skill funciona também para os seus colegas.