What an Action carries
Scope
Exactly which resources the action touches, in which environment, in which namespace or region.
Blast radius
The graph-computed set of downstream resources that could be affected if the action goes wrong.
Change payload
The literal change: a patch, a scale delta, a config update, a shell command. Readable before approval.
Confidence
How sure the system is about the recommendation, based on signal strength and prior art.
Recovery estimate
Approximate time from apply to verified stable state, based on similar past incidents.
Reversibility
The exact inverse operation, precomputed. One-click rollback for every Action.
The lifecycle of an Action
Proposed
The RCA Pipeline or a skill drafts the Action. It appears in the Action Center and, optionally, in your notification channels.
Reviewed
A human opens the Action, checks the scope, the payload, and the blast radius. Guardian validates the Action against the environment’s policy at this moment, not later.
Approved or rejected
Approve and the Action advances to Execute. Reject and the system stores the reason, which feeds future recommendations.
Executed
The Remediation Agent applies the change inside the scoped blast radius. Observation sampling increases for the affected resources.
What can be an Action
Almost anything that changes state. A non-exhaustive list:Kubernetes changes
Kubernetes changes
Scale a deployment, patch a resource, restart a pod, change a ConfigMap, update an Ingress, roll back to a previous revision.
AWS changes
AWS changes
Resize an EC2 instance, change an RDS parameter, update a Lambda configuration, attach or detach an IAM policy (with extra scrutiny).
GCP changes
GCP changes
Adjust GCE instance size, modify Cloud SQL settings, update Cloud Run traffic splits.
VM and system changes
VM and system changes
Restart a systemd service, adjust a sysctl, deploy a configuration bundle, rotate a secret.
Workflow changes
Workflow changes
Create a Linear ticket, post a Slack message, page an on-call engineer, attach a note to an RCA.
Blast radius, in practice
Every Action knows what it touches directly, and the Knowledge Graph tells it what depends on those targets. Three tiers:- Direct. The exact resources the Action modifies.
- Adjacent. The one-hop dependents that might see a brief effect (cache invalidation, connection churn).
- Downstream. Two-hop or further dependents, flagged if the blast could propagate.
The relationship to Skills
A Skill can emit Actions. The skill runs, the instructions are followed, and anywhere the skill would mutate state, it produces an Action instead of doing it directly. That keeps the approval boundary uniform: whether a human asked for the change or a skill did, the same approval flow and Guardian policies apply.Audit and reversibility
Every Action has a full audit entry:- Who proposed it (which agent, which skill, or which human).
- Who approved it, and when.
- The exact payload that ran.
- The outcome (verified, partial, rollback suggested).
- The reverse operation, if you need to roll back.
Common questions
Can Actions run without human approval?
Can Actions run without human approval?
By default, no. Guardian policies can be set to auto-approve specific low-risk Actions in specific environments (lab namespaces, non-prod clusters), but this is opt-in, not the default.
What happens if an Action fails mid-apply?
What happens if an Action fails mid-apply?
The Remediation Agent records the partial state, stops, and surfaces a new Insight for the partial change. It does not retry automatically. A human reviews the partial state before anything else runs.
Can I batch approve multiple Actions?
Can I batch approve multiple Actions?
Yes, when they share a common parent (an RCA or a skill run). Batch approval still runs each Action through Guardian individually, so a single disallowed step does not break the rest.
How do rollbacks work for Actions that modify state incrementally?
How do rollbacks work for Actions that modify state incrementally?
Where possible, the reverse operation is the literal inverse (scale up, scale down). For multi-step Actions, rollback unwinds in reverse order. Actions that cannot be cleanly reversed (for example, deleting data) require a second level of approval and a confirmed backup reference.
Related concepts
Safety and Guardrails
The policy layer that decides what is approvable.
Action Center in the console
Where Actions live, get reviewed, and get approved.