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
| Modo | O que faz, e quando usar |
|---|---|
| Manual | Pergunta 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. |
| Planejar | Escreve 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ções | Aplica as alterações de arquivo sem perguntar. Para trabalho repetitivo que você já conferiu. |
| Automático | Decide 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 oschema: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ê.
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ão | Exemplo |
|---|---|
| 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.” |