agentleFS
harnessharness/harness-skills/skills/observability-governance/incident-response/SKILL.md

incident-response

Skill127 starsChanged 32 days agoApache-2.0View on GitHub

Incident response and analysis via Harness MCP. Correlate incidents with recent deployments, assess blast radius and downstream service impact, and generate comprehensive postmortem documents. Use when asked to investigate an incident, determine if a deployment caused an issue, assess blast radius, or create a postmortem. Do NOT use for pipeline debugging (use debug-pipeline instead) or SLO management (use manage-slos instead). Trigger phrases: incident, deployment correlation, blast radius, postmortem, root cause, service impact, outage analysis, rollback decision, incident timeline, deployment caused, which deploy.

81 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use background-jobs, data-modeling and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • YepAPISkill

    background-jobs

    Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

    Also in 4 projects that use this

  • MicrosoftSkill

    data-modeling

    Use when the app needs to store or read data — records, a database, entities, CRUD, lists, "save/remember X", or per-user data with row-level security. This app's data layer is Rayfin's: you declare entities as TypeScript classes with decorators in rayfin/data/, register them in the schema, and read/write them through the typed rayfin-client. Covers: defining an @entity, field decorators, registering it, per-entity access with @role, owner-only row-level security, and the client query/mutation API. Triggers: data, database, model, entity, schema, table, record, CRUD, create, read, update, delete, list, store, save, persist, per-user, row-level security, RLS, access control, ownership.

    Also in 7 projects that use this

  • YepAPISkill

    data-pipelines

    ETL patterns, cron scheduling, queue-based processing, and batch jobs with Inngest/BullMQ.

    Also in 4 projects that use this

  • mmondoraSkill

    infrastructure-as-code

    Infrastructure as Code with Terraform and Pulumi. State management, modularity, drift detection, secrets handling. Use when provisioning cloud resources, writing Terraform/Pulumi modules, or managing infrastructure configuration.

    Also in 5 projects that use this

  • csiddhant796-blipSkill

    threat-detection

    Use when hunting for threats in an environment, analyzing IOCs, or detecting behavioral anomalies in telemetry. Covers hypothesis-driven threat hunting, IOC sweep generation, z-score anomaly detection, and MITRE ATT&CK-mapped signal prioritization.

    Also in 3 projects that use this

  • motao123Skill

    browser-verification

    Use when a change needs browser-level evidence such as UI flow checks, form interaction validation, console inspection, or end-to-end smoke verification. This skill focuses on observable behavior instead of code assumptions.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 13 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 68 edited versions we read keep these.

  • 13

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check if a rollback was performed and whether it resolved the issue

    line 73
  2. Distinctive:

    If deployment-correlated: recommend rollback with expected resolution time

    line 106
  3. Distinctive:

    If infrastructure-related: recommend failover or scaling

    line 107
  4. Distinctive:

    If dependency-related: recommend circuit breaker activation or graceful degradation

    line 108
  5. Distinctive:

    When was the issue first detected?

    line 122
  6. Distinctive:

    When did the on-call team engage?

    line 123
  7. Distinctive:

    When was mitigation applied and service restored?

    line 125
  8. Distinctive:

    Always include what went well in the postmortem -- blameless culture requires acknowledging good responses.

    line 159
  9. Distinctive:

    Check for infrastructure changes (not just code deployments)

    line 165
  10. Distinctive:

    Look for config changes, feature flag toggles, or certificate expirations

    line 166
  11. Distinctive:

    Look for shared infrastructure (databases, message queues) that multiple services use

    line 170
  12. Distinctive:

    Check for external dependencies (third-party APIs, DNS, CDN)

    line 171
  13. Distinctive:

    Check if automated rollbacks occurred that may not be in the deployment history

    line 175

“Common” is measured: kept by at least 6 in 10 of the 68 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Incident Response

Correlate incidents with deployments, assess blast radius, and generate postmortem documents using Harness MCP.

Instructions

Step 1: Establish Scope

Confirm the affected service, environment, and incident details.

Call MCP tool: harness_list
Parameters:
  resource_type: "service"
  org_id: "<organization>"
  project_id: "<project>"

Step 2: Identify the Incident Response Task

Determine which workflow the user needs:

  1. Deployment-to-Incident Correlation -- Determine if a recent deployment caused the incident
  2. Blast Radius Assessment -- Map affected services and downstream impact
  3. Postmortem Generation -- Create a structured postmortem document

Step 3: Correlate Deployment to Incident

