name: create_incident
description: "Create and initialize an incident record with severity classification, on-call notification, and war room setup"
when_to_use: "When a service degradation or outage is confirmed and needs formal incident tracking; when SLO burn rate crosses the critical threshold"
parameters:
  title:
    type: string
    description: "Short incident title describing the symptom (not the cause)"
    required: true
  severity:
    type: string
    description: "Incident severity: SEV1 (complete outage), SEV2 (major degradation), SEV3 (partial degradation), SEV4 (minor issue)"
    required: true
  affected_services:
    type: array
    description: "List of service names impacted by the incident"
    required: true
  initial_hypothesis:
    type: string
    description: "Initial hypothesis about the cause (can be updated as investigation proceeds)"
    default: ""
returns:
  type: object
  description: "Created incident record with ID, war room link, and on-call assignments"
  properties:
    incident_id:
      type: string
    severity:
      type: string
    war_room_url:
      type: string
    on_call_notified:
      type: array
    created_at:
      type: string