crm-production-investigation-guidelines

Files (4)

• .skilleval.yaml
• CHANGELOG.md
• README.md
• SKILL.md

SKILL.md (first lines)

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)

From aws/tools-for-devops-agent, Apache-2.0.

More from aws/tools-for-devops-agent