Guia · AI&Media

As seis skills que correm
em tudo o que sai daqui

Uma skill é a instrução que continua a trabalhar depois de parares de colar. Estas seis estão instaladas e activas. Cada uma nasceu de um erro concreto, e o "antes" de cada uma aconteceu mesmo.

Estão escritas como estão no disco, sem retoques. Adapta-as ao teu trabalho: o que muda é o conteúdo, o padrão mantém-se.

01 · Padrão da casa

Entra quando: se escreve qualquer texto para ele, em qualquer plataforma.

O que faz sem ser pedido: aplica a voz dele antes de a primeira frase sair, em vez de a corrigir depois.

As linhas que não se cruzam

O que o humanizer corta, e que aqui já não deve nascer

Paralelismo negativo nas seis formas. Pontes de revelação ("O resultado?", "Aqui está o que"). Confissões emolduradas ("vou ser honesto"). Fechos de isco ("e tu, o que achas?"). Triplos empilhados: um natural chega, três não.

Porque é a primeira

É a que mais se explica e menos se percebe que se está a explicar.

02 · Prova antes de afirmar

Entra quando: aparece um número, uma data, um preço ou um facto num texto que vai ser publicado.

O que faz sem ser pedido: exige a origem antes de deixar o número passar.

A regra

Um número só entra se tiver sido verificado nesta sessão ou vier de uma fonte que se possa nomear. Um número que veio de um plano meu anterior não é um facto verificado: é uma coisa que eu escrevi.

O erro que a criou

A 09.09 escrevi numa legenda "vieram quatro nomes" e "vieram duas". Nunca corri esses testes. O número vinha do meu plano da véspera e eu repeti-o. Se alguém lhe perguntasse de onde saía, ele não tinha resposta.

Quando fui verificar a sério, o resultado era melhor do que o inventado: cinco nomes, e duas das cinco com o site fechado a robots. Verificar não custou credibilidade, deu conteúdo.

Como se aplica

O corolário do Gu

"Elogio errado queima mais que crítica errada." Um diagnóstico que diz a alguém que tem uma coisa que não tem é pior do que um que falha um problema. A pessoa vai lá ver.

03 · Matéria-prima antes do formato

Entra quando: se decide se uma notícia ou tema vira reel, carrossel ou nada.

O que faz sem ser pedido: procura a imagem antes de escolher o formato, e não o contrário.

A regra

O erro que a criou

A 09.09 fizemos um carrossel sobre um lançamento da Meta cujos cinco vídeos de imprensa eram todos maquetes de telemóvel em branco. Tentei salvar o post com desenho, seis vezes, e ele rejeitou as seis. O problema não era o desenho: era a matéria-prima. Nenhuma tipografia salva um assunto sem imagem.

Onde mora a matéria-prima

A distinção que decide tudo

Imagem que decora contra imagem que explica. Uma rua bonita à noite não prova que dois sites estão fechados; uma captura do ecrã de verificação prova. Nas peças com prova, a captura ganha sempre à ilustração.

04 · Nunca do zero

Entra quando: ele pede um carrossel, um reel ou um story.

O que faz sem ser pedido: vai buscar o modelo que já existe, em vez de inventar um desenho novo.

A regra

Não se desenha de raiz. Escolhe-se um modelo e troca-se o conteúdo. Se nenhum servir, o trabalho é *acrescentar um modelo ao repertório*, com a mesma anatomia dos outros, e não desenhar uma coisa solta.

O erro que a criou

A 10.09 ele disse: "sempre assumi aquelas fontes e cores... fica muito igual aos outros... faz com que eu fique gastando muitos tokens o tempo todo." Tinha razão nas três. O que gastava tokens não era o HTML: era eu redesenhar seis vezes num dia. Com um modelo escolhido, um carrossel novo é uma lista de textos e de imagens.

Os modelos que existem, em apps/aiemedia-content/docs/

ModeloAnatomiaQuando
blueprint_carrossel_stack.pycabeçalho com número, título pesado com uma palavra a cor, pastilha de preço, captura real numa janelalistas de ferramentas, comparações
blueprint_carrossel_mcp.pyo mesmo, cor terracotao mesmo, outro tema
blueprint_carrossel_cartao.pycartão de tweet dele por cima, imagem grande a sangraropinião e reacção
blueprint_carrossel_imagens.pyimagem gerada a ocupar tudo, texto por cimatemas abstractos
pipeline/base_carrossel.pygeometria fixa, paleta tirada da imagemquando a cor tem de vir da fotografia
blueprint_reel_pergunta.pyinterface neutra, texto a ser escrito, som de tecladoreels de demonstração
blueprint_reel_noticia.pyimagens de lançamento numa banda, gancho por cimanotícias com vídeo

As duas regras de geometria

O material vive no projecto, nunca em /tmp

assets/capturas/. O /tmp é apagado no reinício e os modelos partem-se sem ninguém perceber porquê.

05 · Entrega calada

Entra quando: uma peça fica pronta, ou uma correcção fica feita.

O que faz sem ser pedido: não manda WhatsApp.

A regra

Tudo fica no terminal, com o link da página. Ele abre quando quiser.

Só há duas excepções:

O erro que a criou

Ele disse duas vezes, a 08 e a 09 de Setembro: "não precisa ficar mandando Whats toda hora". Eu concordei à primeira e voltei a fazê-lo na mesma tarde. Isso é pior do que não ter percebido.

O que também não se faz

Mandar uma mensagem por cada correcção intermédia. Se três coisas foram corrigidas, o relato é um parágrafo no terminal, não três mensagens.

06 · Auditoria antes de entregar

Entra quando: antes de mostrar qualquer peça, sempre.

O que faz sem ser pedido: abre e olha, em vez de assumir que correu bem.

A lista

Olhar para cada captura. Uma vez uma captura era só um ecrã de login

do Google, e outra vez o endereço que eu tinha citado dava 404. Só se apanha isso abrindo a imagem.

Ver o texto renderizado, não o código. Uma quebra de linha má, um

acento que não entrou, uma frase cortada ao meio.

Confirmar que o texto cabe. Nada sobreposto, nada a sair do ecrã.
Contraste medido, não estimado. Contra os píxeis reais que estão por

trás das letras, e não contra a cor de fundo teórica.

Cada link devolve 200. Um curl -o /dev/null -w "%{http_code}" em

cada endereço que vai na mensagem.

Pasta nova a cada revisão. O CDN serve com immutable durante um mês:

reescrever um ficheiro com o mesmo nome deixa-o a ver a versão antiga.

Serviço reiniciado se se tocou em código que corre como serviço.

Comparar ActiveEnterTimestamp com a data do ficheiro. O aiemedia-webhook é serviço de utilizador: systemctl --user.

Números com etiqueta, pela skill 02.
Nada de nomes de terceiros expostos, pela skill 01.

Porque é a última e não a primeira

Porque a maior parte dos erros que chegaram a ele este mês não eram erros de construção. Eram erros de não ter olhado.

Fernando Santos · AI&Media
@soueufernandosantos