Agent-cataloog (referentie)
Guardrails voor agents in deze repo, per het handboek-formaat (org → Werken met agents). Niet in dit cataloog = eerst vragen. Dit is spoor-1 tooling: scripts die búiten GitOps om het cluster muteren — daarom is uitvoeren hier per definitie mensenwerk.
Operaties
| Operatie | Autonomie | Idempotentie | Verificatie |
|---|---|---|---|
Script toevoegen/wijzigen (huisstijl-header, set -euo pipefail) |
autonoom | n.v.t. (code); het script zélf hoort idempotent te zijn en dat te documenteren in zijn header | ./scripts/verify.sh (bash -n + shellcheck + scripts-assertie) |
| RCA of runbook schrijven | autonoom | tekstueel | docs-contract-gate |
| Docs bijwerken (scripts-overzicht in de index!) | autonoom | tekstueel | scripts-assertie in verify |
| Een script UITVOEREN tegen het cluster | mens-vereist | per script gedocumenteerd in de header | agent legt uit wat het script doet en wat de verwachte uitkomst is |
| ROADMAP-richting wijzigen | mens-vereist | — | strategie is mensenwerk |
| Push | mens-vereist | — | gates draaien bij de mens |
Scripts zonder header/set -euo pipefail; secrets in git |
verboden | — | verify + gitleaks |
Grondwaarheid en gedrag
- Handboek (MCP
conduction-docs) boven modelkennis;docs/index.mdhier is het scripts-overzicht — de verify-assertie houdt het tegen de werkelijkescripts/-map. - GET-check-first: lees het bestaande script en zijn header vóór een
wijziging; draai-logs horen in
reports/(git-genegeerd).