Gather from the user:

  • Affected service name and environment
  • Alert or incident name and start time
  • Observed symptoms (error rate spike, latency, outage)

Pull recent deployments:

Call MCP tool: harness_list
Parameters:
  resource_type: "execution"
  org_id: "<organization>"
  project_id: "<project>"
  status: "Success"

For each recent deployment, check:

  • Timing: Was the deployment within the incident correlation window (e.g., 2 hours before)?
  • Service match: Does the deployed service match or depend on the affected service?
  • Change content: What changed in the deployment (config, code, infrastructure)?

Build a deployment timeline:

  1. List all deployments to the affected environment in the last N hours
  2. Mark the incident start time on the timeline
  3. Identify the most likely causal deployment (closest before incident start)
  4. Check if a rollback was performed and whether it resolved the issue

Present findings with confidence level: HIGH (deployment matches timing + service), MEDIUM (timing matches but different service), LOW (no deployment correlation found).

Step 4: Assess Blast Radius

Gather from the user:

  • Failing service and failure type (outage, elevated error rate, high latency)
  • Current error rate or severity
  • Environment

Map the impact:

Call MCP tool: harness_status
Parameters:
  org_id: "<organization>"
  project_id: "<project>"

Assess:

  • Direct impact: The failing service's error rate, latency, and availability
  • Upstream callers: Services that call the failing service -- are they degrading?
  • Downstream dependencies: Services the failing service depends on -- are they healthy?
  • User impact: Estimate affected users based on traffic volume
  • Data integrity: Any risk of data corruption or inconsistency?

Classify severity:

  • Critical: User-facing outage, data loss risk, or multiple services affected
  • Major: Degraded performance affecting users, single service impacted
  • Minor: Internal service degraded, no user-facing impact

Recommend immediate actions based on blast radius:

  • If deployment-correlated: recommend rollback with expected resolution time
  • If infrastructure-related: recommend failover or scaling
  • If dependency-related: recommend circuit breaker activation or graceful degradation

Step 5: Generate Postmortem

Gather from the user:

  • Service name and incident summary
  • Incident duration and environment
  • Resolution steps taken

Structure the postmortem:

1. Executive Summary -- What happened, customer impact, duration (2-3 sentences)

2. Timeline -- Build from Harness pipeline events and alert timestamps:

  • When was the issue first detected?
  • When did the on-call team engage?
  • What deployment or change triggered the regression?
  • When was mitigation applied and service restored?

Pull timeline data:

Call MCP tool: harness_list
Parameters:
  resource_type: "execution"
  org_id: "<organization>"
  project_id: "<project>"

3. Root Cause Analysis -- Which deployment or change triggered the incident and why

4. Impact Assessment -- Affected services, environments, and approximate user impact

5. Action Items -- Categorized as:

  • Immediate fixes (address the root cause)
  • Process improvements (prevent recurrence)
  • Monitoring improvements (detect faster)

6. Lessons Learned -- What went well, what didn't, and what was lucky

Examples

  • "Our payment service is down -- was it a deployment?" -- Correlate incident with recent deployments and provide confidence level
  • "What is the blast radius of the checkout outage?" -- Map upstream/downstream services and estimate user impact
  • "Generate a postmortem for yesterday's auth-service incident" -- Create structured postmortem with timeline, RCA, and action items
  • "A Sev-1 just fired -- which deployment caused it?" -- Pull recent deployments and correlate with alert timing

Performance Notes

  • Deployment correlation is most accurate within a 2-hour window -- beyond that, other factors become more likely.
  • Blast radius assessment requires an up-to-date service dependency map -- stale maps miss connections.
  • Postmortems should be generated within 48 hours while the incident is fresh in the team's memory.
  • Always include what went well in the postmortem -- blameless culture requires acknowledging good responses.

Troubleshooting

No Deployment Found in Correlation Window

  • Expand the search window to 4-6 hours -- some failures have delayed onset
  • Check for infrastructure changes (not just code deployments)
  • Look for config changes, feature flag toggles, or certificate expirations

Blast Radius Assessment Missing Services

  • The service dependency map may be incomplete -- check for undocumented dependencies
  • Look for shared infrastructure (databases, message queues) that multiple services use
  • Check for external dependencies (third-party APIs, DNS, CDN)

Postmortem Missing Timeline Events

  • Pull from multiple sources: pipeline executions, alert history, and chat transcripts
  • Check if automated rollbacks occurred that may not be in the deployment history
  • Include infrastructure events (auto-scaling, node failures) alongside deployment events

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.