Incident Schema
The AIGO Incident Schema provides the machine-readable structure for recording AI-related incidents and the governance activities performed in response to them. Incident management connects operational events with risk management, controls, evidence, corrective action, assurance, and continual improvement.Purpose
The Incident Schema supports consistent recording of:- incident identity
- affected AI systems
- incident classification
- severity or significance
- detection information
- investigation
- containment and response
- affected stakeholders
- supporting evidence
- root-cause information
- corrective actions
- governance impact
- follow-up activities
- closure information
Role in the AIGO architecture
Incidents provide an important feedback mechanism within the AIGO lifecycle. A representative relationship is: AI system → monitoring → incident → investigation → response → corrective action → reassessment → improvement An incident may also connect directly to:- risks
- controls
- assessments
- approvals
- changes
- monitoring
- assurance
- evidence
- improvement
What an incident represents
An incident record represents a defined event, condition, or suspected event requiring governance or operational attention. Depending on organizational policy, incidents may include:- unexpected AI system behavior
- significant performance failures
- safety-related events
- security events
- privacy-related events
- harmful or inappropriate outputs
- control failures
- unauthorized use
- policy violations
- material governance failures
- significant stakeholder impacts
- regulatory or contractual events
Incident identification
An incident record should provide sufficient information to establish what occurred and what system or governance activity was affected. Relevant information may include:- incident identifier
- detection date and time
- reporting source
- affected AI system
- affected deployment or component
- incident description
- operating context
- affected stakeholders
- initial classification
- initial severity
- current status
Incident classification and severity
Incident classification helps determine the appropriate response and escalation pathway. Factors may include:- potential impact
- actual impact
- affected stakeholders
- scope
- duration
- recurrence
- system criticality
- risk significance
- regulatory or contractual implications
- control failures
Detection
Incidents may be detected through:- monitoring
- user reports
- employee reports
- assurance activities
- control assessments
- testing
- audits
- security processes
- risk reviews
- external notifications
- automated governance evaluation
Investigation
Incident investigation establishes the facts needed to determine:- what happened
- when it happened
- what was affected
- why it happened
- whether the event is ongoing
- what risks were created or increased
- which controls were affected
- whether governance decisions remain valid
- what corrective actions are required
Response and containment
Incident response may include:- containment
- temporary suspension
- access restriction
- rollback
- remediation
- stakeholder notification
- additional monitoring
- escalation
- risk reassessment
- change management
- approval review
Evidence
Incident records should preserve evidence needed to understand, investigate, respond to, and learn from the event. Evidence may include:- system logs
- monitoring records
- alerts
- model outputs
- test results
- screenshots
- communications
- configuration records
- change records
- control assessments
- approval records
- investigation findings
- remediation evidence
Relationship to risk
Incidents can reveal that existing risk assessments are incomplete or no longer accurate. A representative relationship is: incident → finding → risk reassessment → risk treatment An incident may:- identify a previously unknown risk
- increase an existing risk
- demonstrate that a risk treatment was ineffective
- reveal a new affected stakeholder
- change the assessed likelihood or impact
- require additional controls
Relationship to controls
An incident may reveal:- a missing control
- an incorrectly designed control
- a control implementation failure
- an ineffective control
- a control operating outside its intended scope
- a need for compensating controls
Relationship to approval
A significant incident may require review of an existing governance approval. Depending on the circumstances, an incident may result in:- no change to approval
- additional approval conditions
- temporary suspension
- re-approval
- withdrawal of approval
- restricted use
Relationship to change management
Corrective actions may require changes to:- the AI system
- model or components
- configuration
- data
- intended use
- deployment context
- controls
- monitoring
- governance procedures
Corrective action
Corrective actions should address identified causes or contributing factors rather than only the immediate symptom. Actions may include:- technical remediation
- control improvements
- process changes
- additional monitoring
- training
- governance changes
- documentation updates
- risk treatment changes
- changes to system use or deployment
- an owner
- defined scope
- due date
- status
- verification method
- supporting evidence
Root-cause and systemic learning
AIGO incident management should distinguish between immediate cause, contributing factors, and systemic governance weaknesses where appropriate. Repeated incidents may indicate that the underlying governance process requires improvement. For example, recurring incidents associated with the same control may indicate a need to redesign the control rather than repeatedly remediate individual events.Closure
An incident should only be closed when the organization has determined that the required response and follow-up activities have been completed or otherwise formally resolved. Closure may require confirmation that:- immediate response is complete
- required remediation is complete
- residual risk has been evaluated
- required approvals have been obtained
- affected stakeholders have been addressed where applicable
- evidence has been preserved
- lessons learned have been recorded
- required improvement actions have been initiated
Relationship to assurance
Incident records can become important inputs to assurance activities. Assurance may examine whether:- incidents were identified appropriately
- escalation requirements were followed
- investigations were adequate
- evidence was preserved
- corrective actions were effective
- governance decisions were revisited when necessary
- recurring incidents were addressed systematically
Relationship to machine-readable evaluation
Incident information can participate in AIGO’s machine-readable governance evaluation layer. The architecture separates: governance records → evaluation rules → evaluation → result Evaluation rules may check conditions such as:- required incident information exists
- incidents above a defined significance threshold were escalated
- required evidence exists
- corrective actions have been assigned
- required follow-up activities are recorded
- significant incidents triggered reassessment
- incident records are linked to affected systems
Machine-readable implementation
An organization implementing AIGO may use the Incident Schema as the structural contract for incident records. A governance implementation could:- detect or receive an incident
- create an incident record
- identify the affected AI system
- classify the incident
- assess initial severity
- initiate investigation
- record response and containment
- preserve evidence
- identify affected risks and controls
- define corrective actions
- determine governance consequences
- verify follow-up actions
- close the incident
- feed lessons learned into continual improvement
Validation
Incident artifacts participate in the broader AIGO validation model. Relevant validation may include:- schema validation
- reference validation
- traceability validation
- evidence relationships
- framework consistency
- document integrity
- repository health
- rule validation
- evaluation fixture validation
- evaluation orchestration validation
Canonical source
Machine-readable schema:schemas/07-incident/07-AIGO-Incident-Schema-v0.1.json
Schema documentation:
schemas/07-incident/07-AIGO-Incident-Schema-Documentation-v0.1.md
Operational procedure:
guidance/02-procedures/08-AIGO-AI-Incident-Management-Procedure-v0.1.md
Implementation template:
guidance/03-templates/10-AIGO-AI-Incident-Template-v0.1.md