O usuário solicita modificações no estilo de UI de uma página (ajustes visuais como layout, espaçamento, cores, combinação de componentes). O processo é realizado por meio de um fluxo colaborativo estruturado, garantindo que cada etapa esteja alinhada ao objetivo, sem suposições inúteis.
Princípios básicos
- Não suponha, não se antecipe — Nunca mexa no código antes de alinhar o objetivo.
- Captura de tela é a primeira linguagem — Peça ativamente ao usuário que forneça capturas de tela para localizar o problema.
- Desenhe a solução com ASCII — Propostas de layout devem ser desenhadas em ASCII; descrições textuais podem gerar ambiguidade.
- Altere apenas um ponto por vez — Não faça várias alterações ao mesmo tempo; aproxime-se gradualmente do objetivo.
Fluxo de trabalho
Etapa 1: Localizar o problema
Quando o usuário disser que quer modificar algo, faça duas coisas:
- Leia o código — Leia os arquivos relevantes para entender a implementação atual.
- Descreva o estado atual — Desenhe o layout atual com ASCII e confirme com o usuário: "É isso que estou vendo, certo?"
Exemplo:
┌─────────────────────────────────────────────┐
│ 📈 Título [🔄] │
│ Texto descritivo do subtítulo │
│ 🔍 [Caixa de pesquisa... ] │
├─────────────────────────────────────────────┤
Proibido: Pular esta etapa e perguntar diretamente "Como você gostaria que fosse?". Primeiro, o usuário deve confirmar que você entendeu o estado atual.
Etapa 2: Apresentar soluções
Ofereça de 2 a 3 soluções, cada uma contendo:
- Diagrama de layout ASCII — Mostre como ficará após a alteração.
- Explicação de uma frase — Qual é a ideia principal dessa solução.
Exemplo:
Solução A: Pesquisa e atualização na mesma linha
┌──────────────────────────────────────────┐
│ 🔍 [Caixa de pesquisa... ] [🔄] │
└──────────────────────────────────────────┘
Solução B: Atualização movida para a linha do título
┌──────────────────────────────────────────┐
│ 📈 Título [🔄] │
│ 🔍 [Caixa de pesquisa... ] │
└──────────────────────────────────────────┘
Proibido:
- Oferecer apenas uma solução (o usuário não tem opção).
- Oferecer mais de 3 soluções (dificuldade de escolha).
- Soluções apenas com texto, sem diagrama ASCII.
Etapa 3: Aguardar a escolha do usuário
Após o usuário escolher a solução, comece a escrever o código.
Proibido: Começar a alterar o código antes da escolha do usuário.
Etapa 4: Alterar o código
Execute a alteração mínima, modificando apenas a parte envolvida na solução selecionada.
Proibido: Ajustar outras partes 'de quebra', otimizar a estrutura do código ou adicionar comentários.
Etapa 5: Ajustes finos
Após a alteração, deixe o usuário ver o resultado. O usuário pode solicitar ajustes finos:
- "Adicione uma borda"
- "A cor está muito escura"
- "Aumente o espaçamento"
Os ajustes finos são específicos e pequenos; execute-os diretamente, sem passar pelo processo de seleção de solução.
Se o feedback do usuário não for específico (como "Não parece certo"), pergunte ativamente:
- "É problema de tamanho, cor ou posição?"
- "Qual elemento ao lado não combina?"
Normas de comunicação
O que o usuário deve fornecer
| Informação | Descrição |
|---|---|
| Captura de tela | Marque a área que deseja modificar |
| Descrição do problema | "Esses dois elementos não combinam", "Espaçamento muito grande" |
| Seleção de solução | Escolha uma das soluções apresentadas |
O que o AI deve fazer
| Etapa | Saída |
|---|---|
| Localização | Diagrama ASCII do estado atual |
| Solução | 2 a 3 diagramas ASCII + explicação de uma frase |
| Código | Alteração mínima, apenas na solução selecionada |
| Ajuste fino | Executar ajustes específicos diretamente |
O que o AI nunca deve fazer
- Quando o usuário disser "Altere o layout", adivinhar e modificar o código diretamente.
- Enviar grandes blocos de refatoração de uma só vez.
- Durante ajustes finos, ainda apresentar múltiplas soluções para o usuário escolher.
- Ajustar áreas que o usuário não mencionou.