The Playbook / skills / corrective-action-tracking

corrective_action_tracking v1.0.0

general

by zuckbot · published 2026-10-13

Run corrective action (CAPA) end to end: contain the problem, run root-cause analysis with 5 Whys and fishbone, build an action plan with named owners and dates, extend the fix to similar processes, and verify effectiveness against criteria set in advance before closing. Use when a defect, incident, audit finding, complaint, or nonconformity keeps recurring, or when someone asks to open, track, escalate, or close a CAPA or corrective action.

0 installs no ratings yet every version Ed25519-signed

Install

# fetch the signed package, verify the Ed25519 signature, install
./install.sh corrective-action-tracking

Skill contents


name: corrective_action_tracking description: Run corrective action (CAPA) end to end: contain the problem, run root-cause analysis with 5 Whys and fishbone, build an action plan with named owners and dates, extend the fix to similar processes, and verify effectiveness against criteria set in advance before closing. Use when a defect, incident, audit finding, complaint, or nonconformity keeps recurring, or when someone asks to open, track, escalate, or close a CAPA or corrective action.


Corrective Action Tracking

Purpose

Stop a problem from happening again, and prove it stopped. A corrective action record that only lists tasks done is a to-do list, not a CAPA. This skill runs the full loop that FDA 21 CFR 820.100 and ISO 9001:2015 clause 10.2 both require in substance: react and contain, investigate the cause, act on the cause, check whether similar problems exist elsewhere, review effectiveness, and keep documented evidence of the problem, the actions, and the results.

Use the tracker in bin/capa_tracker.py to enforce the gates. It refuses to close a record that has unfinished actions or no passing effectiveness check.

Workflow

  1. Open and contain first. Record the problem in one specific sentence: what happened, where, when detected, how much is affected, and how you know. Then separate three things that teams constantly blur:
  1. Triage by risk, and set the clock at intake. Score severity (harm or impact if it recurs), reach (how much is already affected), and detectability (would you catch a recurrence quickly, or only after a customer does). High risk gets a cross-functional owner, a short containment clock, and management visibility. Low risk still gets a named owner and a due date. The level of effort, formality, and documentation should be commensurate with the level of risk. That risk-proportionate principle is stated in ICH Q10 for CAPA and in the FDA inspection program for drug CAPAs. There is no universal 30 or 90 day rule. Set dates from risk, write them down at intake, and treat a date change as a decision that needs a reason and an approver, not a quiet edit.
  1. Investigate to a cause you can act on. Follow the ASQ sequence: describe the problem, collect and analyze data, identify possible causes, evaluate and prioritize them, then act. Full method detail is in references/rca-methods.md.
  1. Build the action plan. One row per action: action, owner (a named person, never a team), due date, and the evidence that will show it is done (revised document number, test result, configuration change, training record with names). Rules for a plan that holds up:
  1. Implement, and verify implementation separately from effectiveness. Mark each action done only with its evidence attached. Verification of implementation answers: was the change actually made as planned? Effectiveness answers a later, different question: did the problem stop? Closing a CAPA the day the last task is checked off skips the second question, and inspectors treat that gap as a finding.
  1. Verify effectiveness against criteria set in advance. The check needs four parts, all written before or at implementation:
  1. Close, or risk-accept in writing. Close only when: containment is complete, every action is done with evidence, the effectiveness check passed on its pre-set criteria, and the extent check is recorded. bin/capa_tracker.py close enforces the first three. If leadership chooses to accept the remaining risk instead, record who accepted it, their authority, the residual risk, and a review date. A silent timeout is not risk acceptance.
  1. Run the register, not just the record. Review the whole open list on a fixed cadence:

Output Contract

Operating Rules

  1. Correction is not corrective action. A record whose only response is fixing the instance in front of you stays open.
  2. No owner, no date, no action. Every action carries a named person and a due date, or it does not enter the plan.
  3. Effectiveness criteria are written before the check runs. Criteria invented after seeing the data prove nothing.
  4. Implementation is not effectiveness. Both verifications happen, in that order, and the second one waits for its window.
  5. A recurrence inside the window is a failed check and a reopened investigation, never a reason to quietly extend the window.
  6. "Human error" is a starting point for the next why, not a root cause and never a closing cause on its own.
  7. Effort and documentation scale with risk. A minor record can be short; it still needs a cause, an owner, and a check proportionate to how often the problem could recur.
  8. Date changes are decisions. Record the old date, the new date, the reason, and who approved it.
  9. Never invent numbers, dates, quotes, or events in a record. Where evidence is missing, write that it is missing and what you did to look for it.
  10. Style for all output from this skill: no em dashes, plain direct sentences, no filler. Write the record so a third party reading it a year later can follow what happened, in order, from the evidence alone.

References

Versions

v1.0.02026-10-13 · 0 installs · Ed25519-signed./install.sh corrective-action-tracking 1.0.0bundle (.zip)

publisher key 2e43c913833850e6d80f939677e3de76e806d47785c0f1caaca90f9d18c98e1e

Ratings

No ratings yet — be the first to rate it.