Vincular Projetos de IA Diretamente ao TandemLoop – Ajuda

Se você já trabalha com uma ferramenta de IA em um projeto específico — por exemplo, um repositório de código —, não precisa informar ao agente o caminho da pasta de dados toda vez. Em vez disso, crie no diretório do projeto um link para a sua pasta de dados do TandemLoop. Assim, o agente encontra a base de tarefas comum diretamente “ao lado” do código.

Para que serve o vínculo?

Sua ferramenta de IA costuma trabalhar em um diretório de trabalho fixo (a pasta do projeto). Um link simbólico (symlink) leva sua pasta de dados para lá como subpasta — sem copiar os arquivos. Assim, no CLAUDE.md ou AGENTS.md do seu projeto, basta registrar: “Para tarefas, leia o AGENTS.md na pasta vinculada.” O agente lê as regras de lá e trabalha com suas tarefas do TandemLoop enquanto trabalha no próprio projeto.

Passo 1: ver o caminho da pasta de dados

Ajustes › Pasta de Dados › Ver o caminho (ou “Abrir no Finder”)

Passo 2: criar o symlink

No diretório do projeto, execute um destes comandos. Substitua <CAMINHO-DA-PASTA-DE-DADOS> pelo caminho do passo 1. Aqui, o link se chama tandemloop:

macOS / Linux:

ln -s "<CAMINHO-DA-PASTA-DE-DADOS>" tandemloop

Windows (PowerShell):

New-Item -ItemType SymbolicLink -Name tandemloop -Target "<CAMINHO-DA-PASTA-DE-DADOS>"

Não faça commit da pasta de dados no repositório. Se o projeto estiver no Git, adicione o link ao .gitignore, para que o conteúdo da pasta de dados não acabe, sem querer, no repositório:

echo "tandemloop" >> .gitignore

Passo 3: avisar o agente

Adicione uma seção curta ao CLAUDE.md ou AGENTS.md do seu projeto. Modelo para copiar:

## Tarefas e gerenciamento de projetos (TandemLoop)

As tarefas, os projetos e o status deles são gerenciados no TandemLoop. A pasta de dados
está vinculada a este projeto como `./tandemloop`. Se quiser ler, criar ou editar
tarefas ou mudar o status delas, leia primeiro `./tandemloop/AGENTS.md`
e siga rigorosamente as regras descritas ali.

A partir de agora, no projeto, basta uma indicação como “Veja no TandemLoop as tarefas pendentes” — o agente segue o link e as regras definidas ali.

Tudo de uma vez: peça por prompt

Você também pode deixar os passos 2 e 3 para a sua ferramenta de IA. Copie este prompt, substitua o caminho e passe-o ao agente — com o caminho já preenchido, você também o encontra no fim do Tutorial do Agente (Mac):

Crie neste diretório de projeto um link simbólico chamado `tandemloop`
que aponte para a minha pasta de dados do TandemLoop: <CAMINHO-DA-PASTA-DE-DADOS>. Se houver
um repositório Git aqui, adicione `tandemloop` ao .gitignore. Em seguida, adicione ao
AGENTS.md (ou CLAUDE.md) deste projeto uma seção que instrua você a ler primeiro
`./tandemloop/AGENTS.md` para tarefas e gerenciamento de projetos e a seguir as regras
dele.

Vários projetos, uma pasta de dados. Você pode criar esse link para a mesma pasta de dados em quantas pastas de projeto quiser. Assim, todos os seus projetos de IA acessam a mesma base de tarefas. Só cuide para que vários agentes não escrevam ao mesmo tempo — veja Colaborar de Forma Autônoma e Contínua.

As regras completas de escrita para agentes estão em Colaboração com Agentes de IA.