Siga estas diretrizes para aproveitar ao máximo a sua experiência com o Bob Shell.

Comece com o modo Plan para novos projetos ou funcionalidades complexas, a fim de criar um plano detalhado de implementação antes de escrever qualquer código. Leia o plano com atenção para confirmar que está alinhado com seu objetivo.

Mude para o modo Agent para a maioria das tarefas do dia a dia quando estiver pronto para implementar.

Use o modo Ask quando precisar de explicações ou informações sem modificar arquivos.

Alterne entre modos em uma sessão bob chat digitando /mode agent, /mode plan ou /mode ask. Para mais detalhes, veja Modos.

Modos personalizados

Você pode criar modos especializados para tarefas ou fluxos de trabalho específicos:

Crie modos para tarefas especializadas, como revisões de segurança ou escrita de documentação.

Configure modos personalizados com permissões de acesso a ferramentas e definições de papel específicas.

Compartilhe modos com sua equipe para padronizar fluxos de trabalho.

Saiba mais sobre como criar e configurar modos personalizados na documentação de Modos personalizados.

Otimização de fluxo de trabalho

Planeje antes de codificar

Sempre inicie projetos ou funcionalidades complexas no modo Plan para:

Gerar um plano detalhado de implementação.

Dividir problemas complexos em etapas gerenciáveis.

Identificar desafios potenciais antes que surjam.

Criar um roteiro para a implementação.

Essa abordagem previne mudanças que quebram o funcionamento e fornece uma direção clara para o desenvolvimento.

Use o git como rede de segurança

Faça commits do seu trabalho frequentemente para poder se recuperar de mudanças indesejadas:

Crie commits frequentes e pequenos com mensagens claras.

Envie mudanças para repositórios remotos regularmente.

Use branches para funcionalidades experimentais.

Se o Bob produzir resultados ruins, reverter para um commit anterior é mais eficaz do que tentar corrigir saídas com falhas usando novas instruções. Inicie uma nova sessão bob chat após reverter para que a saída incorreta não esteja mais no contexto.

Monitore o uso e otimize custos

Acompanhe o consumo de Bobcoins revisando o uso da sua conta. Fique atento ao tamanho da janela de contexto — conversas longas consomem mais tokens e, portanto, mais Bobcoins.

Integre com controle de versão

O Git fornece uma rede de segurança essencial para evitar a exclusão acidental e permanente de código. Faça commits regularmente antes e depois de mudanças significativas assistidas por IA.

Estratégias de comunicação

Escreva prompts eficazes

A qualidade dos seus prompts afeta diretamente a qualidade das respostas do Bob:

Seja específico e claro: Prompts vagos levam a saídas vagas. Detalhe o que o Bob deve e não deve fazer.

Forneça exemplos: Quando possível, inclua exemplos do formato ou estilo de saída desejado.

Use menções de contexto

Menções de contexto permitem referenciar elementos específicos do seu projeto diretamente nas conversas com o Bob Shell:

Use @/caminho/para/arquivo.js para incluir conteúdos de arquivos específicos.

Use @/caminho/para/pasta para incluir todos os arquivos de um diretório.

bob chat

# Referenciar um arquivo específico
> Explique o que @src/utils.js faz e como funciona

# Referenciar um diretório
> Revise os testes em @tests/ e identifique lacunas

Essa abordagem é mais eficiente do que copiar e colar código ou descrever localizações de arquivos.

Gerencie a janela de contexto

O Bob tem uma janela de contexto de 270.000 tokens, que inclui o histórico da conversa, conteúdos de arquivos e saída de ferramentas. Para usá-la de forma eficaz:

Inicie novas sessões bob chat regularmente com objetivos específicos.

Evite fornecer toda a base de código ao Bob de uma vez.

Use referências diretas a arquivos para fornecer contexto específico.

Divida tarefas complexas em subtarefas menores e focadas.

Veja Gerenciamento da janela de contexto para uma explicação mais detalhada de como a janela de contexto funciona e estratégias para gerenciá-la.

Segurança e controle

Configure as definições de aprovação automática

O Bob Shell permite controlar quais ações requerem sua aprovação antes de serem executadas:

Aprovação manual: Revise e aprove cada ação do Bob (configuração mais segura).

Aprovação automática: Conceda ao Bob a capacidade de executar tarefas específicas sem interrupção.

Abordagem híbrida: Aprove automaticamente ações de baixo risco enquanto exige confirmação para tarefas mais arriscadas.

Comandos com aprovação automática: Defina uma lista de comandos confiáveis que o Bob pode executar sem solicitar aprovação a cada vez.

Configure essas definições em ~/.bob/settings/settings.json com base no seu nível de conforto e na sensibilidade do projeto.

Saiba mais sobre as configurações de aprovação automática na documentação de Aprovação automática de ações.

Use .bobignore

O arquivo .bobignore permite especificar arquivos e diretórios que o Bob não deve acessar ou modificar:

Crie um arquivo .bobignore na raiz do seu projeto.

Adicione padrões para arquivos sensíveis, artefatos de build e assets grandes.

Use a mesma sintaxe do .gitignore.

Isso ajuda a proteger informações sensíveis e prevenir mudanças acidentais em arquivos gerados.

Saiba mais sobre como controlar o acesso a arquivos na documentação de Ignorar arquivos.

Para informações mais detalhadas sobre diretrizes de segurança, veja Diretrizes de segurança.

Configure regras

O Bob permite especificar regras para controlar como ele executa tarefas:

Defina regras globalmente ou por projeto no diretório .bob.

Crie regras específicas por modo em diretórios .bob/rules-{mode-slug}/.

Use regras para aplicar padrões de codificação, requisitos de documentação ou outras restrições de fluxo de trabalho.

Para mais informações sobre modos personalizados e regras, veja a documentação de Modos personalizados.

Modo	Propósito	Quando usar
Agent	Escrever e modificar código	Para implementar funcionalidades, corrigir bugs ou fazer melhorias no código
Plan	Planejar e projetar	Antes da implementação, quando você precisa planejar a arquitetura ou criar especificações técnicas
Ask	Obter informações	Quando você precisa de explicações ou informações sem modificar arquivos

Melhores práticas

Entendendo e usando modos

Modos integrados

Estratégia de seleção de modo