From agent-almanac
Guides decommissioning of validated GxP systems covering data retention assessment, migration validation, archival strategy, access revocation, and notifications. Use for replacements, end-of-life, or consolidation.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Manages change control for validated computerized systems: triages requests (emergency/standard/minor), assesses impact on validated state, determines revalidation scope, handles approvals, tracks implementation, and verifies post-change. Use for upgrades, patches, config changes, or CAPA modifications in GxP environments.
Generates detailed service decommission documentation with checklists for infrastructure resources, data management, security, networking, integrations, dependencies, and monitoring cleanup.
Implements automated GDPR-compliant data deletion workflows for Article 17 erasure requests and retention expiry, with cascading deletion, dependency handling, and audit logging.
Share bugs, ideas, or general feedback.
Plan and execute the controlled retirement of a validated computerized system while preserving data integrity and meeting regulatory retention requirements.
Determine how long data must be retained and in what form:
# Data Retention Assessment
## Document ID: DRA-[SYS]-[YYYY]-[NNN]
### Regulatory Retention Requirements
| Regulation | Data Type | Retention Period | Format Requirements |
|-----------|-----------|-----------------|-------------------|
| 21 CFR 211 (GMP) | Batch records, test results | 1 year past product expiry or 3 years after distribution | Readable, retrievable |
| 21 CFR 58 (GLP) | Study data and records | Duration of study + retention agreement | Original or certified copy |
| ICH E6 (GCP) | Clinical trial records | 2 years after last marketing approval or formal discontinuation | Accessible for inspection |
| 21 CFR Part 11 | Electronic records | Per predicate rule | Original format or validated migration |
| EU Annex 11 | Computerized system records | Per applicable GxP | Readable and available |
| Tax/financial | Financial records | 7-10 years (jurisdiction-dependent) | Readable |
### System Data Inventory
| Data Category | Volume | Format | Retention Required Until | Disposition |
|---------------|--------|--------|------------------------|-------------|
| [e.g., Batch records] | [e.g., 50,000 records] | [e.g., Database + PDF reports] | [Date] | Migrate / Archive / Destroy |
| [e.g., Audit trail] | [e.g., 2M entries] | [e.g., Database] | [Same as parent records] | Archive |
| [e.g., User data] | [e.g., 200 profiles] | [e.g., LDAP/Database] | [Employment + 2 years] | Anonymise and archive |
Expected: Every data category has a defined retention period, format requirement, and planned disposition. On failure: If retention requirements are unclear, consult regulatory affairs and legal. Default to the longest applicable retention period.
If data is migrating to a replacement system:
# Data Migration Plan
## Document ID: DMP-[SYS]-[YYYY]-[NNN]
### Migration Scope
| Source | Target | Data Category | Records | Migration Method |
|--------|--------|---------------|---------|-----------------|
| [Old system] | [New system] | [Category] | [Count] | ETL / Manual / API |
### Data Mapping
| Source Field | Source Format | Target Field | Target Format | Transformation |
|-------------|-------------|-------------|---------------|---------------|
| [e.g., test_result] | FLOAT(8,2) | [e.g., result_value] | DECIMAL(10,3) | Precision conversion |
| [e.g., operator_id] | VARCHAR(20) | [e.g., user_id] | UUID | Lookup table mapping |
### Validation Approach
| Check | Method | Acceptance Criteria |
|-------|--------|-------------------|
| Record count reconciliation | Source count vs target count | 100% match |
| Field-level comparison | Sample 5% of records, all fields | 100% match after transformation |
| Checksum verification | Hash source vs target for key fields | Checksums match |
| Business rule validation | Verify key calculations in target | Results match source |
| Audit trail continuity | Verify historical audit trail migrated | All entries present with original timestamps |
Expected: Migration plan includes mapping, transformation rules, and validation checks that prove data integrity was maintained. On failure: If migration validation fails, do not proceed to decommission. Fix the migration issues and re-validate.
For data that will be archived rather than migrated:
# Archival Strategy
### Archive Format
| Consideration | Decision | Rationale |
|--------------|----------|-----------|
| Format | [PDF/A, CSV, XML, database backup] | [Why this format survives the retention period] |
| Medium | [Network storage, cloud archive, tape, optical] | [Durability and accessibility] |
| Encryption | [Yes/No — method if yes] | [Security vs long-term accessibility trade-off] |
| Integrity verification | [SHA-256 checksums, periodic verification schedule] | [Prove archive is uncorrupted] |
### Archive Verification
- [ ] Archived data is readable without the source system
- [ ] All required data categories are included in the archive
- [ ] Checksums recorded at time of archival
- [ ] Archive can be searched and retrieved within [defined SLA, e.g., 5 business days]
- [ ] Periodic integrity checks scheduled (annually)
### Archive Access
| Role | Access Level | Authorisation |
|------|-------------|--------------|
| QA Director | Read access to all archived data | Standing authorisation |
| Regulatory Affairs | Read access for inspection support | Standing authorisation |
| System Owner (former) | Read access for business queries | Request-based |
| External auditors | Read access, supervised | Per audit plan |
Expected: Archived data is readable, searchable, and verifiable without the original system. On failure: If data cannot be read independently of the source system, the archive is not compliant. Consider exporting to an open, standard format (PDF/A, CSV) before decommission.
# Decommission Checklist
## Document ID: DC-[SYS]-[YYYY]-[NNN]
### Pre-Decommission
- [ ] All stakeholders notified of decommission date and data disposition
- [ ] Data migration completed and validated (if applicable)
- [ ] Data archive created and verified (if applicable)
- [ ] Final backup of complete system taken and stored separately
- [ ] All open change requests resolved or transferred
- [ ] All open CAPAs resolved or transferred to successor system
- [ ] All active users informed and redirected to replacement system (if applicable)
### Decommission Execution
- [ ] User access revoked for all accounts
- [ ] System removed from production environment
- [ ] Network connections disconnected
- [ ] Licenses returned or terminated
- [ ] System entry removed from active system inventory
- [ ] System moved to "Decommissioned" status in compliance architecture
### Post-Decommission
- [ ] Validation documentation archived (URS, VP, IQ/OQ/PQ, TM, VSR)
- [ ] SOPs retired or updated to remove references to decommissioned system
- [ ] Training records archived
- [ ] Change control records archived
- [ ] Audit trail archived
- [ ] Decommission report completed and approved
### Decommission Report
| Section | Content |
|---------|---------|
| System description | Name, version, purpose, GxP classification |
| Decommission rationale | Why the system is being retired |
| Data disposition summary | What data went where (migrated, archived, destroyed) |
| Validation evidence | Migration validation results, archive verification |
| Residual risk | Any ongoing data retention obligations |
| Approval | System owner, QA, IT signatures |
Expected: Decommissioning is controlled, documented, and approved — not just "turn it off." On failure: If any checklist item cannot be completed, document the exception and obtain QA approval before proceeding.
design-compliance-architecture — update the system inventory and compliance architecture after decommissionmanage-change-control — decommissioning is a major change requiring change controlwrite-validation-documentation — migration validation follows the same IQ/OQ methodologywrite-standard-operating-procedure — retire or update SOPs referencing the decommissioned systemprepare-inspection-readiness — archived data must remain accessible for regulatory inspections