Executa o comando /init do Bob Shell para gerar AGENTS.md, um ficheiro de contexto do projeto que o Bob carrega em cada conversa, e aprende a manter esse contexto atualizado.

O comando /init analisa um projeto e gera um ficheiro de resumo estruturado chamado AGENTS.md que o Bob usa como contexto persistente em cada conversa. O comando /init é a forma como dás ao Bob conhecimento sobre a estrutura, convenções e base de código de um projeto — sem exigir que o Bob releia cada ficheiro no início de cada interação.

Os large language models são sem estado. Cada nova conversa começa sem memória das interações anteriores. Sem contexto explícito do projeto, o Bob tem de descobrir a base de código a cada nova interação, o que é ineficiente e torna-se impraticável à escala.

Neste tutorial, inicializas o Bob Shell no diretório raiz de uma aplicação demo, explores o contexto que o Bob ganha sobre a aplicação e aprendes como o Bob Shell carrega ficheiros AGENTS.md.

Pré-requisitos

Para completar este tutorial, precisas do seguinte:

Bob Shell

Instala o Bob Shell v2.x ou posterior e inicia sessão.

Git

Instala o Git para clonar o repositório de exemplo.

Se ainda não o tens, clona o código demo Galaxium Travels. O comando clone também faz checkout do bob-learning-path-branch que contém o código usado nos tutoriais.

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

Embora não seja obrigatório, considera ler Iniciar uma sessão interativa para te familiarizares com a interface e as funcionalidades do Bob Shell.

Iniciar o Bob Shell no projeto

Muda para o diretório raiz do Galaxium Travels:

cd galaxium-travels

Inicia uma sessão interativa:

bob chat --mode agent

A flag --mode agent inicia a sessão no modo Agent, que tem as ferramentas que o Bob precisa para ler ficheiros e escrever AGENTS.md.

Se o Bob Shell perguntar se confias na pasta, confia nela para que o Bob possa trabalhar no projeto. Para saber mais, consulta Pastas confiáveis.

Gerar AGENTS.md com /init

Insere o comando /init na prompt:

/init

O Bob lê os ficheiros relevantes no projeto.

Quando o Bob pede para usar uma ferramenta, como ler ficheiros ou escrever AGENTS.md, aparece o diálogo de aprovação. Seleciona Approve para cada pedido.

O Bob gera o ficheiro principal AGENTS.md no diretório raiz do Galaxium Travels. Também gera ficheiros de contexto específicos de modo em .bob/rules-agent/AGENTS.md, .bob/rules-ask/AGENTS.md e .bob/rules-plan/AGENTS.md.

Explorar os ficheiros AGENTS.md

O ficheiro AGENTS.md é documentação de integração para o Bob. É um resumo conciso e acionável que fornece tudo o que o Bob precisa para compreender a estrutura e as convenções do projeto.

Pede ao Bob para te mostrar o ficheiro:

Show me the contents of @AGENTS.md

O símbolo @ referencia um ficheiro no teu projeto, por isso o Bob lê-o antes de responder. Podes também abrir outro terminal e visualizar o ficheiro diretamente:

cat AGENTS.md

O ficheiro AGENTS.md normalmente contém os seguintes componentes:

Visão geral e finalidade do projeto

Estrutura de diretórios e localizações de ficheiros-chave

Stack tecnológico e dependências

Padrões arquiteturais e convenções

Fluxos de trabalho de desenvolvimento

Para ver todos os ficheiros que o /init criou, executa git status no diretório do Galaxium Travels:

git status

Como o Bob Shell carrega ficheiros AGENTS.md

O Bob Shell carrega automaticamente ficheiros de contexto como AGENTS.md no início de cada tarefa.

Contexto global: ~/.bob/AGENTS.md aplica-se a todos os projetos.

Contexto do projeto: AGENTS.md na raiz do projeto e nos diretórios pai aplica-se ao projeto.

Contexto local: AGENTS.md em subdiretórios aplica-se a esse subdiretório, para instruções específicas de componente.

Para dar ao Bob instruções para um único modo, adiciona regras específicas de modo em diretórios .bob/rules-<mode>/, como .bob/rules-plan/ para o modo Plan.

Manter os ficheiros AGENTS.md

Volta a executar /init após as seguintes alterações:

Adicionar novos módulos ou serviços

Alterar a estrutura de diretórios

Adotar novas tecnologias ou frameworks

Integrar novos membros da equipa que usam o Bob

Podes também editar manualmente AGENTS.md para adicionar contexto que a análise automatizada do Bob pode não capturar, como regras de negócio, convenções de deployment ou práticas específicas da equipa. Faz commit de AGENTS.md no controlo de versões para que a tua equipa partilhe o mesmo contexto.

Próximos passos

Neste tutorial, aprendeste o seguinte:

Os large language models são sem estado. Executar o comando /init resolve este problema gerando AGENTS.md, que é um ficheiro de contexto persistente que o Bob lê no início de cada conversa.

Volta a executar /init após grandes alterações no projeto para manter o contexto atualizado.

Avança para Escrever prompts eficazes para o Bob Shell para aprender a escrever prompts que produzem de forma fiável o output que queres.

Iniciar um projeto com /init e AGENTS.md no Bob Shell