Especificações e contexto

Defina um contrato para a alteração#

Trate o pedido como uma especificação contra a qual o resultado possa ser verificado. Identifique a tela ou componente, o formato dos dados, as ações, os estados de falha e o que está fora do escopo. Em um projeto existente, indique os comportamentos que devem permanecer.

• Entradas: nomes e tipos dos campos, exemplos válidos e inválidos e fonte de verdade.
• Transições: estado inicial, carregamento, sucesso, vazio, erro e comportamento da repetição.
• Dependências: diferencie dados simulados, armazenamento no navegador, backend compartilhado e serviços externos.
• Invariantes: regras de autorização, campos imutáveis, ordenação e comportamento público existente.

Peça uma implementação delimitada#

Alvo: tela existente de lista de tarefas.
Alteração: adicionar filtro de status com valores all/open/closed.
Contrato de dados: { id: string, title: string, status: 'open' | 'closed' }.
Preservar: IDs, ordenação existente, navegação para detalhes e tokens visuais.
Estado vazio: mensagem clara e ação Limpar filtros.
Aceite:
- Filtro e busca textual funcionam juntos.
- Limpar restaura a ordem original.
- Filtragem local não acrescenta chamada de rede.
- Controles têm rótulos acessíveis e foco por teclado.
Retorno: arquivos alterados, validação executada e dependências pendentes.

Forneça contexto de referência delimitado#

O composer de Sites aceita menções a fontes, URLs de referência, arquivos de texto compatíveis e imagens. Declare qual aspecto da referência é obrigatório: schema, conteúdo, layout ou comportamento. Uma URL fornece contexto; não autoriza acesso a contas nem importa o backend do sistema referenciado.

Os formatos de texto aceitos incluem TXT, Markdown, CSV, JSON, HTML, CSS, JavaScript e TypeScript. Esse caminho espera UTF-8, não documentos binários. O contexto de menções tem limite próprio, separado do tamanho do arquivo; use o menor trecho que preserve o contrato, em vez de anexar toda a árvore de dependências.

Separe geração e avaliação#

Mantenha critérios concretos o suficiente para executar manualmente ou no seu ambiente de testes. Pedir testes não comprova que foram executados: confira a validação relatada e reproduza os comportamentos críticos. Diferencie dependências implementadas, simuladas e indisponíveis no resultado.

Use registros sintéticos e marcadores para credenciais. Conecte serviços pelos controles próprios depois de definir fluxo de dados, permissões e responsabilidade pelas cobranças.