Incident Response Skill
Guide production incident response for Talosix EDC clinical trial systems. Clinical trial systems have unique incident response requirements because system failures can impact patient safety, data integrity, and regulatory compliance.
When to Use
- A production incident has been reported or detected
- Drafting an incident response plan for a new system
- Conducting post-incident review and root cause analysis
- Preparing CAPA documentation after an incident
Severity Classification
Clinical Trial System Severity Matrix
| Severity |
System Impact |
Clinical Impact |
Examples |
| SEV-1: Critical |
System unavailable or data integrity compromised |
Patient safety risk or regulatory non-compliance |
Data corruption in eCRFs; audit trail failure; system-wide outage during active data collection; e-signature system failure |
| SEV-2: High |
Major feature unavailable, no workaround |
Clinical workflow blocked for multiple sites |
Form submission failures; randomization integration down; data export broken; query workflow non-functional |
| SEV-3: Medium |
Feature degraded, workaround available |
Clinical workflow impacted but can continue |
Slow performance; intermittent errors with retry success; single-site access issues; reporting delays |
| SEV-4: Low |
Minor issue, minimal user impact |
No clinical workflow impact |
UI cosmetic issues; non-critical notification delays; minor display errors |
Patient Safety Impact Assessment
For every SEV-1 and SEV-2 incident, immediately assess:
- Can sites still record adverse events and SAEs?
- Is subject randomization affected?
- Can protocol deviations be documented?
- Is unblinding functionality available (for emergencies)?
- Are safety reports (CIOMS, MedWatch) generation affected?
If any answer is "No," escalate to Clinical Operations and Regulatory immediately.
Incident Response Procedure
Phase 1: Detection and Triage (Target: < 15 minutes)
Acknowledge the incident
- Confirm the report (automated alert or user report)
- Assign an Incident Commander (IC)
- Create an incident channel (e.g., #inc-YYYY-MM-DD-description)
Initial triage
- Classify severity using the matrix above
- Identify affected components and studies
- Determine blast radius: how many users, sites, studies impacted
- Assess clinical impact using the patient safety checklist
Assemble response team
- SEV-1: IC + Backend + Frontend + DBA + QA + Clinical Ops + CTO
- SEV-2: IC + Backend + relevant domain engineer + QA
- SEV-3: IC + assigned engineer
- SEV-4: Assigned to sprint backlog
Phase 2: Investigation (Target: varies by severity)
Gather evidence
- Application logs (error logs, access logs)
- Database logs and slow query logs
- Infrastructure metrics (CPU, memory, disk, network)
- Recent deployments or configuration changes
- User-reported symptoms and reproduction steps
Establish timeline
- When did the issue start?
- What changed around that time? (deploys, config, traffic patterns)
- Is the issue ongoing, intermittent, or resolved?
Identify root cause or contributing factors
- Code defect
- Infrastructure failure
- Configuration error
- Data issue
- External dependency failure
- Capacity/scaling issue
Determine resolution path
- Can it be resolved with a configuration change?
- Does it require a hotfix? (see hotfix-procedure skill)
- Does it require a rollback? (see rollback-plan skill)
- Can it be mitigated while a permanent fix is developed?
Phase 3: Resolution
Implement the fix or mitigation
- Follow hotfix procedure if code change required
- Document all actions taken with timestamps
- Have a second person verify the fix
Verify resolution
- Confirm the reported issue is resolved
- Run targeted smoke tests
- Monitor for recurrence (minimum 1 hour for SEV-1/SEV-2)
- Verify no collateral damage
Stand down
- IC declares incident resolved
- Update status page / communication channels
- Set monitoring watch period
Phase 4: Post-Incident
Incident report (within 24 hours)
- Timeline of events
- Root cause analysis
- Impact assessment (users, studies, data)
- Resolution details
- Action items for prevention
Post-incident review (within 5 business days)
- Blameless review with all involved parties
- Focus on systemic improvements, not individual fault
- Document what went well and what needs improvement
- Generate action items with owners and due dates
CAPA assessment (see below)
Root Cause Analysis Framework
Use the "5 Whys" method or Fishbone (Ishikawa) diagram:
Problem: [Describe the incident]
Why 1: [First-level cause]
Why 2: [Deeper cause]
Why 3: [Deeper cause]
Why 4: [Deeper cause]
Why 5: [Root cause]
Root Cause: [Summary]
Contributing Factors: [List]
Categories for Fishbone analysis:
- Code: Bugs, logic errors, edge cases
- Infrastructure: Hardware, network, cloud services
- Process: Deployment, testing, review gaps
- People: Training, communication, handoff issues
- Data: Data quality, migration, integration
- External: Third-party services, dependencies
CAPA Follow-Up
A Corrective and Preventive Action is REQUIRED when:
- Patient safety was potentially impacted
- Clinical data integrity was compromised
- Regulatory non-compliance occurred
- The same root cause has caused previous incidents
CAPA documentation must include:
- Description of the nonconformity (what happened)
- Impact assessment (who/what was affected)
- Root cause (from RCA above)
- Corrective action (fix the immediate problem)
- Preventive action (prevent recurrence)
- Effectiveness check (how to verify the CAPA worked)
- Timeline and ownership (who does what by when)
Communication Templates
Internal: Incident Declared
@channel INCIDENT DECLARED - SEV-<level>
Issue: <Brief description>
Impact: <What is affected>
Clinical Impact: <Assessment>
Affected Studies: <List or "Assessing">
IC: <Name>
War Room: <Channel/link>
Status: Investigating
Next update: <Time>
Customer-Facing: Issue Acknowledged
Subject: Talosix System Alert - <Brief Description>
We have identified an issue affecting <description of impact>.
Impact: <What users may experience>
Workaround: <If available>
Status: Our team is actively investigating and working on resolution.
We will provide updates every <frequency>.
If you have questions, contact support@talosix.com.
Regulatory Notification (if required)
Subject: System Incident Notification - <System Name>
Incident Date/Time: <Timestamp>
System: <Affected system>
Description: <What occurred>
Clinical Impact Assessment: <Detailed assessment>
Data Integrity Impact: <Assessment>
Studies Affected: <List>
Corrective Actions Taken: <Summary>
CAPA Status: <Initiated / Under Assessment>
This notification is provided in accordance with [applicable regulation/SOP].
Using Allowed Tools
During incident investigation:
- Use Read to examine log files, configuration, and source code
- Use Grep to search for error patterns across logs and codebase
- Use Glob to locate relevant files (logs, configs, source)
- Use Bash to run diagnostic commands, check service status, query databases
1---2name: incident-response3description: Production incident response framework for Talosix EDC systems. Covers severity classification with patient safety considerations, investigation steps, root cause analysis, communication templates, and CAPA follow-up.4---56# Incident Response Skill78Guide production incident response for Talosix EDC clinical trial systems. Clinical trial systems have unique incident response requirements because system failures can impact patient safety, data integrity, and regulatory compliance.910## When to Use1112- A production incident has been reported or detected13- Drafting an incident response plan for a new system14- Conducting post-incident review and root cause analysis15- Preparing CAPA documentation after an incident1617## Severity Classification1819### Clinical Trial System Severity Matrix2021| Severity | System Impact | Clinical Impact | Examples |22|----------|--------------|-----------------|----------|23| **SEV-1: Critical** | System unavailable or data integrity compromised | Patient safety risk or regulatory non-compliance | Data corruption in eCRFs; audit trail failure; system-wide outage during active data collection; e-signature system failure |24| **SEV-2: High** | Major feature unavailable, no workaround | Clinical workflow blocked for multiple sites | Form submission failures; randomization integration down; data export broken; query workflow non-functional |25| **SEV-3: Medium** | Feature degraded, workaround available | Clinical workflow impacted but can continue | Slow performance; intermittent errors with retry success; single-site access issues; reporting delays |26| **SEV-4: Low** | Minor issue, minimal user impact | No clinical workflow impact | UI cosmetic issues; non-critical notification delays; minor display errors |2728### Patient Safety Impact Assessment2930For every SEV-1 and SEV-2 incident, immediately assess:31- Can sites still record adverse events and SAEs?32- Is subject randomization affected?33- Can protocol deviations be documented?34- Is unblinding functionality available (for emergencies)?35- Are safety reports (CIOMS, MedWatch) generation affected?3637If any answer is "No," escalate to Clinical Operations and Regulatory immediately.3839## Incident Response Procedure4041### Phase 1: Detection and Triage (Target: < 15 minutes)42431. **Acknowledge the incident**44 - Confirm the report (automated alert or user report)45 - Assign an Incident Commander (IC)46 - Create an incident channel (e.g., #inc-YYYY-MM-DD-description)47482. **Initial triage**49 - Classify severity using the matrix above50 - Identify affected components and studies51 - Determine blast radius: how many users, sites, studies impacted52 - Assess clinical impact using the patient safety checklist53543. **Assemble response team**55 - SEV-1: IC + Backend + Frontend + DBA + QA + Clinical Ops + CTO56 - SEV-2: IC + Backend + relevant domain engineer + QA57 - SEV-3: IC + assigned engineer58 - SEV-4: Assigned to sprint backlog5960### Phase 2: Investigation (Target: varies by severity)61621. **Gather evidence**63 - Application logs (error logs, access logs)64 - Database logs and slow query logs65 - Infrastructure metrics (CPU, memory, disk, network)66 - Recent deployments or configuration changes67 - User-reported symptoms and reproduction steps68692. **Establish timeline**70 - When did the issue start?71 - What changed around that time? (deploys, config, traffic patterns)72 - Is the issue ongoing, intermittent, or resolved?73743. **Identify root cause or contributing factors**75 - Code defect76 - Infrastructure failure77 - Configuration error78 - Data issue79 - External dependency failure80 - Capacity/scaling issue81824. **Determine resolution path**83 - Can it be resolved with a configuration change?84 - Does it require a hotfix? (see hotfix-procedure skill)85 - Does it require a rollback? (see rollback-plan skill)86 - Can it be mitigated while a permanent fix is developed?8788### Phase 3: Resolution89901. **Implement the fix or mitigation**91 - Follow hotfix procedure if code change required92 - Document all actions taken with timestamps93 - Have a second person verify the fix94952. **Verify resolution**96 - Confirm the reported issue is resolved97 - Run targeted smoke tests98 - Monitor for recurrence (minimum 1 hour for SEV-1/SEV-2)99 - Verify no collateral damage1001013. **Stand down**102 - IC declares incident resolved103 - Update status page / communication channels104 - Set monitoring watch period105106### Phase 4: Post-Incident1071081. **Incident report** (within 24 hours)109 - Timeline of events110 - Root cause analysis111 - Impact assessment (users, studies, data)112 - Resolution details113 - Action items for prevention1141152. **Post-incident review** (within 5 business days)116 - Blameless review with all involved parties117 - Focus on systemic improvements, not individual fault118 - Document what went well and what needs improvement119 - Generate action items with owners and due dates1201213. **CAPA assessment** (see below)122123## Root Cause Analysis Framework124125Use the "5 Whys" method or Fishbone (Ishikawa) diagram:126127```128Problem: [Describe the incident]129 Why 1: [First-level cause]130 Why 2: [Deeper cause]131 Why 3: [Deeper cause]132 Why 4: [Deeper cause]133 Why 5: [Root cause]134135Root Cause: [Summary]136Contributing Factors: [List]137```138139Categories for Fishbone analysis:140- **Code**: Bugs, logic errors, edge cases141- **Infrastructure**: Hardware, network, cloud services142- **Process**: Deployment, testing, review gaps143- **People**: Training, communication, handoff issues144- **Data**: Data quality, migration, integration145- **External**: Third-party services, dependencies146147## CAPA Follow-Up148149A Corrective and Preventive Action is REQUIRED when:150- Patient safety was potentially impacted151- Clinical data integrity was compromised152- Regulatory non-compliance occurred153- The same root cause has caused previous incidents154155CAPA documentation must include:1561. **Description of the nonconformity** (what happened)1572. **Impact assessment** (who/what was affected)1583. **Root cause** (from RCA above)1594. **Corrective action** (fix the immediate problem)1605. **Preventive action** (prevent recurrence)1616. **Effectiveness check** (how to verify the CAPA worked)1627. **Timeline and ownership** (who does what by when)163164## Communication Templates165166### Internal: Incident Declared167```168@channel INCIDENT DECLARED - SEV-<level>169170Issue: <Brief description>171Impact: <What is affected>172Clinical Impact: <Assessment>173Affected Studies: <List or "Assessing">174IC: <Name>175War Room: <Channel/link>176177Status: Investigating178Next update: <Time>179```180181### Customer-Facing: Issue Acknowledged182```183Subject: Talosix System Alert - <Brief Description>184185We have identified an issue affecting <description of impact>.186187Impact: <What users may experience>188Workaround: <If available>189Status: Our team is actively investigating and working on resolution.190191We will provide updates every <frequency>.192193If you have questions, contact support@talosix.com.194```195196### Regulatory Notification (if required)197```198Subject: System Incident Notification - <System Name>199200Incident Date/Time: <Timestamp>201System: <Affected system>202Description: <What occurred>203Clinical Impact Assessment: <Detailed assessment>204Data Integrity Impact: <Assessment>205Studies Affected: <List>206Corrective Actions Taken: <Summary>207CAPA Status: <Initiated / Under Assessment>208209This notification is provided in accordance with [applicable regulation/SOP].210```211212## Using Allowed Tools213214During incident investigation:215- Use **Read** to examine log files, configuration, and source code216- Use **Grep** to search for error patterns across logs and codebase217- Use **Glob** to locate relevant files (logs, configs, source)218- Use **Bash** to run diagnostic commands, check service status, query databases