Collegare i progetti IA direttamente a TandemLoop – Aiuto

Se in un determinato progetto, ad esempio un repository di codice, lavori già con uno strumento IA, non devi indicare ogni volta al tuo agente il percorso della cartella dati. Crea invece nella directory del progetto un link alla tua cartella dati di TandemLoop. Così l’agente trova la vostra base di attività comune direttamente “accanto” al codice.

A cosa serve un collegamento?

Di solito il tuo strumento IA lavora in una directory di lavoro fissa (la cartella del progetto). Un link simbolico (symlink) porta lì la tua cartella dati come sottocartella, senza copiare i file. Così nel CLAUDE.md o AGENTS.md del tuo progetto puoi semplicemente annotare: “Per le attività leggi AGENTS.md nella cartella collegata.” L’agente legge da lì le regole e lavora con le tue attività di TandemLoop mentre lavora al progetto stesso.

Passo 1: leggi il percorso della cartella dati

Impostazioni › Cartella dati › leggi il percorso (oppure “Apri nel Finder”)

Passo 2: crea il symlink

Esegui nella directory del progetto uno di questi comandi. Sostituisci <PERCORSO-CARTELLA-DATI> con il percorso del passo 1. Qui il link si chiama tandemloop:

macOS / Linux:

ln -s "<PERCORSO-CARTELLA-DATI>" tandemloop

Windows (PowerShell):

New-Item -ItemType SymbolicLink -Name tandemloop -Target "<PERCORSO-CARTELLA-DATI>"

Non fare il commit della cartella dati nel repository. Se il tuo progetto è in Git, aggiungi il link al file .gitignore, così il contenuto della cartella dati non entra per errore nel repository:

echo "tandemloop" >> .gitignore

Passo 3: informa l’agente

Aggiungi una breve sezione al CLAUDE.md o AGENTS.md del tuo progetto. Modello da copiare:

## Attività e gestione dei progetti (TandemLoop)

Attività, progetti e il loro stato sono gestiti in TandemLoop. La cartella dati è
collegata a questo progetto come `./tandemloop`. Se vuoi leggere, creare,
modificare attività o cambiarne lo stato, leggi prima `./tandemloop/AGENTS.md`
e rispetta rigorosamente le regole lì descritte.

Da questo momento nel progetto basta un’indicazione come “Guarda in TandemLoop se ci sono attività aperte”: l’agente segue il link e le regole che trova lì.

Tutto in un passo: fallo creare con un prompt

Puoi far svolgere i passi 2 e 3 anche al tuo strumento IA. Copia questo prompt, sostituisci il percorso e passalo al tuo agente; con il percorso già inserito lo trovi anche alla fine del Tutorial agenti (Mac):

Crea in questa directory di progetto un link simbolico chiamato `tandemloop`
che punta alla mia cartella dati di TandemLoop: <PERCORSO-CARTELLA-DATI>. Se qui c'è un
repository Git, aggiungi `tandemloop` al file .gitignore. Poi aggiungi all'AGENTS.md
(o CLAUDE.md) di questo progetto una sezione che ti indichi, per la gestione di
attività e progetti, di leggere prima `./tandemloop/AGENTS.md` e di rispettarne
le regole.

Più progetti, una cartella dati. Puoi creare un link di questo tipo alla stessa cartella dati in quante cartelle di progetto vuoi. Così tutti i tuoi progetti IA accedono alla stessa base di attività. Fai solo attenzione che più agenti non scrivano contemporaneamente: vedi Collaborare in modo autonomo e continuativo.

Le regole di scrittura complete per gli agenti si trovano in Collaborare con gli agenti IA.