Fictional AI Ops System Review Graph

Bigger Picture

This example shows how a team can explain a complex system without exposing private databases. The system collects safe source summaries, stores evidence contracts, recommends actions, blocks risky operations behind human review, captures outcomes, and turns lessons into better rules.

Source Links

Report Registers

Coverage Register

Evidence Register

Gap Register

Action Register

Lifecycle Map

flowchart LR
  load_sources["Load Sources"]
  write_evidence["Write Evidence"]
  score_recommendations["Score Recommendations"]
  route_action["Route Action"]
  capture_outcome["Capture Outcome"]
  learn_from_outcome["Learn From Outcome"]
  load_sources --> write_evidence["Write Evidence"]
  write_evidence --> score_recommendations["Score Recommendations"]
  score_recommendations --> route_action["Route Action"]
  route_action --> capture_outcome["Capture Outcome"]
  capture_outcome --> learn_from_outcome["Learn From Outcome"]
  learn_from_outcome --> score_recommendations["Score Recommendations"]

Artifact And Schema Map

flowchart LR
  system_source_mesh["Source Mesh"]
  system_source_mesh --> artifact_source_rollup_api["Source Rollup API"]
  artifact_source_rollup_api --> schema_SourceEnvelope["SourceEnvelope"]
  system_evidence_core["Evidence Core"]
  system_evidence_core --> artifact_evidence_graph["Evidence Graph"]
  artifact_evidence_graph --> schema_EvidenceFact["EvidenceFact"]
  system_recommendation_engine["Recommendation Engine"]
  system_recommendation_engine --> artifact_recommendation_report["Recommendation Report"]
  artifact_recommendation_report --> schema_RecommendationCard["RecommendationCard"]
  system_action_engine["Action Engine"]
  system_action_engine --> artifact_action_queue["Action Queue"]
  artifact_action_queue --> schema_ActionIntent["ActionIntent"]
  system_outcome_learning_loop["Outcome Learning Loop"]
  system_outcome_learning_loop --> artifact_outcome_ledger["Outcome Ledger"]
  artifact_outcome_ledger --> schema_OutcomeRecord["OutcomeRecord"]
  system_outcome_learning_loop --> artifact_lesson_registry["Lesson Registry"]
  artifact_lesson_registry --> schema_LessonRecord["LessonRecord"]
  system_operator_ui["Operator UI"]
  system_operator_ui --> artifact_operator_console["Operator Console"]
  artifact_operator_console --> schema_ActionIntent["ActionIntent"]

Gate Map

flowchart LR
  gate_source_rights_gate{"Source Rights Gate"}
  gate_source_rights_gate --> out_source_rights_gate_internal_only["internal_only"]
  gate_source_rights_gate --> out_source_rights_gate_safe_to_use["safe_to_use"]
  gate_source_rights_gate --> out_source_rights_gate_blocked["blocked"]
  gate_recommendation_confidence_gate{"Recommendation Confidence Gate"}
  gate_recommendation_confidence_gate --> out_recommendation_confidence_gate_advance["advance"]
  gate_recommendation_confidence_gate --> out_recommendation_confidence_gate_wait["wait"]
  gate_recommendation_confidence_gate --> out_recommendation_confidence_gate_reject["reject"]
  gate_human_action_gate{"Human Action Gate"}
  gate_human_action_gate --> out_human_action_gate_approved["approved"]
  gate_human_action_gate --> out_human_action_gate_blocked["blocked"]
  gate_human_action_gate --> out_human_action_gate_needs_review["needs_review"]
  gate_lesson_promotion_gate{"Lesson Promotion Gate"}
  gate_lesson_promotion_gate --> out_lesson_promotion_gate_promote["promote"]
  gate_lesson_promotion_gate --> out_lesson_promotion_gate_park["park"]
  gate_lesson_promotion_gate --> out_lesson_promotion_gate_kill["kill"]
  gate_source_rights_gate{"Source Rights Gate"} --> step_load_sources["Load Sources"]
  gate_source_rights_gate{"Source Rights Gate"} --> step_write_evidence["Write Evidence"]
  gate_recommendation_confidence_gate{"Recommendation Confidence Gate"} --> step_score_recommendations["Score Recommendations"]
  gate_human_action_gate{"Human Action Gate"} --> step_route_action["Route Action"]
  gate_human_action_gate{"Human Action Gate"} --> step_capture_outcome["Capture Outcome"]
  gate_lesson_promotion_gate{"Lesson Promotion Gate"} --> step_learn_from_outcome["Learn From Outcome"]

