Hospedagem com 20% de desconto comprando pelo link

Conversando com a IA

Como fazer o briefing para o site nascer certo: contexto do negócio, campos com nome, o que fica de fora, revisar antes de aprovar, os modos de permissão do app e conferir cada mudança.

O que você recebe da IA depende quase todo do que você pede. Ela faz o que você disse, não o que você quis dizer, então a habilidade que faz diferença não é técnica: é descrever com precisão. Estes hábitos valem para qualquer pedido no Velk.

O briefing

O briefing é a descrição que você dá antes de qualquer coisa ser construída. Três coisas sempre entram nele:

  • O negócio, não só o tipo de site. “Uma padaria de bairro que aceita encomenda de bolo” gera campos e textos de exemplo melhores que “um site institucional”.
  • Os campos, com nome. Em vez de “uma seção de depoimentos”, diga “depoimentos, cada um com o texto, o nome da pessoa e a empresa dela”. Pronto: você desenhou o painel.
  • O que não entra, por enquanto. “Por enquanto só Home, Sobre e Contato” evita que ela invente um blog ou uma loja que você não pediu, e que depois dão trabalho para tirar.

Descreva a informação, não o visual: “uma lista de serviços, cada um com nome e resumo” vale mais que “uma seção bonita de serviços”.

Peça à IA

Cria a estrutura de um site para a Padaria Aurora, uma padaria de bairro em Curitiba que aceita encomenda de bolo. Páginas por enquanto: Home, Sobre e Contato. A Home precisa de: - um chapéu curto acima do título - um título principal - um parágrafo de introdução - o texto do botão - uma lista de produtos, cada um com nome, uma descrição de uma linha e uma foto Sobre e Contato são páginas simples: título, introdução e um texto com formatação. Nada de blog, loja ou área de membros por enquanto. Me mostra os nomes dos campos antes de escrever qualquer coisa e valida no fim.

Cada linha da lista vira um campo que o cliente edita no painel.

Página ou tipo de conteúdo?

Uma página é única (uma Home, uma Sobre), com campos próprios e endereço fixo. Um tipo de conteúdo é plural e cresce: posts, cases, serviços, todos com os mesmos campos, criados pelo cliente sem chamar você. Uma pergunta decide: o cliente vai querer criar mais um destes sozinho? Se sim, é tipo de conteúdo. Errar isso é o erro de estrutura mais comum, e o mais caro de corrigir depois. Ao pedir um tipo de conteúdo, dê o nome no plural e o endereço (“Cases, em /cases”); sem isso a IA chuta, e o chute costuma ser em inglês.

Revise antes de aprovar

Leia o que a IA propõe antes de dizer sim, principalmente os nomes dos campos. Um campo tem um rótulo, o texto que quem edita lê, que você muda quando quiser, e um nome, a chave interna que os templates usam. Renomear um campo depois que existe conteúdo deixa os valores antigos órfãos sob o nome antigo, então a primeira revisão é a última hora barata de acertar os nomes.

O aplicativo do Claude pode fazer a IA esperar por você: um seletor de modo, perto do campo de mensagem, decide quanto ela faz sem perguntar. Os nomes podem mudar entre versões do app; o que importa é o que cada modo faz.

Os modos de permissão

ModoO que faz, e quando usar
ManualPergunta antes de qualquer alteração. Use enquanto aprende: você vê cada mudança antes de ela acontecer, e é assim que se aprende o que o Velk está fazendo.
PlanejarEscreve um plano antes de mexer em qualquer coisa. Use em pedidos grandes, como a estrutura inteira de um site: você corrige o plano em vez de desfazer o resultado.
Aceitar ediçõesAplica as alterações de arquivo sem perguntar. Para trabalho repetitivo que você já conferiu.
AutomáticoDecide sozinho o que pode fazer. Quando você já confia no fluxo e quer velocidade.

Confira cada mudança

  • Valide. Depois de qualquer mudança no site.json, peça o schema:validate. Ele acusa erro de estrutura na hora (e, desde a v3.9.0, lista os templates que faltam no tema) em vez de deixar uma página quebrada para a semana que vem.
  • Olhe. Validação verde não é o fim. Abra a página no site e a tela no painel, confirme que o campo aparece e salva, e olhe no celular. Num site com vários idiomas, confira cada um.
  • Uma parte por vez. Peça, revise, confira, e só então siga. Passos pequenos deixam claro qual pedido mudou o quê.
O que a IA roda depois de mexer na estrutura
$ ./bin/velk schema:validate ✓ site.json is valid. # só quando páginas foram criadas ou renomeadas $ ./bin/velk page:sync
Avisos, como um template faltando, não reprovam a validação, mas valem a leitura.

Peça à IA

Na Home, acrescenta uma seção de depoimento com o texto, o nome da pessoa e a empresa dela. Valida o site.json e me diz onde isso aparece no painel.

O ciclo de todo dia: peça dizendo que informação guardar, revise os nomes, confira o site e o painel.

Quando algo dá errado

Descreva como descreveria para um colega: o sintoma, onde acontece e o que mudou por último. “Depois que atualizei o motor, a página de contato dá erro 500” leva a IA direto ao lugar certo; “o site quebrou”, não. Na dúvida, peça para ela explicar antes de mudar qualquer coisa.

Padrões que valem repetir

PadrãoExemplo
Explicar antes“Antes de mudar qualquer coisa, me diz quais arquivos você mexeria e por quê.”
Limitar o escopo“Muda só o rodapé. Não mexe no cabeçalho nem na Home.”
Pedir opções“Me dá dois jeitos de organizar os serviços, com os prós e contras de cada um.”
Apontar o que você vê“No celular, o menu cobre o logo na página de Contato.”
Pedir a prova“Abre a página e confirma que a seção nova aparece nos dois idiomas.”