Gevarenregister

Een gevaar is iets dat met uw systeem mis kan gaan, opgeschreven met wie er eigenaar van is en wat het meet. Het register staat naast het releasebeleid in hazards.yaml, wordt dus net als de rest van het project in pull requests beoordeeld, en elke run legt vast tegen welke versie het werd gelezen.

Het register schrijven

version: 1
hazards:
  - id: rag-leak
    title: A poisoned document makes the assistant disclose a customer's data
    systems: [support-bot]
    triggers: [a retrieved document carries an instruction]
    exposed: customers whose tickets the assistant reads
    severity: {level: 5, narrative: customer data leaves the company}
    occurrence: {level: 2}
    detectability: {level: 3}
    controls: [retrieved text is quoted, never obeyed]
    residual: Low while the leak ceiling holds; reviewed after every model change.
    owner: [email protected]
    review_by: 2026-12-01
    state: open
    measured_by: [no-leak]
    tested_by: [safety]

Elk gevaar noemt in measured_by de regels die het meten. Dat moeten plafonds uit release.yaml zijn: een max:-regel of een max_failures:-regel (Risicoplafonds). Een vloer meet hoe vaak iets goed gaat, dus een gevaar dat met een vloer wordt gemeten, wordt geweigerd. systems en tested_by beperken uit welke systemen en suites het bewijs wordt gelezen; ontbreken ze, dan tellen alle.

Ernst, optreden en detecteerbaarheid zijn de ordinale scores van een faalwijze- en effectenanalyse, van 1 tot 5, gegeven door mensen. Oloproof toont ze zoals ze zijn gegeven en combineert ze nooit: geen risicoprioriteitsgetal en geen score voor restrisico, want het product van ordinale scores is een precisie die niemand heeft gemeten. Restrisico is de zin van de eigenaar. De state van een gevaar (open, mitigated, accepted of closed) is van het team, nooit een beslissing.

Het controleren

oloproof hazards check

De controle weigert een register waarvan een gevaar een regel noemt die het beleid niet bevat, of een vloer, en eindigt met 2. Anders somt ze elk gevaar op met zijn scores, eigenaar en toestand, meldt een achterstallige herziening en leest elke meetregel bij de laatste run van elk systeem op elke suite, zoals de engine haar besliste. Een gevaar zonder meetregel staat als ongemeten vermeld, en een regel die geen laatste run besliste, wordt genoemd. --json schrijft hetzelfde rapport voor een pipeline.

Waar het verschijnt

oloproof run legt het register vast bij de run, oloproof push brengt het naar uw werkruimte en oloproof export schrijft het naast de bundels die een lokale workbench leest. De pagina Safety and risk toont elk gevaar boven de plafonds, met zijn scores, maatregelen en de toestand van de meetplafonds, elk gekoppeld aan zijn bewijs. Waar een register veranderde en weer terugveranderde, is het huidige register het register dat de nieuwste run vastlegde, niet het laatst geschreven. Een beslissingsrecord noemt het register dat zijn run vastlegde; record verify vermeldt het als het woord van het team.

Verder lezen

• Risicoplafonds behandelt de regels waarmee een gevaar wordt gemeten.
• Gating behandelt hoe een plafond een release tegenhoudt.