Como dar contexto à IA com instruções e o cofre do Obsidian

A IA trabalha melhor quando conhece as regras do projeto. No Benflow, você dá esse contexto de três jeitos: as instruções da organização, o cofre pessoal de cada dev (a memória do projeto na máquina de quem trabalha) e o cofre da organização, lido pelo servidor do Benflow.

Instruções para a IA

São as regras do projeto entregues ao Claude em todo trabalho desta organização, inclusive na conversa do modo Claude no Telegram.

1. 1
   Passo 1: Abra Equipe IA e a aba Instruções.
2. 2
   Passo 2: Escreva as regras no campo Instruções para a IA, com até 20.000 caracteres.
3. 3
   Passo 3: Clique em Salvar instruções.

develop é homologação e main é produção.
Correção de produção vai direto na main, nunca da develop para a main.
Lockfile gerado com npm 10.
Consulte o cofre antes de varrer o código.

Só o admin da organização edita. Os outros membros leem o texto na mesma aba.

Cofre do Obsidian da organização

O cofre da organização (no painel, o cofre global) é uma pasta de notas .md, do Obsidian ou de uma pasta do Google Drive, que o servidor do Benflow lê. Ele lê só os arquivos .md, ignora pastas ocultas como .obsidian e nunca escreve no cofre. Reindexa a cada 10 minutos, e a IA consulta as notas antes de varrer o código. Vale para todos os devs da organização, sem configurar nada na máquina de cada um.

Como pedir o cofre da organização

1. 1
   Passo 1: No Google Drive, deixe numa pasta só as notas .md do projeto. Pode ser a pasta do seu cofre do Obsidian. Tire dali o que a IA não deve ler.
2. 2
   Passo 2: Abra um chamado no suporte com o nome da organização e o link da pasta. Não mude o compartilhamento ainda.
3. 3
   Passo 3: A equipe do Benflow responde no chamado com o e-mail do Benflow. Compartilhe a pasta com esse e-mail como Leitor.
4. 4
   Passo 4: Quando a pasta estiver ligada, ela aparece em Equipe IA, aba Conhecimento, em Pasta do cofre global, com as Notas indexadas.

O Benflow só lê a pasta: nunca escreve, move ou apaga nada nela. Para desligar, tire o compartilhamento da pasta no Google Drive e avise o suporte. Quem escolhe a pasta no servidor é sempre a equipe do Benflow: o admin da organização não consegue apontar para outra pasta.

Na aba Conhecimento aparecem a Pasta do cofre global, as Notas indexadas e a Última indexação. O admin da organização tem ainda:

• Testar conexão: confere se a pasta existe, pode ser lida e tem notas .md, sem indexar.
• Reindexar agora: lê o cofre de novo na hora.

Todos podem usar a Busca de teste: digite pelo menos 2 letras para ver as notas que a IA encontraria. Acentos não importam.

Cofre pessoal do dev

Cada dev pode ter um cofre só dele, numa pasta do próprio computador: a do Obsidian ou uma pasta do Google Drive sincronizada pelo Google Drive para computador. Ele é lido só pelo executor, na máquina do dev, e a IA consulta os dois cofres. Para ligar, rode o comando de configurar do executor com a pasta do cofre:

node "<caminho do benflow.mjs>" configurar --url <URL do painel> --cofre /pasta/do/seu/cofre

Como na primeira configuração, o comando pede o token do agente, e os repositórios que você já configurou continuam. Com o executor rodando, o cofre pessoal aparece no card do seu agente, em Nesta máquina, com o número de notas. Veja também como ligar o executor.