Relationship Graph

flowchart TD
  operator_console["Operator Console"] -- "requests approval from" --> human_action_gate["Human Action Gate"]
  source_mesh["Source Mesh"] -- "owns or uses" --> source_rollup_api["Source Rollup API"]
  source_mesh["Source Mesh"] -- "is gated by" --> source_rights_gate["Source Rights Gate"]
  evidence_core["Evidence Core"] -- "owns or uses" --> evidence_graph["Evidence Graph"]
  recommendation_engine["Recommendation Engine"] -- "owns or uses" --> recommendation_report["Recommendation Report"]
  recommendation_engine["Recommendation Engine"] -- "is gated by" --> recommendation_confidence_gate["Recommendation Confidence Gate"]
  action_engine["Action Engine"] -- "owns or uses" --> action_queue["Action Queue"]
  action_engine["Action Engine"] -- "is gated by" --> human_action_gate["Human Action Gate"]
  outcome_learning_loop["Outcome Learning Loop"] -- "owns or uses" --> outcome_ledger["Outcome Ledger"]
  outcome_learning_loop["Outcome Learning Loop"] -- "owns or uses" --> lesson_registry["Lesson Registry"]
  outcome_learning_loop["Outcome Learning Loop"] -- "is gated by" --> lesson_promotion_gate["Lesson Promotion Gate"]
  operator_ui["Operator UI"] -- "owns or uses" --> operator_console["Operator Console"]
  operator_ui["Operator UI"] -- "is gated by" --> human_action_gate["Human Action Gate"]
  external_public_sources["external_public_sources"] -- "feeds" --> load_sources["Load Sources"]
  private_internal_sources["private_internal_sources"] -- "feeds" --> load_sources["Load Sources"]
  load_sources["Load Sources"] -- "produces" --> source_rollup_api["Source Rollup API"]
  source_rights_gate["Source Rights Gate"] -- "gates" --> load_sources["Load Sources"]
  load_sources["Load Sources"] -- "routes to" --> write_evidence["Write Evidence"]
  source_rollup_api["Source Rollup API"] -- "feeds" --> write_evidence["Write Evidence"]
  write_evidence["Write Evidence"] -- "produces" --> evidence_graph["Evidence Graph"]
  source_rights_gate["Source Rights Gate"] -- "gates" --> write_evidence["Write Evidence"]
  write_evidence["Write Evidence"] -- "routes to" --> score_recommendations["Score Recommendations"]
  evidence_graph["Evidence Graph"] -- "feeds" --> score_recommendations["Score Recommendations"]
  score_recommendations["Score Recommendations"] -- "produces" --> recommendation_report["Recommendation Report"]
  recommendation_confidence_gate["Recommendation Confidence Gate"] -- "gates" --> score_recommendations["Score Recommendations"]
  score_recommendations["Score Recommendations"] -- "routes to" --> route_action["Route Action"]
  recommendation_report["Recommendation Report"] -- "feeds" --> route_action["Route Action"]
  route_action["Route Action"] -- "produces" --> action_queue["Action Queue"]
  human_action_gate["Human Action Gate"] -- "gates" --> route_action["Route Action"]
  route_action["Route Action"] -- "routes to" --> capture_outcome["Capture Outcome"]
  action_queue["Action Queue"] -- "feeds" --> capture_outcome["Capture Outcome"]
  capture_outcome["Capture Outcome"] -- "produces" --> outcome_ledger["Outcome Ledger"]
  human_action_gate["Human Action Gate"] -- "gates" --> capture_outcome["Capture Outcome"]
  capture_outcome["Capture Outcome"] -- "routes to" --> learn_from_outcome["Learn From Outcome"]
  outcome_ledger["Outcome Ledger"] -- "feeds" --> learn_from_outcome["Learn From Outcome"]
  learn_from_outcome["Learn From Outcome"] -- "produces" --> lesson_registry["Lesson Registry"]
  lesson_promotion_gate["Lesson Promotion Gate"] -- "gates" --> learn_from_outcome["Learn From Outcome"]
  learn_from_outcome["Learn From Outcome"] -- "routes to" --> score_recommendations["Score Recommendations"]

Systems

Review Questions

• Which source and evidence artifacts prove each recommendation?
• Which decision gate blocks unsafe downstream action?
• Which actions require human approval and why?
• Where is the outcome captured after action or no-action?
• Which lessons are promoted, parked, or killed based on reality feedback?
• What can be safely reviewed if the production database remains private?