Collaborare con gli agenti IA

TandemLoop è pensato fin dall’inizio perché agenti IA esterni lavorino sugli stessi dati come partner alla pari. L’app non contiene un’IA: colleghi tu uno strumento IA agentico a tua scelta (vedi Collegare uno strumento IA). La cartella dati non usa un formato chiuso, ma testo semplice in Markdown che ogni strumento può leggere. Vale comunque un contratto di lavoro chiaro: sei tu a decidere cosa succede alla tua struttura.

Il principio del tandem

L’immagine del tandem descrive bene la collaborazione: tu stai davanti e indichi la direzione; l’agente sta dietro e fornisce la spinta. Nessuno dei due agisce di testa propria. Per l’app questo significa:

• Tu definisci visione, priorità, relazioni e decisioni.
• Lo strumento IA tiene la visione d’insieme, prepara, ricorda, riconosce schemi e suggerisce azioni.

Come gli agenti lavorano con la cartella dati

Gli agenti IA leggono la cartella dati come qualsiasi altro strumento: navigano nella struttura delle cartelle e leggono il frontmatter YAML e il corpo Markdown. Cosa possono scrivere dipende da se hai attivato le proposte:

I tag esistenti li rinomini o li elimini tu nell’app. Indipendentemente dall’impostazione, un agente può creare attributi personalizzati e temi e, su tua richiesta, impostare un promemoria su qualsiasi attività aperta. In entrambi i casi è vietato modificare direttamente _archive/, _system/, _conflicts/, le impostazioni dell’app in _config/ e il blocco gestito in AGENTS.md.

A ogni ciclo l’agente annota l’ora in _config/agent.yaml (last_run). Da qui TandemLoop mostra in Di ritorno dall’agente › Presso l’agente quando ha lavorato l’ultima volta: vedi Collaborare in modo autonomo e continuativo.

Attivare o disattivare le proposte

Le proposte sono facoltative e disattivate per impostazione predefinita. Le attivi in qualsiasi momento nelle impostazioni:

L’impostazione vale per l’intera cartella dati. Se è disattivata, TandemLoop nasconde tutte le sezioni delle proposte; i file di proposta già presenti restano invariati e riappaiono non appena riattivi le proposte.

Proposte: modifiche che approvi tu

Con le proposte attive vale questo: una proposta è un file Markdown nella cartella _proposals/. Descrive una o più azioni (ad es. “Sposta l’attività X nel progetto Y”) con la relativa motivazione. Puoi approvare, rifiutare o rimandare in revisione una proposta nel suo insieme oppure azione per azione.

Trovi altri dettagli sul flusso delle proposte nella parte 4 del manuale.

Attributi personalizzati, creati anche dagli agenti

Gli attributi personalizzati fanno parte del modello di dati che gli agenti conoscono: AGENTS.md e _system/docs/data-model.md elencano tutti gli attributi definiti al momento con chiave, tipo, validità, opzioni e descrizione. L’app aggiorna questo elenco automaticamente non appena crei, modifichi o elimini un attributo, oppure quando un agente scrive un nuovo file di definizione.

Su tua richiesta, un agente può ad esempio creare un attributo “Cliente” per le attività e poi compilarlo: senza proposte direttamente, con le proposte direttamente nelle attività che gli sono assegnate e negli elementi che crea, in tutti gli altri tramite una proposta (parametro attributes).

AGENTS.md: le istruzioni per gli agenti

Nella directory principale della tua cartella dati si trova il file AGENTS.md. Spiega a ogni agente IA le regole del gioco: azioni consentite, regole di scrittura, struttura delle directory e, con le proposte attive, il formato delle proposte. L’app mantiene aggiornato questo file e lo riscrive di conseguenza quando attivi o disattivi le proposte. Puoi leggerlo, ma è meglio non modificare a mano il blocco gestito dal sistema tra i marcatori TANDEMLOOP:START e TANDEMLOOP:END.