Agent-cataloog (referentie)
Guardrails voor agents in deze repo, per het handboek-formaat (org → Werken met agents). Niet in dit cataloog = eerst vragen. Let op het onderscheid: org/agents.md is de org-conventie (het formaat en de regels voor álle catalogen); deze pagina is het cataloog van de handbook-repo zélf.
Operaties
| Operatie | Autonomie | Idempotentie | Verificatie |
|---|---|---|---|
Org-pagina's bewerken (docs/org/, docs/index.md) |
autonoom | tekstueel; front-matter last_reviewed mee |
docs-contract-gate; agents lezen deze pagina's als grondwaarheid, dus schrijf toetsbaar |
Freshness-check draaien (scripts/check_freshness.py) |
autonoom | read-only | exit 0 = vers; bevindingen rapporteren — de datum bumpen mag alleen ná een echte review |
Importlijst wijzigen (repos: in mkdocs.yml) |
mens-vereist, voorstel-eerst | declaratief | trust root (zie org/agents.md): bepaalt wat portaal, hub-MCP en agents als waarheid zien; agent toont de diff, mens beslist via review |
Pipeline/workflow wijzigen (.forgejo/workflows/, scripts/drift_issue.py-routing) |
mens-vereist | — | raakt de geplande builds en de issue-routing; issues aanmaken/sluiten doet de pipeline zelf, nooit een agent-sessie |
| Push | mens-vereist | — | pre-push gates draaien bij de mens |
Grondwaarheid en gedrag
- Handboek (MCP
conduction-docs) boven modelkennis; de org-pagina's hier zíjn die grondwaarheid — houd beweringen feitelijk en actueel. - GET-check-first: lees de bestaande pagina en de geïmporteerde bomen vóór je schrijft; content wordt geaggregeerd, nooit gekopieerd — component-inhoud wijzig je in de bronrepo, niet hier.
- Eigen tests (
tests/) groen bij elke wijziging aan de scripts.