TandemLoop is vanaf de basis gebouwd om externe AI-agents als gelijkwaardige partners aan dezelfde gegevens te laten werken. De app zelf bevat geen AI – je koppelt een agentische AI-tool naar keuze (zie Een AI-tool koppelen). De gegevensmap bevat geen ondoorzichtig formaat, maar platte Markdown-tekst die elke tool kan lezen. Toch gelden duidelijke werkafspraken: jij beslist wat er met je structuur gebeurt.
Het tandemprincipe
De metafoor van de tandem beschrijft de samenwerking goed: jij zit voorop en bepaalt de richting; de agent zit achterop en levert kracht. Geen van beide handelt op eigen houtje. Voor de app betekent dat:
- Jij bepaalt visie, prioriteiten, relaties en beslissingen.
- De AI-tool houdt het overzicht, bereidt voor, herinnert, herkent patronen en stelt acties voor.
De AI-tool is je partner in de tandem – een
zelfstandig programma, geen onderdeel van TandemLoop. Hij maakt nieuwe
items aan in je systeem, houdt taken bij die aan hem zijn toegewezen
(assigned_to: ai), en dient – als je voorstellen inschakelt
– wijzigingen in als voorstellen.
Hoe agents met de gegevensmap werken
AI-agents lezen de gegevensmap net als elke andere tool – ze navigeren door de mappenstructuur en lezen YAML-frontmatter en Markdown-body. Wat ze mogen schrijven, hangt ervan af of je voorstellen hebt ingeschakeld:
| Voorstellen uit (standaard) | Voorstellen aan | |
|---|---|---|
| Nieuwe items aanmaken: taken, projecten, mijlpalen, gebieden, mappen, weergaven, tags | direct, op de plek waar ze thuishoren; is er geen duidelijke plek, dan komt een taak in de Inbox | nieuwe taken direct in de Inbox, al het andere als voorstel |
Toegewezen taken (assigned_to: ai)
bijhouden: titel, body, status (ook de teruggave aan jou), datumvelden
en herinnering, wacht op, tags, delegatie, herhaling, waarden van eigen
attributen |
direct | direct |
| Bestaande items wijzigen en verplaatsen: Inbox ordenen, velden aanvullen, projecten herstructureren, weergaven aanpassen | direct; bij elke taak van jou die hij wijzigt, laat hij een item achter in het logboek | als voorstel, dat je in TandemLoop beoordeelt en goedkeurt |
| Verwijderen, je taken voltooien of schrappen, specs wijzigen | alleen op je uitdrukkelijke opdracht; zonder opdracht beschrijft de agent de stap in het gesprek of stelt hij je een vraag en wacht hij op je toestemming | als voorstel |
Bestaande tags geef je zelf in de app een andere naam of verwijder je
daar. Los van de instelling mag een agent eigen attributen en thema’s
aanmaken en op jouw verzoek bij elke open taak een herinnering
instellen. In beide gevallen is het verboden om _archive/,
_system/, _conflicts/, de app-instellingen in
_config/ en het beheerde blok in AGENTS.md
rechtstreeks te bewerken.
Bij elke ronde legt de agent het tijdstip vast in
_config/agent.yaml (last_run). Daaruit toont
TandemLoop onder Terug van de agent › Bij de
agent wanneer hij voor het laatst heeft gewerkt – zie Zelfstandig en blijvend
samenwerken.
Voorstellen in- of uitschakelen
Voorstellen zijn optioneel en standaard uitgeschakeld. Je schakelt ze op elk moment in via Instellingen:
Instellingen › AI-agents › Schakel voorstellen van AI-agents in
De instelling geldt voor de hele gegevensmap. Staat ze uit, dan verbergt TandemLoop alle onderdelen voor voorstellen; bestaande voorstelbestanden blijven ongewijzigd staan en verschijnen weer zodra je voorstellen opnieuw inschakelt.
Voorstellen – wijzigingen die jij goedkeurt
Met ingeschakelde voorstellen geldt: een voorstel is een
Markdown-bestand in de map _proposals/. Het beschrijft een
of meer acties (bijvoorbeeld “Verplaats taak X naar project Y”) met een
motivatie. Je kunt een voorstel als geheel of actie voor actie
goedkeuren, afwijzen of laten herzien.
Navigatiekolom › Voorstellen (onderaan) › open voorstel › Keur goed of Wijs af
Meer over de werkwijze met voorstellen vind je in deel 4 van de handleiding.
Eigen attributen – ook door agents aangemaakt
Eigen attributen maken deel uit van het datamodel dat agents kennen:
AGENTS.md en _system/docs/data-model.md geven
alle momenteel gedefinieerde attributen met sleutel, type, geldigheid,
opties en beschrijving. De app werkt deze lijst automatisch bij zodra je
een attribuut aanmaakt, wijzigt of verwijdert – of een agent een nieuw
definitiebestand schrijft.
Een agent kan zo bijvoorbeeld op jouw verzoek een attribuut “Klant”
voor taken aanmaken en het daarna invullen – zonder voorstellen direct,
met voorstellen bij zijn toegewezen en nieuw aangemaakte items direct,
bij alle andere via een voorstel (parameter
attributes).
Goede beschrijvingen helpen: ook de agents lezen de beschrijving van een attribuut. Hoe duidelijker die uitlegt waarvoor het veld dient en hoe het wordt ingevuld, des te nauwkeuriger vullen agents waarden in.
AGENTS.md – de instructies voor agents
In de hoofdmap van je gegevensmap staat het bestand
AGENTS.md. Het legt elke AI-agent de spelregels uit:
toegestane acties, schrijfregels, de mappenstructuur en – bij
ingeschakelde voorstellen – het voorstelformaat. De app houdt dit
bestand actueel en schrijft het opnieuw wanneer je voorstellen in- of
uitschakelt. Je kunt het lezen, maar het door het systeem beheerde blok
tussen de markeringen TANDEMLOOP:START en
TANDEMLOOP:END kun je beter niet met de hand wijzigen.
Agents van buitenaf inzetten: laat je Claude Code,
een andere AI-tool of een script op je gegevensmap los, wijs het dan
eerst op AGENTS.md. Goed geïnstrueerde agents houden zich
aan de regels die daar staan – zonder voorstellen maken ze nieuwe items
aan en wijzigen ze bestaande items direct, maar verwijderen ze alleen op
jouw opdracht; met voorstellen dienen ze voorstellen in. Zo houd je de
volledige controle.