From compliance-testing
Reviews a completed control-test workpaper for QA along named dimensions: scope alignment to the test plan, source-criteria sufficiency, evidence reliability, procedure execution rigor, exception classification, conclusion support, severity calibration, reviewer separation, and remediation handoff. Output is a QA review pack — Excel workbook with QA markup tabs over the workpaper plus a Word QA memo summary — that lists deficiencies by severity, a decision (accept, return for rework, conditional accept), and required rework before workpaper closure. Best for: - A second-line QA function or independent reviewer is performing the standard QA pass over a completed workpaper before issue closure or examiner sharing. - An internal-audit director is rolling up workpaper-quality metrics across a testing cycle and needs structured QA notes per workpaper. - A targeted Federal Reserve, OCC, FDIC, CFPB, NYDFS, or state DOI exam is imminent and the team is doing a self-QA sweep on the workpaper population the examiner will likely sample. - A workpaper failed prior QA, was reworked, and needs a post-rework re-QA before closure. Not the right tool when: - The workpaper has not been drafted. Use `workpaper-drafter`. - The test plan itself is being reviewed (design-stage review of `test-plan-builder` output, not QA of a completed workpaper). - Exceptions identified during QA need their own classification. Use `exception-analysis` for the QA-identified deviations from the methodology, not for the original control deviations the workpaper already classified. - The work is drafting an issue from a confirmed finding. Use `risk-compliance-core/skills/issue-writeup`; this skill's deficiency findings on the workpaper are not the same as control issues on the entity.
How this skill is triggered — by the user, by Claude, or both
Slash command
/compliance-testing:qa-workpaper [workpaper ID, exception register ID, prior QA note for re-QA, or pointer to a workpaper population for examiner-prep sweep][workpaper ID, exception register ID, prior QA note for re-QA, or pointer to a workpaper population for examiner-prep sweep]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
QA review of a completed control-test workpaper is the last step before workpaper closure and the audit trail an examiner reads when sampling the firm's testing program. The bar is the AICPA AU-C 230 experienced-auditor sufficiency standard plus the firm's methodology floors: an experienced reviewer with no prior connection to the engagement should be able to read the workpaper, follow the evid...
TROUBLESHOOTING.mdexamples/examiner-prep-tprm-sweep.mdexamples/reg-e-error-resolution-bank.mdreferences/cross-cutting/conduct.mdreferences/cross-cutting/cyber.mdreferences/sector-overlays/banking.mdreferences/sector-overlays/capital-markets.mdreferences/sector-overlays/insurance.mdreferences/sector-overlays/payments-fintech.mdreferences/source-anchors.mdtemplates/default-output.mdQA review of a completed control-test workpaper is the last step before workpaper closure and the audit trail an examiner reads when sampling the firm's testing program. The bar is the AICPA AU-C 230 experienced-auditor sufficiency standard plus the firm's methodology floors: an experienced reviewer with no prior connection to the engagement should be able to read the workpaper, follow the evidence to the conclusion, and reach the same call. Where the workpaper does not pass that bar, the QA review note carries the named deficiencies, a decision, and the rework items.
This skill produces the QA review pack as two artifacts: an Excel workbook with QA markup tabs over the workpaper, and a Word QA memo summary. The skill does not run the test, re-classify the original exceptions, or close the workpaper. It produces the markdown content spec in templates/default-output.md shape; rendering goes to the xlsx and docx skills in document-skills. The skill stops at QA reviewer sign-off; disagreement between the QA reviewer and the workpaper reviewer escalates per the firm's named escalation path.
Before reviewing, get plain answers. Most reviews answer them in the workpaper header and the QA scope brief; if not, default and flag.
targeted-re-review by a different role with the limitation documented on the face; the firm names a compensating control (rotated reviewer pool; cross-pod QA; external QA at audit-cycle close) and the QA review note carries the structural limitation as a named risk for steering. Don't paper over it.references/firm-overlay.md if installed, else from references/source-anchors.md (AICPA AU-C 265 deficiency / significant deficiency / material weakness hierarchy). Severity inflation and severity deflation are both calibration findings; the floor is the discipline that catches both.When scope (per risk-compliance-core/scoping) is supplied, consume it: institution.type and institution.primary_regulators set the supervisory framing, sector_overlay_set selects which references/sector-overlays/<sector>.md loads, cross_cutting_overlay_set selects the references/cross-cutting/<topic>.md files, persona.role sets which decision forum the QA pack passes through, source_posture constrains what the body can carry. When it is not supplied, draft against what the workpaper carries, default to the testing program's standing posture, and note in the QA review note that scope was not formalised separately.
The QA review has the same spine across workpaper types. The QA reviewer reads the workpaper end to end first, then walks the named QA dimensions in the order observation surfaces them, not in lockstep.
The header pins the QA review to the workpaper: QA review ID, workpaper ID (foreign key into workpaper-drafter output), test ID (foreign key into test-plan-builder output), control ID, period under test, preparer role and date (carried from workpaper), workpaper reviewer role and date (carried from workpaper), QA reviewer role and date, QA scope (full-review, targeted-re-review, post-issue-re-qa, examiner-prep-sweep), engagement ID. Reviewer separation is structural: preparer, workpaper reviewer, and QA reviewer must be three distinct roles. The header is the audit trail when QA is later contested in steering, in court, or with a regulator.
QA criteria names the methodology references this review applied. Standing criteria carry the audit-quality methodology (AU-C 220, 230, 265, 530), the IIA QAIP and supervision standards, the firm methodology, and the loaded sector and cross-cutting overlays. The criteria block is the audit trail for what the QA was measured against.
The deficiency register is the load-bearing body. One row per deficiency. For each:
scope-alignment / criteria-sufficiency / evidence-reliability / procedure-execution / exception-classification / conclusion-support / severity-calibration / reviewer-separation / remediation-handoff / formatting. Category is the load-bearing field; it drives the dimension this deficiency belongs to and the rework expectation.critical (workpaper must be returned), major (rework required, can re-issue), or minor (note for future cycles), paired with severity rationale that references the firm methodology floor or the experienced-auditor sufficiency standard. Severity assignment always carries human review.references/source-anchors.md, the loaded overlays, or the firm overlay. "Firm methodology" without a section reference is not defensible.Sample re-perform is the QA reviewer's discipline that surfaces substantive deficiencies. The QA reviewer selects a small subsample (typically three to seven items, across the workpaper's stratification), re-performs the procedures, and compares QA outcome to the workpaper's recorded outcome. Divergences route into the deficiency register. The re-perform tab carries the comparison; the deficiency register carries the consequences. QA re-perform is the most credible QA dimension; skipping it on high-stakes workpapers (consumer-facing, examiner-prep, post-issue re-QA, large-deviation-rate populations) weakens the QA posture and the deliverable's defensibility.
Severity calibration challenges the workpaper's severity ratings against the firm methodology floors (where they exist) and against analogous prior workpapers. Floor violations are the calibration deficiency type that has the most consequences: severity inflation (rated medium where the floor is high) buries findings that the examiner will surface anyway; severity deflation buries findings the testing program needs to track. Both directions get pushback. Where the firm has not set methodology floors, the AU-C 265 deficiency / significant deficiency / material weakness hierarchy is the borrowed frame.
Conclusion support assesses whether the workpaper's conclusion (design effectiveness, operating effectiveness, combined where applicable) is supported by the evidence and procedures. The assessment is supported, partially-supported, or not-supported, with rationale. Where conclusion language drifts toward legal-violation framing ("the firm violated [Reg X]"), the QA reviewer rewrites to control-effectiveness language and routes the legal question to legal counsel and the head of regulatory affairs separately. Conclusion-language hygiene is a recurring QA intervention on consumer-facing workpapers; the conduct cross-cutting overlay carries the rewrite pattern.
Decision is the QA reviewer's call: accept (workpaper passes QA, minor noted carry forward as housekeeping), conditional-accept (workpaper passes once specific rework items are addressed; the rework list is the closure gate), or return-for-rework (workpaper does not pass; preparer or reviewer must redo named items and re-submit for QA). Critical deficiencies return the workpaper; major deficiencies typically conditional-accept; minor deficiencies typically accept with the items noted. Issue closure approval status is a separate field: approved, not-approved, or not-applicable. A clean workpaper does not necessarily mean a closeable issue; the workpaper carries open issues that have their own remediation lifecycles.
Reviewer questions captures everything that could not be resolved in the QA review or that the QA reviewer wants the workpaper reviewer to consider before re-submission. Cluster questions for the audience that decides them; severity calibration questions and conclusion-language questions go in the same list when both apply.
The sign-off block carries the QA reviewer role and date and the escalation path if disagreement persists between the QA reviewer and the workpaper reviewer. The escalation typically routes to the testing manager, the head of compliance testing, or internal audit lead per the firm's named gate. Source trace and confidence label close the QA review note: every material claim cites a source with section reference, and the confidence label (high / medium / low / unknown) reflects evidence sufficiency for the QA review itself (re-perform completeness, methodology depth applied, time available for the review).
The same QA spine carries different conventions across sectors and cross-cutting topics. Load only the overlays the scope flags:
references/sector-overlays/banking.md is the heaviest overlay in the file set. Bank-supervisory expectations on independent QA over the testing program are explicit in the CFPB CMS examination procedures, the OCC Comptroller's Handbook CMS module, and SR 08-8. The overlay carries the population-definition and extract-integrity QA scope items, the consumer-compliance control-area QA notes (HMDA, CRA, Reg B, Reg DD, Reg E, Reg Z, BSA/AML), and the sponsor-bank examiner-prep-sweep posture.references/sector-overlays/insurance.md carries the Model Audit Rule ICFR documentation review conventions and the state DOI market-conduct workpaper-review conventions.references/sector-overlays/capital-markets.md carries the FINRA 3120 / 3130 supervisory-controls QA conventions, the Rule 206(4)-7 annual-review QA conventions, and the conclusion-language hygiene posture (especially important in capital-markets QA because of the enforcement environment).references/sector-overlays/payments-fintech.md carries the sponsor-bank QA conventions, the Reg E error-resolution clock-driven QA dimensions, the NACHA edition-sensitivity conventions, and the end-customer reconciliation responsibility-split conventions.references/cross-cutting/cyber.md is the most-loaded cross-cutting overlay. Cyber workpapers fail QA on evidence-reliability more often than financial-control workpapers; the overlay carries the vendor-supplied-scan-result reliance pattern, the screenshot-only access-review pattern, the production-versus-test environment evidence pattern, and the privileged-access tolerable-rate-floor pattern.references/cross-cutting/conduct.md loads when the workpaper sampled a consumer-impact population. The overlay carries the conclusion-language hygiene pattern (rewriting legal-violation framing to control-effectiveness framing), the customer-harm-distinct-from-technical-control-conclusion pattern, and the UDAAP all-three-prongs consideration pattern.Privacy and climate cross-cutting overlays follow the same pattern; this skill ships cyber and conduct as the cross-cutting files because they are the most frequent triggers for QA deficiencies. Where firm policy or taxonomy applies (severity floors specific to the firm, named QA-committee gates, escalation paths for QA disagreement, template variants), it lives in references/firm-overlay.md and is consumed when present.
Holds across every QA pack:
QA depth and length scale to the workpaper depth and the QA scope. A targeted re-review on a single section reads short; a full review of a high-volume workpaper with a high deficiency count reads longer with deficiencies clustered for the workpaper reviewer. An examiner-prep sweep on a portfolio of workpapers reads as a portfolio QA review with population-level themes plus per-workpaper notes. Sector overlay loading follows scope plus the rule that the regulator the test was designed for drives the sector overlay (HMDA testing pulls banking; an adviser compliance-program test pulls capital-markets; a sponsor-bank end-customer reconciliation test pulls payments-fintech and banking together). Cross-cutting overlay loading: cyber overlay is default-on for any workpaper covering IAM, data-protection, or NYDFS Part 500-mandated areas; conduct overlay is default-on for any consumer-facing workpaper where customer-harm framing matters separately from technical control conclusion. Audience drives shape: a QA pack drafted for the testing manager reads operationally, a QA pack drafted with an examiner sweep in mind reads heavier on the population-level themes and methodology-drift findings, a QA pack drafted for internal-audit reliance reads heavier on reviewer-separation evidence and the QA confidence label.
references/source-anchors.md — citations and excerpts for the named anchors (AICPA AU-C 220 / 230 / 265 / 530, IIA Standard 1300 and 2340, FFIEC IT Audit booklet, SR 08-8, OCC PPM 5310-3, COSO 2013 Principle 17, PCAOB QC 1000, sector-specific anchors).references/sector-overlays/banking.md, insurance.md, capital-markets.md, payments-fintech.md — sector-specific QA conventions loaded per scope. Banking is the heaviest overlay.references/cross-cutting/cyber.md, conduct.md — cross-cutting flavour. Cyber default-on for IAM, data-protection, and Part 500-mandated controls; conduct default-on for consumer-facing populations.references/firm-overlay.md — firm-installed QA methodology, severity floors, named QA-committee gates, escalation paths, and template variants beyond the regulatory baseline; consumed when present.templates/default-output.md — content spec for both artifacts (Excel QA markup tabs, Word QA memo summary).examples/ — Reg E error-resolution QA at a regional bank; examiner-prep TPRM sweep at a mid-size bank holding company.TROUBLESHOOTING.md — recurring pitfalls (QA as proofreading, QA reviewer is also the workpaper reviewer, severity inflation, skipping sample re-perform, confusing workpaper closure with issue closure, adversarial tone, scope creep into re-running the test, empty methodology references, missed population-level themes, confidence label always high).The plugin-level shared references (references/source-map.md, references/policy-control-library.md, references/review-gates.md) sit at the plugin root and are consulted alongside the skill-level files.
Default to drafting against templates/default-output.md. Render as Word, Excel, PowerPoint, or Markdown when the audience or workflow asks for it. Produce the structured record at schemas/qa-workpaper.schema.json when downstream automation or a registered consumer needs it. QA work is workpaper-natural: the real deliverable is an Excel test-of-design / test-of-effectiveness workbook with QA markup tabs (header, criteria, deficiencies, sample re-perform, severity calibration, conclusion support, source trace, reviewer questions) paired with a Word cover memo (executive summary, QA scope, deficiency findings, sample re-perform results, severity calibration, conclusion support, decision, reviewer questions, sign-off, source trace and confidence label).
Both artifacts emit together; the QA reviewer signs the Word memo, and the Excel workbook is the supporting documentation. Both file against the workpaper ID. The QA review note is consultative input to the workpaper reviewer for re-submission; the firm's testing-program closure machinery picks up the workpaper after QA sign-off.
Provides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.
npx claudepluginhub anotb/second-line-financial-services --plugin compliance-testing