Agents adviseren, architecten beslissen

Context en probleemstelling

Agents kunnen snel feiten zoeken, voorstellen uitwerken en afwegingen voorbereiden. Het besluit over de architectuur blijft een verantwoordelijkheid van architecten. Die rolverdeling moet in de werkwijze vastliggen, zodat een voorstel van een agent nooit ongemerkt vastgestelde kennis wordt.

Beslisfactoren

• Een mens besluit, aantoonbaar.
• Afwegingen worden vanuit meer kanten bekeken, niet alleen vanuit het standpunt van de opsteller.
• Een architect kan besluiten waar de vraag staat, zonder Git te kennen.

Overwogen opties

1. Agents stellen voor, een debat tussen perspectieven adviseert, een architect besluit — met de pull request als besluitmoment.
2. Agents schrijven rechtstreeks vastgestelde kennis — snel, maar zonder menselijke verantwoording.
3. Alleen mensen schrijven — veilig, maar traag en zonder de hulp van agents.

Besluit

Gekozen optie: “Agents stellen voor, een debat tussen perspectieven adviseert, een architect besluit”.

• Een agent (GitHub Copilot in de workflows) schrijft alleen voorstellen: uitspraken met status voorgesteld en besluitrecords met status voorgesteld, in een pull request.
• Een open beslispunt wordt gewogen door zeven vaste perspectieven: veiligheid, kosten, eenvoud, kwaliteit, efficiëntie, pragmatisch, en continuïteit en beheer. Ieder perspectief geeft afzonderlijk zijn voorkeur en kernargument; een debatleider weegt ze openlijk en stelt het besluit voor. Kiest de debatleider een optie die een perspectief onaanvaardbaar vindt, dan legt het besluit uitdrukkelijk vast welk risico wordt aanvaard.
• De architect besluit door de pull request goed te keuren. Vanaf de site kan dat in context: bij een uitspraak of onderwerp start Besluit nemen een issue met de opties; de workflow maakt daaruit de pull request met het besluitrecord en de gewijzigde status van de uitspraken.

Gevolgen

• Goed: iedere vastgestelde uitspraak is door een mens goedgekeurd.
• Goed: de afweging vanuit zeven perspectieven staat in het besluit zelf, niet in een verlopen werkstroom.
• Slecht: een besluit kost een beoordeling; kleine voorstellen kunnen per onderwerp in één besluit worden vastgesteld.