Skip to main content
O Agent cria automaticamente este arquivo no diretório raiz do seu projeto usando práticas recomendadas comprovadas. O Agent inclui seu conteúdo no contexto para ajudá-lo a entender suas preferências, estrutura do projeto e estilo de codificação.
Agent usando replit.md para construir um projeto

Como o replit.md funciona

O Agent primeiro cria um arquivo replit.md no diretório raiz do seu projeto usando práticas recomendadas comprovadas. Este arquivo inclui:
  • Informações básicas do projeto
  • Padrões de codificação recomendados
  • Preferências comuns para o tipo do seu projeto
Quando o Agent processa suas solicitações, ele lê automaticamente o arquivo replit.md e usa seu conteúdo para:
  • Entender a arquitetura e as convenções do seu projeto
  • Seguir seus padrões e estilos de codificação preferidos
  • Usar os gerenciadores de pacotes e dependências especificados
O Agent também pode atualizar o arquivo replit.md à medida que aprende mais sobre o seu projeto e faz alterações na sua aplicação.
Você pode editar o arquivo replit.md para personalizar o comportamento do Agent.

Configurando o replit.md

Geração automática

Quando você cria um novo projeto com o Agent, ele gera automaticamente um arquivo replit.md usando práticas recomendadas comprovadas. Este arquivo aparece no diretório raiz do seu projeto e inclui:
  • Informações básicas do projeto
  • Padrões de codificação recomendados
  • Preferências comuns para o tipo do seu projeto

Criação manual

Você pode criar seu próprio arquivo replit.md adicionando um novo arquivo chamado replit.md no diretório raiz do seu projeto. O Agent detectará e usará automaticamente esse arquivo em conversas futuras.
O replit.md deve estar localizado no diretório raiz do seu projeto para funcionar corretamente.

Regenerando o replit.md

Se o arquivo replit.md ficar corrompido ou você quiser começar do zero:
  1. Delete o arquivo replit.md existente do diretório raiz do seu projeto
  2. Inicie uma nova conversa com o Agent
  3. O Agent gerará automaticamente um novo arquivo replit.md com base no seu projeto atual

Práticas recomendadas

Seja específico e claro

Escreva instruções claras e específicas que ajudem o Agent a entender exatamente o que você quer:
Para um guia mais detalhado sobre formatação de prompts, confira o guia de engenharia de prompts da Anthropic.

Use exemplos

Exemplos ajudam o Agent a entender suas preferências melhor do que descrições abstratas:

Defina preferências de comunicação

Diga ao Agent como você prefere receber informações e atualizações:

Especifique o contexto do projeto

Ajude o Agent a entender o propósito e as restrições do seu projeto:

Exemplos de configurações do replit.md

Projeto de aplicação web

Projeto de análise de dados

Projeto de desenvolvimento de API

Uso avançado

Orientação dinâmica do projeto

Atualize o arquivo replit.md à medida que o projeto evolui para fornecer contexto atualizado:

Integração com ferramentas externas

Referencie documentação externa e ferramentas no seu replit.md:

Combinando pesquisa na web com replit.md

O Agent pode realizar pesquisas na web para encontrar informações atuais, bibliotecas e soluções. Combinado com o arquivo replit.md, você obtém tanto conhecimento atualizado quanto orientação específica do projeto.

Práticas recomendadas para integração com pesquisa na web

Seja específico sobre o que você quer que o Agent pesquise:
Oriente o Agent sobre como aplicar o conhecimento externo:
Exemplo de solicitação que aproveita ambos: “Pesquise as técnicas mais recentes de otimização de desempenho do React 18 e implemente-as seguindo os padrões de componentes definidos no replit.md Esta abordagem fornece soluções que são tanto atuais quanto adaptadas às necessidades específicas do seu projeto.

Limitações

Limites de tamanho e conteúdo do arquivo

Embora não haja limite estrito de caracteres para o replit.md, arquivos muito grandes podem não ser processados completamente. Mantenha o replit.md focado e conciso para obter melhores resultados.

Requisito de diretório raiz

O replit.md deve existir no diretório raiz do seu projeto. O Agent não detectará automaticamente arquivos em subdiretórios.

Escopo do contexto

O replit.md fornece contexto para conversas com o Agent, mas não se aplica automaticamente a outras ferramentas de IA.

Próximos passos

Pronto para personalizar o Agent para o seu projeto?
  1. Comece simples: Crie um replit.md básico com suas principais preferências
  2. Itere e melhore: Atualize o replit.md enquanto trabalha com o Agent
  3. Compartilhe padrões: Use configurações bem-sucedidas de replit.md em projetos similares
  4. Monitore a eficácia: Preste atenção em quão bem o Agent segue suas diretrizes e ajuste conforme necessário
Saiba mais sobre como trabalhar com o Agent ou explore outras ferramentas de IA. Enterprise: Pré-configure o replit.md em templates personalizados para dar a todos os construtores da sua organização um contexto inicial consistente. Para orientação específica de design, consulte como configurar um design system.