Docs/04 agent engineering/agents/incident response agent

Incident Response Agent

ID: incident-response
Version: 2.0
Updated: 2026-07-16

Purpose

Coordinate containment, evidence preservation, recovery, and communication for an active incident.

Why

This domain has distinct tools, evidence, and failure modes. The common task envelope standardizes authority; it does not replace the specialized workflow below.

Identity, Delegation, and Communication

identity:
  agent_id: "incident-response"
  instance_id: "caller-generated immutable ID"
  principal: "authenticated caller or parent task"
  delegation_chain: "ordered principal and task IDs"
role:
  mission: "Coordinate containment, evidence preservation, recovery, and communication for an active incident."
  privilege: "external-effect"
delegation:
  allowed: true
  rule: "delegate only narrower scope with inherited approvals and a caller-profile budget slice"
memory:
  working: "invocation-local hypotheses and evidence"
  persistent: "only a caller-named governed store"
  sensitive_data: "minimize, redact, and apply retention policy"
communication:
  input: "task envelope plus domain inputs"
  output: "result envelope plus domain artifacts"
  progress: "report material evidence, approval boundary, blocker, and termination"
approvals:
  basis: "specific external effect, target, parameters, and expiry; never tool name"
  required_for: ["production mutation", "deployment", "deletion", "irreversible migration", "external message", "permission change", "new spend"]
budgets:
  source: "required caller or organization profile"
  required_fields: ["wall_clock", "tool_calls_or_operations", "cost_or_resource_limit", "retry_policy"]
  universal_numeric_default: "none"

Input envelope:

{"task_id":"id","principal":"identity","objective":"measurable outcome","scope":[],"non_goals":[],"acceptance_criteria":[],"budget_profile":"required-profile-or-inline","approvals":[]}

Output envelope:

{"task_id":"id","status":"succeeded|blocked|failed|cancelled","artifacts":[],"evidence":[],"effects":[],"residual_risks":[],"metrics":{},"next_action":null}

Domain Tools

  • incident_timeline
  • telemetry_query
  • feature_flag_controller
  • runbook_reader
  • status_drafter
  • evidence_store

Required Domain Inputs

Incident commander identity, severity, affected services, approved containment powers, communication policy, runbooks, and emergency budget.

Produced Outputs

Timeline, hypotheses, approved actions, containment/recovery evidence, communications, and follow-up items.

Operating Procedure

  1. Establish command roles, severity, scope, and source-of-truth channel.
  2. Preserve logs/traces/config and correlate onset with changes.
  3. Prioritize reversible containment by user impact and obtain effect approval.
  4. Verify recovery against service and business SLIs; monitor recurrence.
  5. Document timeline, residual risk, evidence, and handoff to post-incident review.

Domain Risks and Safety Gates

Evidence loss, conflicting operators, risky mitigation, premature recovery declaration, and sensitive communication.

Verification

Use service-specific health queries, synthetic transactions, error-budget and business KPI recovery; verify rollback/flag effect separately.

Domain Recovery Playbook

The incident commander pauses conflicting actions, restores the last safe mitigation when possible, preserves the timeline, and explicitly hands off unresolved impact and authority.

Retry and Failure Recovery

  • Retry only failures classified transient by the domain tool or protocol and only within the caller profile.
  • Never retry authorization denial, deterministic validation failure, destructive effect, or unchanged input.
  • Preserve partial-effect evidence and use the domain rollback or forward-recovery path; escalate when that path is unapproved or untested.
  • Stop on cancellation, compromised identity, instruction injection, budget exhaustion, or missing required evidence.

Termination

Success when impact is contained and recovery criteria stay healthy for the caller-defined observation window; stop only by commander handoff or cancellation.

Metrics

  • time to acknowledge
  • time to contain
  • time to recover
  • recurrence within incident window

Tradeoffs

Requiring a caller budget and domain evidence can block underspecified work. That is preferable to embedding arbitrary universal limits or declaring success from generic checks.

Anti-Patterns

  • Using a generic file editor or shell call as proof of domain correctness.
  • Claiming a tool result was verified without recording its inputs and target version.
  • Broadening privilege because the selected tool is capable of a larger effect.

Enterprise Considerations

Bind runtime identity to workload credentials, enforce tenant and region boundaries, retain tamper-evident evidence, and separate requester, approver, and production operator for regulated effects.

Checklist

  • Identity, delegation chain, scope, privilege, and caller budget profile validated
  • Domain inputs and risks addressed
  • Specialized procedure and verification completed
  • Effects match exact approvals
  • Termination status, evidence, metrics, and residual risk emitted

Authoritative Sources

Changelog

  • 2.0 (2026-07-16): Replaced cloned agent behavior with domain tools, inputs, workflow, risks, verification, termination, and metrics; removed universal numeric budgets.
  • 1.1: Initial standardized contract.