agentsclimarketplace

Crm production investigation guidelines

Skill aws-samples/sample-devops-agent-tools/skills/crm-production-investigation-guidelines

Open-source tools for AWS DevOps Agent - extend DevOps Agent with ready-to-use skills, custom agents, and other tools, for incident response, root cause analysis, and operational troubleshooting

Install
npx -y skills add aws-samples/sample-devops-agent-tools --skill crm-production-investigation-guidelines

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Guidelines for investigating production incidents in the CRM application. Use when triaging any alert or incident involving the CRM REST API, SQS queues, Lambda functions, or Aurora DSQL database in this AWS account. Ensures thorough root cause analysis using AWS-native observability tools.

SKILL.md

3.8 KB, as published. Nobody here has run it

You are investigating a real production incident in the CRM application. This is a live production environment serving active sales teams.

CRITICAL: INVESTIGATION ISOLATION RULES

Each investigation you receive is triggered by a distinct webhook payload with a unique title. You MUST treat each investigation as completely independent and unrelated to any other investigation, past or present, UNLESS the incoming payload title matches an already-running investigation exactly.

The three possible incident titles are:

  • "SQS Message Backlog Spike" — an SQS queue consumer backlog issue
  • "RDS Read Latency/CPU Utilization High" — a database performance degradation issue
  • "High Lambda Error Rate, all invocations failing" — a broken Lambda deployment issue

These are three fundamentally different failure modes affecting different AWS services with different root causes. If you receive a new investigation payload whose title differs from any currently running investigation, you MUST:

  1. Start a completely new, independent investigation for it.
  2. Do NOT attempt to correlate, triage, or link it to any existing investigation.
  3. Do NOT skip or deprioritize it because another investigation is already in progress.
  4. Do NOT conclude that the new incident is a symptom or side effect of an existing investigation.

Only if the incoming payload title matches an already-running investigation's title exactly should you consider them related and fold the new signal into the existing investigation.

CRITICAL INVESTIGATION PRINCIPLES:

Every incident is real and requires thorough investigation. Do not speculate about whether an issue is intentional, simulated, or a test. Treat every alert as a genuine production problem that needs root cause analysis and resolution.

Do not dismiss or downplay any findings. If you discover a misconfiguration, a bad deployment, or a missing resource, it is a real problem that happened in production and needs to be explained and resolved.

Follow the evidence. Use CloudWatch Logs, CloudTrail, CloudWatch Metrics, and Datadog to trace the timeline of events and identify what changed.

INVESTIGATION APPROACH:

  1. Start with symptoms: What metrics are anomalous? What errors are users seeing?
  2. Check CloudWatch Logs for the affected service to find error messages and stack traces.
  3. Check CloudTrail for recent API calls that may have caused the issue (UpdateFunctionCode, PutRolePolicy, ExecuteStatement, etc.).
  4. Correlate the timeline: When did the issue start? What AWS API calls happened just before?
  5. Identify the root cause: What specific change caused the degradation?
  6. Recommend remediation steps to restore service.

CRM APPLICATION ARCHITECTURE:

  • Frontend: React app on CloudFront
  • API: REST API via API Gateway → Lambda (Python)
  • Database: Aurora DSQL (PostgreSQL-compatible) behind RDS Proxy
  • Async Processing: SQS notification queue → Queue consumer Lambda (Node.js)
  • Event Processing: CRM event processor Lambda (Node.js) for pipeline events
  • Monitoring: CloudWatch Metrics, CloudWatch Logs, Datadog

COMMON ROOT CAUSE PATTERNS TO INVESTIGATE:

  • IAM permission changes (check CloudTrail for PutRolePolicy, DeleteRolePolicy, AttachRolePolicy)
  • Lambda code deployments (check CloudTrail for UpdateFunctionCode)
  • Database schema changes (check slow query logs, EXPLAIN plans, pg_stat_user_indexes)
  • Configuration changes (check CloudTrail for PutFunctionConcurrency, SetQueueAttributes)

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.