Padronize o comportamento do Bob em sua equipe usando arquivos de regras em nível de projeto que instruem o Bob a documentar seu código e lembrar de suas ações anteriores.

As regras do Bob são arquivos de texto simples que definem instruções aplicadas a cada conversa com o Bob. O Bob armazena regras como arquivos em uma pasta designada dentro do projeto ou no nível de usuário global e injeta automaticamente o conteúdo de cada arquivo de regras em cada conversa em todos os modos. A injeção de regras permite que equipes e desenvolvedores individuais apliquem padrões de codificação, preferências de comunicação e restrições de fluxo de trabalho sem repetir instruções em cada prompt.

As regras em nível de projeto em galaxium-travels/.bob são controladas por versão junto com seu código, o que significa:

As regras se propagam automaticamente para todos os membros da equipe que clonam o repositório.

As alterações nas regras passam pelo processo normal de revisão de código.

O histórico de regras é rastreado no git.

Neste tutorial, você instrui o Bob a falar de forma concisa, documentar seu código e lembrar de suas ações anteriores adicionando arquivos de regras no diretório .bob. Como você incluirá esses arquivos no controle de versão, o Bob os aplicará em toda a sua equipe.

Pré-requisitos

Para concluir este tutorial, você precisa do seguinte:

Se você ainda não o tem, clone o código de demonstração do Galaxium Travels. O comando de clonagem também verifica o branch bob-learning-path-branch que contém o código que você usa nos tutoriais.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Bob IDE com o código de demonstração do Galaxium Travels aberto

Complete o tutorial Iniciar um projeto para criar a pasta .bob.

Embora não seja obrigatório, considere fazer o Tutorial de início rápido para se familiarizar com a interface e os recursos do Bob.

Python ou Python 3. Você pode baixar o Python no site oficial.

Criar um arquivo de regras personalizado do Bob

O comando /init do Bob cria uma pasta .bob com arquivos AGENTS.md para cada modo do Bob que direciona o comportamento do Bob em cada modo. Crie suas próprias regras personalizadas adicionando um novo arquivo à pasta rules. O Bob lerá o conteúdo do arquivo de regras, o que significa que as instruções que você adicionar se aplicarão a todas as interações com o Bob.

Criar a pasta de regras

Se uma pasta rules ainda não existir em .bob, crie uma.

Criar o arquivo de regras

Crie um arquivo em galaxium-travels/.bob/rules/ chamado basic_rules.md.

O arquivo .bob/rules/basic_rules.md criado no projeto

Criar regras personalizadas do Bob

No arquivo basic_rules.md, crie regras personalizadas adicionando o seguinte texto:

Adicionar uma regra de padrão de documentação

Always include concise JSDoc strings for every public function.

A regra de padrão de documentação garante que o Bob gere documentação consistente sempre que o Bob escreve ou modifica funções públicas, independentemente da tarefa.

Adicionar uma regra de estilo de comunicação

Be very concise in your wording.

A regra de estilo de comunicação controla como o Bob formula respostas e comentários, o que é útil para equipes que preferem saídas concisas e diretas em vez de explicações detalhadas.

Adicionar uma regra de monólogo interno

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

O monólogo interno produz um registro persistente de tudo o que o Bob fez em todas as conversas.

Os benefícios do monólogo interno incluem o seguinte:

Trilha de auditoria: Um registro de quais alterações o Bob fez e quando.
Continuidade entre sessões: O Bob pode fazer referência à pasta de monólogo interno em conversas futuras para entender o trabalho anterior.
Transparência da equipe: Em repositórios compartilhados, o monólogo mostra o que diferentes membros da equipe fizeram com o Bob.

Depois de adicionar todas as regras, seu arquivo basic_rules.md ficará assim:

O arquivo basic_rules.md com todas as três regras personalizadas adicionadas

Testar as regras

Abra a barra lateral de chat agêntico, mude para o modo Código e execute o seguinte prompt para que o Bob edite o README.md. O Bob pode fazer sugestões como melhorar com melhor solução de problemas, revisão completa ou corrigir imprecisões. Você pode escolher a sugestão que melhor se adapta à sua visão para o README.

Update the readme

O Bob atualiza o README.md e cria uma pasta chamada internal-monologue e cria um arquivo que mostra as atualizações que ele fez no README.

Bob atualiza o README.md e cria um arquivo de monólogo interno

Próximos passos

Neste tutorial, você aprendeu como as regras do Bob permitem definir instruções persistentes que se aplicam a cada conversa e modo. As regras em nível de projeto são controladas por versão junto com seu código, então sua equipe compartilha automaticamente os mesmos padrões. O padrão de monólogo interno fornece uma trilha de auditoria das ações do Bob em todas as sessões.

Avance para Adicionar capacidades do Bob para aprender sobre a criação de modos personalizados que definem personas especializadas com instruções personalizadas e acesso específico a ferramentas.

Padronizar o comportamento do Bob