AIGO — Improvement Schema Documentation
1. Document Purpose
This document describes the machine-readable AIGO Improvement Schema. The schema provides the structured representation of continual-improvement activities within the AIGO AI Governance Operating Framework. It is intended to support:- improvement identification;
- improvement sources;
- observations and opportunities;
- problem definition;
- root-cause analysis;
- prioritization;
- urgency;
- improvement options;
- action planning;
- implementation;
- change management;
- implementation risk;
- verification;
- effectiveness evaluation;
- risk outcomes;
- control outcomes;
- monitoring outcomes;
- stakeholder outcomes;
- assurance;
- evidence;
- lessons learned;
- standardization;
- portfolio impact;
- closure;
- follow-up;
- management review; and
- traceability.
2. Schema Information
3. Scope
The Improvement Schema applies to continual-improvement activities arising from AIGO governance and operational processes. Improvement opportunities may originate from:- management review;
- risk assessment;
- control assessment;
- assurance;
- audit;
- incident management;
- monitoring;
- change management;
- stakeholder feedback;
- affected-person feedback;
- regulatory developments;
- legal review;
- technology developments;
- model evaluation;
- data assessment;
- supplier review;
- lessons learned;
- maturity assessment; or
- strategic review.
4. Object Model
The primary object represented by this schema is:- the source finding or observation;
- the Risk record;
- the Control record;
- the Change record;
- the Assessment record;
- the Assurance record;
- the Management Review record;
- the Evidence record; and
- the Retirement record.
5. Core Identity
An Improvement record should contain stable identity information. Key fields include:id;objectType;objectVersion;schemaVersion;- improvement title;
- source;
- objective;
- owner; and
- status.
6. Improvement Purpose
The improvement record should clearly state what is intended to change or improve. The objective should explain:- the current condition;
- the desired condition;
- the reason improvement is needed;
- the expected benefit;
- the governance significance; and
- the intended measurable or observable outcome.
7. Improvement Sources
An improvement may originate from one or more governance sources. The schema supports source categories including:8. Source Record Relationships
The improvement should reference the records that generated the improvement opportunity. Examples include:9. Current Condition
The record should describe the condition that currently exists. Examples include:- incomplete governance coverage;
- ineffective control;
- outdated procedure;
- excessive incident rate;
- insufficient monitoring;
- inadequate evidence;
- recurring assessment findings;
- regulatory gap;
- capability weakness; or
- another documented condition.
10. Desired Condition
The desired condition should describe what success looks like after the improvement. The desired condition may include:- stronger control effectiveness;
- reduced risk;
- improved monitoring coverage;
- improved evidence quality;
- reduced incident recurrence;
- improved stakeholder outcomes;
- improved governance maturity;
- improved compliance; or
- another defined outcome.
11. Problem Statement
Where the improvement addresses a defined problem, the problem statement should identify:- what is wrong;
- why it matters;
- who or what is affected;
- evidence supporting the problem; and
- consequences of not addressing it.
12. Opportunity Statement
Not all improvements arise from failures. An improvement may represent an opportunity to:- improve efficiency;
- simplify governance;
- strengthen resilience;
- improve assurance;
- enhance transparency;
- improve user experience;
- reduce unnecessary risk;
- adopt better technology;
- improve sustainability; or
- increase governance maturity.
13. Root-Cause Analysis
Where an improvement is driven by a deficiency or recurring problem, root-cause analysis should be considered. The schema supports:- primary cause;
- cause category;
- confidence;
- analysis method; and
- analysis narrative.
- governance;
- process;
- procedure;
- control;
- risk management;
- monitoring;
- assurance;
- incident;
- change management;
- data;
- model;
- technology;
- human;
- training;
- supplier; and
- regulatory.
14. Contributing Causes
Multiple contributing causes may exist. Examples include:- unclear ownership;
- insufficient competence;
- incomplete requirements;
- inadequate tooling;
- weak evidence;
- poor system integration;
- insufficient testing;
- supplier limitations;
- process complexity; or
- resource constraints.
15. Improvement Type
The schema supports classification of improvement activities. Possible categories include:16. Improvement Owner
Every active improvement should have an accountable owner. The owner is responsible for:- defining the improvement;
- coordinating prioritization;
- obtaining approvals;
- assigning actions;
- monitoring progress;
- ensuring implementation;
- arranging verification;
- evaluating effectiveness; and
- closing the improvement.
17. Sponsor and Action Owner
The schema may distinguish:- improvement owner;
- sponsor;
- action owner;
- reviewer; and
- approval authority.
18. Improvement Lifecycle
A typical improvement lifecycle is:19. Improvement Status
The schema supports controlled improvement status. Typical conceptual states include:20. Priority
Improvement priority should reflect governance significance. Priority may consider:- risk reduction;
- regulatory significance;
- control criticality;
- affected-person scale;
- urgency;
- strategic importance;
- cost;
- feasibility; and
- organizational capacity.
21. Urgency
Urgency should distinguish whether action is:- immediate;
- near-term;
- planned; or
- long-term.
22. Option Analysis
Where more than one approach is possible, the improvement record may compare options. Options may be assessed against:- effectiveness;
- risk reduction;
- cost;
- feasibility;
- dependencies;
- implementation complexity;
- unintended consequences;
- sustainability; and
- strategic alignment.
23. Selected Option
Where alternatives were assessed, the selected option should identify:- selected option;
- rationale;
- decision authority; and
- decision date where applicable.
24. Improvement Objective
The objective is the central statement of intended improvement. A strong objective should identify:- desired outcome;
- affected area;
- expected benefit;
- relevant constraints;
- target timeframe; and
- success criteria.
25. Success Criteria
Success criteria define how the organization will determine whether the improvement worked. Criteria may include:- risk reduction;
- control effectiveness;
- process performance;
- monitoring performance;
- incident reduction;
- evidence quality;
- stakeholder outcome;
- compliance status;
- maturity improvement;
- operational performance; or
- other measurable outcomes.
26. Action Plan
An improvement may contain multiple actions. Each action should identify, where applicable:- action identifier;
- action description;
- action type;
- owner;
- dependency;
- priority;
- target date;
- status; and
- completion evidence.
- correction;
- corrective action;
- preventive action;
- control change;
- process change;
- procedure change;
- technical change;
- documentation change;
- training;
- monitoring; and
- assurance.
27. Resources
Improvements should consider required resources. Resources may include:- people;
- technology;
- budget;
- expertise;
- training;
- external support;
- infrastructure; and
- management attention.
28. Dependencies
Improvements may depend on:- approvals;
- projects;
- technology;
- supplier action;
- governance decisions;
- data;
- staffing;
- training;
- other improvements; or
- related changes.
29. Improvement Implementation
Implementation should document:- status;
- start date;
- completion date;
- activities completed;
- issues;
- blockers;
- deviations; and
- implementation evidence.
30. Implementation Deviations
A deviation may occur when implementation differs from the approved plan. Material deviations should identify:- deviation;
- impact;
- owner;
- escalation;
- approval where required; and
- evidence.
31. Change Management Relationship
An improvement may require changes to:- AI systems;
- models;
- data;
- controls;
- monitoring;
- procedures;
- governance;
- infrastructure;
- suppliers; or
- business processes.
32. Implementation Risk
Improvement implementation may create temporary or new risks. The record may identify:- implementation risks;
- risk levels;
- treatments;
- owners;
- temporary risk; and
- mitigating controls.
33. Verification
Verification determines whether the improvement was implemented as intended. Verification may use:- evidence review;
- testing;
- control assessment;
- monitoring;
- independent validation;
- assurance;
- interview;
- observation; or
- performance comparison.
- objective;
- methods;
- owner;
- date;
- criteria; and
- expected evidence.
34. Effectiveness Evaluation
Effectiveness evaluation determines whether the improvement achieved its intended outcome. Possible outcomes include:35. Unintended Consequences
An improvement may produce unexpected effects. The effectiveness evaluation should consider:- new risks;
- control degradation;
- stakeholder impacts;
- operational disruption;
- new incidents;
- increased complexity;
- unintended bias; or
- other undesirable outcomes.
36. Sustainability
Effectiveness should consider whether the improvement is sustainable. Sustainability may depend on:- ownership;
- resources;
- competence;
- documentation;
- monitoring;
- control integration;
- maintenance;
- technology support; and
- organizational adoption.
37. Risk Outcome
Where the improvement addresses risk, the record may capture:- risk before;
- risk after;
- risk reduction;
- residual risk;
- risk acceptance requirements; and
- associated risk-acceptance record.
38. Control Outcome
Where the improvement affects controls, the record may compare:- control condition before;
- control condition after;
- control effectiveness;
- result; and
- rationale.
39. Monitoring Outcome
An improvement may affect monitoring requirements. The record may compare:- indicator values before;
- indicator values after;
- targets;
- thresholds;
- monitoring status; and
- overall monitoring result.
40. Stakeholder Outcome
Improvements should consider the effect on relevant stakeholders. Outcomes may include:- positive feedback;
- negative feedback;
- affected-person outcomes;
- complaint changes;
- improved usability;
- reduced harm;
- unintended consequences; or
- no material change.
41. Assurance Relationship
An improvement may require independent assurance where:- the improvement is high significance;
- effectiveness is difficult to demonstrate;
- regulatory requirements require assurance;
- previous remediation failed;
- the improvement addresses a critical control; or
- management requests independent validation.
42. Evidence
Improvement evidence may demonstrate:- the original problem;
- root cause;
- approval;
- implementation;
- completion;
- verification;
- effectiveness;
- risk reduction;
- control improvement;
- stakeholder outcome; and
- closure.
43. Evidence Completeness
The improvement record may identify whether required evidence is:- complete;
- substantially complete;
- partially complete; or
- incomplete.
44. Lessons Learned
Improvements should capture lessons learned where they have broader governance relevance. Lessons may concern:- governance;
- technology;
- process;
- controls;
- risk;
- monitoring;
- assurance;
- implementation;
- stakeholder engagement; or
- organizational capability.
45. Standardization
An improvement that proves effective may be considered for wider standardization. Standardization decisions may be:- applicability;
- evidence of effectiveness;
- dependencies;
- risk;
- cost;
- organizational context; and
- scalability.
- templates;
- procedures;
- controls;
- guidance;
- training; and
- schemas.
46. Portfolio Impact
An improvement may affect more than one AI system or governance area. Portfolio impact may include:- other AI systems affected;
- enterprise impact;
- portfolio action;
- common controls;
- shared technology;
- shared procedures; and
- portfolio owner.
47. Improvement Review
Improvements should be reviewed periodically when:- implementation is prolonged;
- dependencies change;
- risk changes;
- scope changes;
- expected benefits change;
- target dates are missed; or
- effectiveness remains uncertain.
- continue;
- be reprioritized;
- be modified;
- be deferred;
- be cancelled; or
- be escalated.
48. Management Review Relationship
Significant improvements should be available to management review. Management may consider:- major improvements;
- overdue actions;
- improvement trends;
- strategic impact;
- resource requirements;
- risk reduction;
- recurring issues; and
- improvement effectiveness.
49. Improvement and Risk Management
The improvement-to-risk relationship may be:50. Improvement and Controls
Improvements may:- introduce new controls;
- modify controls;
- retire controls;
- strengthen control effectiveness;
- improve evidence; or
- improve monitoring.
51. Improvement and Incidents
Incidents are an important improvement source. The relationship may be:52. Improvement and Assurance
Assurance findings may produce improvements. The relationship may be:53. Improvement and Monitoring
Monitoring may reveal an improvement opportunity through:- deteriorating performance;
- repeated threshold breaches;
- ineffective indicators;
- increasing incidents;
- increased risk;
- stakeholder dissatisfaction; or
- monitoring gaps.
54. Improvement and Change
An improvement may be implemented through one or more Change records. The relationship may be:55. Improvement Closure
An improvement should be closed only when the applicable closure criteria are satisfied. Closure may require:- objective achieved;
- actions complete;
- verification complete;
- effectiveness determined;
- evidence complete;
- outstanding risks addressed;
- required approvals complete;
- lessons learned captured; and
- follow-up assigned where required.
56. Reopening an Improvement
An improvement may need to be reopened when:- effectiveness was overstated;
- unintended consequences emerge;
- the original problem recurs;
- implementation fails;
- new evidence changes the conclusion; or
- the improvement is found to be unsustainable.
57. Improvement Reporting
Improvement records may support governance reporting. Useful metrics include:
Metrics should have controlled definitions and reporting periods.
58. Improvement Validation Requirements
A valid Improvement record should satisfy:Structural Validation
The JSON document must validate against:12-AIGO-Improvement-Schema-v0.1.json
Source Validation
The improvement source should be identifiable.Objective Validation
A clear objective should be defined.Ownership Validation
An accountable owner should be assigned.Priority Validation
Priority should have an appropriate rationale for significant improvements.Action Validation
Required actions should have owners and target dates.Dependency Validation
Material dependencies should be identified.Risk Validation
Implementation risks should be considered where appropriate.Verification Validation
The improvement should have a defined verification approach when verification is required.Effectiveness Validation
Effectiveness should be evaluated against defined criteria.Evidence Validation
Material effectiveness claims should have sufficient evidence.Closure Validation
Closure should satisfy the applicable closure criteria.Traceability Validation
The improvement should remain traceable to its source, related risks, controls, assessments, incidents, changes, assurance, evidence, management reviews, and other related records.59. Schema Limitations
JSON Schema cannot independently determine:- whether an improvement is genuinely needed;
- whether root cause is correct;
- whether the selected option is appropriate;
- whether implementation is effective;
- whether risk reduction actually occurred;
- whether stakeholder outcomes improved;
- whether standardization is justified; or
- whether closure is appropriate.
60. Relationship to Templates
The Improvement Schema corresponds primarily to:guidance/03-templates/14-AIGO-AI-Continuous-Improvement-Template-v0.1.md
It also supports improvement records generated from:
- management review;
- risk assessment;
- control assessment;
- monitoring;
- incident management;
- change management;
- assurance;
- evidence review;
- maturity assessment; and
- other AIGO governance activities.
61. Relationship to Procedures
The schema should be used with:guidance/02-procedures/13-AIGO-Continuous-Improvement-Procedure-v0.1.md
and, where applicable:
- governance;
- risk assessment;
- control assessment;
- approval;
- monitoring;
- incident management;
- change management;
- assurance;
- management review;
- risk acceptance; and
- retirement procedures.
62. Framework Traceability
63. Improvement Traceability Model
The recommended traceability chain is:64. Example Record
A conceptual Improvement record may look like:65. Schema Registry Relationship
This schema is registered in:schemas/00-AIGO-Schema-Registry-v0.1.json
The registry should maintain:
- schema identifier;
- object type;
- version;
- controlled path;
- status;
- dependencies;
- referenced schemas;
- owner;
- documentation path; and
- traceability metadata.
66. Change and Version Management
Changes to the Improvement Schema should be managed through AIGO change management. Potential impacts should be assessed against:- continual-improvement procedures;
- improvement templates;
- management review;
- risk management;
- control management;
- monitoring;
- incident management;
- change management;
- assurance;
- evidence;
- reporting;
- standardization;
- external mappings; and
- validation tooling.
67. Future Extensions
Future versions may support:- improvement portfolio management;
- benefits realization;
- formal cost-benefit analysis;
- improvement dependency graphs;
- automated prioritization;
- improvement maturity scoring;
- organization-wide standardization;
- learning repositories;
- automated effectiveness analytics;
- benefit monitoring;
- policy-to-improvement traceability; and
- machine-readable improvement workflows.
68. Document Control
69. Document Status
Document: AIGO — Improvement Schema Documentation Version: 0.1 Status: Draft Working Name: AIGO Full Name: AI Governance Operating Framework Document Identifier:AIGO-SCHEMA-DOC-012
Document Type: Schema Documentation
This document provides the human-readable interpretation, governance context, validation expectations, and traceability guidance for the AIGO Improvement Schema.
End of Document