— AI Context, Agents & Instructies¶

Doel¶

Deze map bevat alle AI-context, agent-instructies, benchmarks en testcases voor het Buurts Ecosysteem. Het is de instructielaag voor agents zelf — niet voor eindgebruikers.

Kernregel: Wat hier staat instrueert de agents. Alle andere mappen bevatten output van agents of bronnen die agents consumeren.

Mapinhoud¶

Bestand	Type	Gebruik
`ARCHITECTURE.md`	Architectuurdoc	Overzicht van het gehele agent-ecosysteem
`PROJECT.md`	Projectcontext	Projectstatus en besluiten voor agents
`SPRINT.md`	Sprintstatus	Actieve sprint, taken en voortgang
`SPRINT_C.md`	Sprintarchief	Gearchiveerde sprint C documentatie
`Agent_instruction_template.md`	Sjabloon	Standaard instructie-opzet voor nieuwe agents
`Benchmark_case_template.md`	Sjabloon	Testcases en benchmarks voor agent-evaluatie

Agent-protocol: Actieve samenwerking¶

Agents in het Buurts Ecosysteem werken samen via een gestandaardiseerd protocol:

Informatie ophalen bij andere agents¶

Stap 1: Identificeer welke agent de gewenste informatie heeft
         (zie agent_contacts in de relevante frontmatter)
Stap 2: Formuleer een gerichte vraag: "Curator, geef trenddata voor domein X"
Stap 3: Log het verzoek in agent_input_status (frontmatter van het doeldocument)
Stap 4: Verwerk de ontvangen input en markeer als 'ontvangen'
Stap 5: Documenteer de bijdrage in de audittrail van het doeldocument

Ontbrekende input signaleren¶

Als een agent input mist van een andere agent: 1. Voeg een item toe aan open_questions in de frontmatter: "Vraag aan [agent]: [wat] — voor sectie [X]" 2. Update agent_input_status.[agent].status naar open 3. Blokkeer de actie NIET — ga door met beschikbare info en markeer de gap

Zone-protocol voor agents¶

Zone	Actie
🟢 GREEN	Antwoord automatisch toegestaan
🟡 YELLOW	Menselijke validatie vereist — markeer en wacht
🔴 RED	Antwoord niet tonen — doorverwijzen naar specialist

Gebruik door agents¶

Lees ARCHITECTURE.md en SPRINT.md bij elke nieuwe sessie
Raadpleeg PROJECT.md voor openstaande beslissingen
Gebruik de sjablonen in deze map bij het aanmaken van nieuwe agent-instructies
Rapporteer performance en kwaliteitsproblemen via Benchmark_case_template.md

Beheer: Niels (architect) | Zone: GREEN | Retentie: permanent