decommission-validated-system
About
This skill guides developers through the controlled decommissioning of a validated system, ensuring compliance with data retention regulations. It handles key steps like data migration validation, archival strategy, and access revocation. Use it when replacing or retiring a system due to end-of-life, discontinued support, or regulatory changes.
Quick Install
Claude Code
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/decommission-validated-systemCopy and paste this command in Claude Code to install this skill
Documentation
Decommission Validated System
Controlled retirement of validated sys + preserve data integrity + meet retention reqs.
Use When
- Validated sys replaced
- EOL no replacement (biz proc eliminated)
- Vendor discontinues support
- Consolidation → single platform
- Reg / biz changes → obsolete
In
- Required: Sys (name, ver, valid status)
- Required: Retention reqs (21 CFR Part 11, GLP, GCP)
- Required: Replacement sys (if applic) + migration scope
- Optional: Current valid doc pkg
- Optional: Data vol + fmt inventory
- Optional: Biz owner + stakeholders
Do
Step 1: Retention Reqs
How long + 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 |
Got: Every cat has retention + fmt + disposition.
If err: Unclear reqs → consult regulatory + legal. Default longest applic.
Step 2: Migration Plan (If Applic)
Data → replacement:
# 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 |
Got: Plan w/ mapping + transforms + validation → proves integrity.
If err: Migration valid fails → do NOT decommission. Fix + re-validate.
Step 3: Archival Strategy
Data → archive (not migrate):
# 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 |
Got: Archive readable + searchable + verifiable w/o orig sys.
If err: Can't read indep of src sys → not compliant. Export → open std fmt (PDF/A, CSV) pre-decomm.
Step 4: Execute
# 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 |
Got: Decomm = controlled + documented + approved. Not "turn it off".
If err: Any item incomplete → doc exception + QA approval before proceeding.
Check
- Retention reqs assessed all cats
- Migration validated w/ counts + sampling + checksums (if applic)
- Archive in fmt readable w/o src sys
- Archive integrity verified w/ checksums
- All user access revoked
- Valid docs archived w/ retention period
- SOPs updated to remove decomm sys refs
- Decomm report approved: sys owner + QA + IT
Traps
- Premature decomm: Turn off pre-migration valid → permanent data loss. Complete valid first.
- Unreadable archives: Proprietary fmt needs orig sys → defeats purpose. Use open fmts.
- Forgotten audit trails: Archive data but not audit trail → no provenance. Always archive trails w/ parent records.
- Orphaned SOPs: SOPs still ref decomm sys → user confusion + compliance gaps. Update / retire all.
- No periodic archive verify: Archives degrade. No integrity checks → loss undetected until inspection.
→
design-compliance-architecture— update sys inventory post-decommmanage-change-control— decomm = major change → change controlwrite-validation-documentation— migration valid follows same IQ/OQwrite-standard-operating-procedure— retire/update SOPsprepare-inspection-readiness— archived data accessible for inspections
GitHub Repository
Related Skills
evaluating-llms-harness
TestingThis Claude Skill runs the lm-evaluation-harness to benchmark LLMs across 60+ standardized academic tasks like MMLU and GSM8K. It's designed for developers to compare model quality, track training progress, or report academic results. The tool supports various backends including HuggingFace and vLLM models.
cloudflare-cron-triggers
TestingThis skill provides comprehensive knowledge for implementing Cloudflare Cron Triggers to schedule Workers using cron expressions. It covers setting up periodic tasks, maintenance jobs, and automated workflows while handling common issues like invalid cron expressions and timezone problems. Developers can use it for configuring scheduled handlers, testing cron triggers, and integrating with Workflows and Green Compute.
webapp-testing
TestingThis Claude Skill provides a Playwright-based toolkit for testing local web applications through Python scripts. It enables frontend verification, UI debugging, screenshot capture, and log viewing while managing server lifecycles. Use it for browser automation tasks but run scripts directly rather than reading their source code to avoid context pollution.
finishing-a-development-branch
TestingThis skill helps developers complete finished work by verifying tests pass and then presenting structured integration options. It guides the workflow for merging, creating PRs, or cleaning up branches after implementation is done. Use it when your code is ready and tested to systematically finalize the development process.
