Skill Tracer
Skills › Scientific Agent Skills › iso-standards-readiness › evidence-architecture.md

evidence-architecture.md

282 lines · skills/iso-standards-readiness/references/evidence-architecture.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Documentation and Evidence Architecture
2
3Research basis: **2026-10-01**; current-source details are in `references/source-ledger.md`. This is a
4process-oriented planning reference, not a list of copyrighted ISO or IEC requirements.
5
6The five-layer hierarchy below applies to every standard this skill covers. Where the
7wording is device-specific, the laboratory equivalent is noted; for depth read
8`references/iso-17025.md` or `references/iso-15189.md`.
9

Documentation and Evidence Architecture

Research basis: 2026-10-01; current-source details are in references/source-ledger.md. This is a process-oriented planning reference, not a list of copyrighted ISO or IEC requirements.

The five-layer hierarchy below applies to every standard this skill covers. Where the wording is device-specific, the laboratory equivalent is noted; for depth read references/iso-17025.md or references/iso-15189.md.

Raw lines 1 to 9
10## Do not use a fixed “31 procedures” claim
12ISO 13485 does not require one universal package of a fixed number of separately
13titled procedures for every organization. Document architecture depends on QMS
14scope, products, lifecycle activities, sites, outsourced processes, applicable
15regulatory requirements, and how controlled processes are combined or split.
17Avoid:
19- declaring a QMS complete because a named-document count was reached;
20- equating a filename or keyword hit with implementation;
21- treating an example document name as mandatory;
22- labeling every conditional process “not applicable” without an authorized decision;
23- assuming one regime's records satisfy another regime; or
24- claiming certification/readiness from document presence.
26Use an authorized copy of ISO 13485 and current jurisdiction/product sources to
27identify the documentation and records that actually apply. ISO publications are
28copyrighted; see [ISO copyright](https://www.iso.org/copyright.html).

Do not use a fixed “31 procedures” claim

ISO 13485 does not require one universal package of a fixed number of separately titled procedures for every organization. Document architecture depends on QMS scope, products, lifecycle activities, sites, outsourced processes, applicable regulatory requirements, and how controlled processes are combined or split.

Avoid:

  • declaring a QMS complete because a named-document count was reached;
  • equating a filename or keyword hit with implementation;
  • treating an example document name as mandatory;
  • labeling every conditional process “not applicable” without an authorized decision;
  • assuming one regime's records satisfy another regime; or
  • claiming certification/readiness from document presence.

Use an authorized copy of ISO 13485 and current jurisdiction/product sources to identify the documentation and records that actually apply. ISO publications are copyrighted; see ISO copyright.

Raw lines 10 to 29
30## Controlled evidence hierarchy

Controlled evidence hierarchy

Raw lines 30 to 31
32### 1. Source and applicability layer
34Maintain:
36- dated official-source ledger with exact edition/version;
37- product/site/market/lifecycle scope intake;
38- authorized applicability and not-applicable decisions;
39- regulatory/product-requirements matrix;
40- certification, MDSAP, FDA, and EU assurance-route distinctions;
41- source-change monitoring and impact assessments.
43Minimum fields: source ID, publisher, title, edition/version/date, authorized
44location, access date, owner, status, currency-review date, impact record, and
45approval.

1. Source and applicability layer

Maintain:

  • dated official-source ledger with exact edition/version;
  • product/site/market/lifecycle scope intake;
  • authorized applicability and not-applicable decisions;
  • regulatory/product-requirements matrix;
  • certification, MDSAP, FDA, and EU assurance-route distinctions;
  • source-change monitoring and impact assessments.

Minimum fields: source ID, publisher, title, edition/version/date, authorized location, access date, owner, status, currency-review date, impact record, and approval.

Raw lines 32 to 46
47### 2. Governance and policy layer
49Typical controlled documents and records:
51- QMS scope and quality manual or equivalent policy architecture;
52- quality policy/objectives and measures;
53- organization chart, role authorities, delegates, independence, and escalation;
54- authorized management representative appointment;
55- process-interaction map;
56- management review plan, records, decisions, and follow-up.
58The quality manual is not evidence that the processes operate. Link it to approved
59procedures and sampled implementation records.

2. Governance and policy layer

Typical controlled documents and records:

  • QMS scope and quality manual or equivalent policy architecture;
  • quality policy/objectives and measures;
  • organization chart, role authorities, delegates, independence, and escalation;
  • authorized management representative appointment;
  • process-interaction map;
  • management review plan, records, decisions, and follow-up.

The quality manual is not evidence that the processes operate. Link it to approved procedures and sampled implementation records.

Raw lines 47 to 60
61### 3. Process-control layer
63An organization may combine or separate controlled procedures. Use titles that match
64actual work. At minimum, assess whether controlled documentation is needed for:
66- document, record, and external-source control;
67- risk management;
68- design and development, transfer, and design change;
69- customer/product requirements and communications;
70- suppliers, purchasing, outsourced processes, and acceptance;
71- production, service, infrastructure, environment, and maintenance;
72- process, equipment, test-method, and software validation;
73- monitoring/measurement equipment;
74- identification, traceability, preservation, installation, and servicing;
75- feedback, complaints, postmarket surveillance, and vigilance/reporting;
76- nonconforming outputs, corrections, removals/advisory actions, and CAPA;
77- internal audit, data/trend analysis, and management review;
78- competence, training, authorization, and awareness; and
79- QMS/product/process/source/software change control.
81Each controlled process should identify purpose, scope, roles, inputs, outputs,
82methods, decision criteria, records, interfaces, measures, change controls,
83source/version basis, approval, and effective date.

3. Process-control layer

An organization may combine or separate controlled procedures. Use titles that match actual work. At minimum, assess whether controlled documentation is needed for:

  • document, record, and external-source control;
  • risk management;
  • design and development, transfer, and design change;
  • customer/product requirements and communications;
  • suppliers, purchasing, outsourced processes, and acceptance;
  • production, service, infrastructure, environment, and maintenance;
  • process, equipment, test-method, and software validation;
  • monitoring/measurement equipment;
  • identification, traceability, preservation, installation, and servicing;
  • feedback, complaints, postmarket surveillance, and vigilance/reporting;
  • nonconforming outputs, corrections, removals/advisory actions, and CAPA;
  • internal audit, data/trend analysis, and management review;
  • competence, training, authorization, and awareness; and
  • QMS/product/process/source/software change control.

Each controlled process should identify purpose, scope, roles, inputs, outputs, methods, decision criteria, records, interfaces, measures, change controls, source/version basis, approval, and effective date.

Raw lines 61 to 84
85### 4. Product and technical evidence layer
87Maintain a controlled file architecture for each applicable product/type/family.
88Depending on product and jurisdiction, evidence may include:
90- product description, intended purpose/use, claims, variants, accessories;
91- classifications and authorized decision records;
92- requirements/specifications and acceptance criteria;
93- risk management and benefit-risk evidence;
94- design planning, inputs, outputs, reviews, verification, validation, transfer,
95 and changes;
96- production, supplier, packaging, labeling, installation, and service information;
97- software lifecycle, cybersecurity, usability, biocompatibility, electrical safety,
98 sterilization, clinical/performance, and other product-specific evidence;
99- acceptance/release and distribution/traceability records;
100- postmarket plans, reports, complaints, vigilance, field actions, and updates.
102Do not claim that an ISO 13485 “medical device file” automatically replaces every
103FDA, EU, or other jurisdiction-specific file or record concept. Build a cross-reference
104that preserves each required record and its source/version.
106**Laboratory equivalent.** For ISO/IEC 17025 and ISO 15189 the technical evidence layer
107is organized per scope item — per method, measurand, or examination — rather than per
108product family. Depending on the activity it may include:
110- the controlled method or examination procedure and its issue, with the authorization
111 to put it into service;
112- verification or validation evidence: performance characteristics evaluated,
113 acceptance criteria, data, and approval;
114- the measurement-uncertainty evaluation and its stated basis;
115- metrological traceability evidence: stated reference, provider and its accreditation
116 scope, certificate identity, uncertainty carried forward, interval justification, and
117 intermediate checks;
118- the documented decision rule and customer-agreement record where conformity is
119 stated;
120- proficiency-testing or external-quality-assessment enrolment, results, evaluation
121 against criteria, and investigation of unsatisfactory outcomes;
122- equipment, reagent, consumable, and reference-material records;
123- technical records sufficient to reproduce the reported result; and
124- report and certificate templates, amendment/retraction handling, and authorized
125 signatories.
127An accredited scope schedule is not this layer — it is the output of the accreditation
128body. Keep the two apart in the register.

4. Product and technical evidence layer

Maintain a controlled file architecture for each applicable product/type/family. Depending on product and jurisdiction, evidence may include:

  • product description, intended purpose/use, claims, variants, accessories;
  • classifications and authorized decision records;
  • requirements/specifications and acceptance criteria;
  • risk management and benefit-risk evidence;
  • design planning, inputs, outputs, reviews, verification, validation, transfer, and changes;
  • production, supplier, packaging, labeling, installation, and service information;
  • software lifecycle, cybersecurity, usability, biocompatibility, electrical safety, sterilization, clinical/performance, and other product-specific evidence;
  • acceptance/release and distribution/traceability records;
  • postmarket plans, reports, complaints, vigilance, field actions, and updates.

Do not claim that an ISO 13485 “medical device file” automatically replaces every FDA, EU, or other jurisdiction-specific file or record concept. Build a cross-reference that preserves each required record and its source/version.

Laboratory equivalent. For ISO/IEC 17025 and ISO 15189 the technical evidence layer is organized per scope item — per method, measurand, or examination — rather than per product family. Depending on the activity it may include:

  • the controlled method or examination procedure and its issue, with the authorization to put it into service;
  • verification or validation evidence: performance characteristics evaluated, acceptance criteria, data, and approval;
  • the measurement-uncertainty evaluation and its stated basis;
  • metrological traceability evidence: stated reference, provider and its accreditation scope, certificate identity, uncertainty carried forward, interval justification, and intermediate checks;
  • the documented decision rule and customer-agreement record where conformity is stated;
  • proficiency-testing or external-quality-assessment enrolment, results, evaluation against criteria, and investigation of unsatisfactory outcomes;
  • equipment, reagent, consumable, and reference-material records;
  • technical records sufficient to reproduce the reported result; and
  • report and certificate templates, amendment/retraction handling, and authorized signatories.

An accredited scope schedule is not this layer — it is the output of the accreditation body. Keep the two apart in the register.

Raw lines 85 to 129
130### 5. Implementation-record layer
132Procedures describe controls; records show what happened. Sample actual records for:
134- approvals, revision/effective status, training, and point-of-use control;
135- competence and role authorization;
136- management review inputs, decisions, resources, actions, and follow-up;
137- internal audits, findings, corrections/CAPA, and effectiveness;
138- risk reviews and links to design/production/postmarket changes;
139- design reviews, verification, validation, transfer, and changes;
140- supplier qualification, agreements, monitoring, change notices, re-evaluation,
141 nonconformity, and CAPA;
142- production/service work, process parameters, acceptance, release, validation,
143 revalidation, maintenance, and calibration;
144- software intended use, risk, validation, release, incidents, and changes;
145- identification, traceability, distribution, installation, and service;
146- complaints, investigations, reportability/vigilance decisions, and communications;
147- nonconformity, disposition, corrections, CAPA, and effectiveness; and
148- data analysis, trends, objectives, escalation, and change decisions.

5. Implementation-record layer

Procedures describe controls; records show what happened. Sample actual records for:

  • approvals, revision/effective status, training, and point-of-use control;
  • competence and role authorization;
  • management review inputs, decisions, resources, actions, and follow-up;
  • internal audits, findings, corrections/CAPA, and effectiveness;
  • risk reviews and links to design/production/postmarket changes;
  • design reviews, verification, validation, transfer, and changes;
  • supplier qualification, agreements, monitoring, change notices, re-evaluation, nonconformity, and CAPA;
  • production/service work, process parameters, acceptance, release, validation, revalidation, maintenance, and calibration;
  • software intended use, risk, validation, release, incidents, and changes;
  • identification, traceability, distribution, installation, and service;
  • complaints, investigations, reportability/vigilance decisions, and communications;
  • nonconformity, disposition, corrections, CAPA, and effectiveness; and
  • data analysis, trends, objectives, escalation, and change decisions.
Raw lines 130 to 149
150## Fail-closed document register
152For every controlled document, capture:
154- unique ID, title, type, owner, revision, and status;
155- source/version references and change rationale;
156- reviewers/approvers and approval evidence;
157- effective date and training impact;
158- linked documents, forms, records, systems, products, suppliers, and processes;
159- obsolete/superseded disposition; and
160- controlled location and access classification.
162For every record series, capture:
164- owner, record type, creation/attribution method, and status;
165- integrity, security, audit trail, backup/recovery, retrieval, and correction controls;
166- exact retention period and approved basis;
167- disposition method and authorization;
168- applicable products/sites/jurisdictions;
169- evidence samples and approval.
171Unknown, placeholder, unapproved, uncontrolled, or inaccessible entries are gaps—not
172assumed evidence.

Fail-closed document register

For every controlled document, capture:

  • unique ID, title, type, owner, revision, and status;
  • source/version references and change rationale;
  • reviewers/approvers and approval evidence;
  • effective date and training impact;
  • linked documents, forms, records, systems, products, suppliers, and processes;
  • obsolete/superseded disposition; and
  • controlled location and access classification.

For every record series, capture:

  • owner, record type, creation/attribution method, and status;
  • integrity, security, audit trail, backup/recovery, retrieval, and correction controls;
  • exact retention period and approved basis;
  • disposition method and authorization;
  • applicable products/sites/jurisdictions;
  • evidence samples and approval.

Unknown, placeholder, unapproved, uncontrolled, or inaccessible entries are gaps—not assumed evidence.

Raw lines 150 to 173
174## Regime-specific supplements

Regime-specific supplements

Raw lines 174 to 175
176### ISO certification
178Maintain the authorized standard edition, certification scope, sites/activities,
179certification-body and accreditation-scope evidence, audit program, findings, and
180certificate status. A certificate is limited to its scope and is not a product or
181regulatory authorization.

ISO certification

Maintain the authorized standard edition, certification scope, sites/activities, certification-body and accreditation-scope evidence, audit program, findings, and certificate status. A certificate is limited to its scope and is not a product or regulatory authorization.

Raw lines 176 to 182
183### Laboratory accreditation (ISO/IEC 17025, ISO 15189)
185Maintain the authorized standard edition, the scope of laboratory activities as
186declared and as accredited, per-location coverage, the accreditation body and its own
187recognition status, assessment history and findings with their closure evidence, and
188current accreditation status including any suspension or scope reduction.
190Additional controls specific to this lane:
192- **Claim control.** Record where accreditation symbols and endorsement wording may and
193 may not be used, and who authorizes each use. Work outside the accredited scope must
194 carry no accreditation claim. Since 2026-01-01 the recognition arrangement sits with
195 Global Accreditation Cooperation Incorporated — verify current wording rather than
196 reusing legacy ILAC MRA / IAF MLA phrasing.
197- **Scope-change control.** New methods, extended ranges, new locations, and new
198 authorized signatories are scope questions for the accreditation body, not only
199 internal change control. Keep the notification and approval records.
200- **Authorized signatories.** Maintain the current list, the scope each is authorized
201 for, and the competence evidence behind each authorization.
202- **Subcontracting and referral.** Record the provider, its own accreditation or
203 licensure status, the customer-notification basis, and how results are reported.
205For ISO 15189 specifically, keep CLIA, licensure, and payer evidence in a **separate**
206register. ISO 15189 accreditation does not satisfy CLIA, and blending the two produces
207a register that implies an equivalence that does not exist. See
208`references/iso-15189.md`.

Laboratory accreditation (ISO/IEC 17025, ISO 15189)

Maintain the authorized standard edition, the scope of laboratory activities as declared and as accredited, per-location coverage, the accreditation body and its own recognition status, assessment history and findings with their closure evidence, and current accreditation status including any suspension or scope reduction.

Additional controls specific to this lane:

  • Claim control. Record where accreditation symbols and endorsement wording may and may not be used, and who authorizes each use. Work outside the accredited scope must carry no accreditation claim. Since 2026-01-01 the recognition arrangement sits with Global Accreditation Cooperation Incorporated — verify current wording rather than reusing legacy ILAC MRA / IAF MLA phrasing.
  • Scope-change control. New methods, extended ranges, new locations, and new authorized signatories are scope questions for the accreditation body, not only internal change control. Keep the notification and approval records.
  • Authorized signatories. Maintain the current list, the scope each is authorized for, and the competence evidence behind each authorization.
  • Subcontracting and referral. Record the provider, its own accreditation or licensure status, the customer-notification basis, and how results are reported.

For ISO 15189 specifically, keep CLIA, licensure, and payer evidence in a separate register. ISO 15189 accreditation does not satisfy CLIA, and blending the two produces a register that implies an equivalence that does not exist. See references/iso-15189.md.

Raw lines 183 to 209
210### FDA QMSR
212Since **2026-02-02**, use current
213[21 CFR Part 820](https://www.ecfr.gov/current/title-21/chapter-I/subchapter-H/part-820),
214the incorporated ISO edition, current FDA supplemental provisions, and other
215applicable FDA regulations. FDA now uses
216[Compliance Program 7382.850](https://www.fda.gov/media/80195/download?attachment),
217not QSIT. Keep evidence for current complaint, servicing, labeling/packaging, and
218other FDA-specific requirements. Do not retain old QSR section numbers as the
219current control model.
221FDA's
222[QMSR FAQ](https://www.fda.gov/medical-devices/quality-management-system-regulation-qmsr/quality-management-system-regulation-frequently-asked-questions)
223states that investigators may review pre-effective-date QMS records and management,
224quality-audit, and supplier-audit reports. Prepare controlled retrieval without
225rewriting history or backdating records.

FDA QMSR

Since 2026-02-02, use current 21 CFR Part 820, the incorporated ISO edition, current FDA supplemental provisions, and other applicable FDA regulations. FDA now uses Compliance Program 7382.850, not QSIT. Keep evidence for current complaint, servicing, labeling/packaging, and other FDA-specific requirements. Do not retain old QSR section numbers as the current control model.

FDA's QMSR FAQ states that investigators may review pre-effective-date QMS records and management, quality-audit, and supplier-audit reports. Prepare controlled retrieval without rewriting history or backdating records.

Raw lines 210 to 226
227### MDSAP
229Use the current
230[MDSAP AU P0002.011 Audit Approach](https://www.mdsap.global/documents/library/audit-approach),
231dated 2026-08-03, and the current MDSAP document library. Record participating
232jurisdictions, products, sites, recognized Auditing Organization, audit cycle,
233jurisdiction-specific evidence, findings, and action status. Do not substitute an
234ISO-only certificate or FDA inspection checklist.

MDSAP

Use the current MDSAP AU P0002.011 Audit Approach, dated 2026-08-03, and the current MDSAP document library. Record participating jurisdictions, products, sites, recognized Auditing Organization, audit cycle, jurisdiction-specific evidence, findings, and action status. Do not substitute an ISO-only certificate or FDA inspection checklist.

Raw lines 227 to 235
236### EU MDR/IVDR
238Keep the current consolidated regulation, conformity-assessment route, device
239classification, technical documentation, QMS, clinical/performance, postmarket,
240vigilance, registration/UDI, economic-operator, and notified-body evidence as
241applicable. Verify notified-body designation and codes in
242[NANDO](https://webgate.ec.europa.eu/single-market-compliance-space/notified-bodies).
243MDCG guidance is useful but nonbinding; record document number, revision, date, and
244impact.
246For European standards, distinguish ISO publications from EN adoptions,
247corrigenda, and European A11 amendments. Verify current OJEU citations on the
248Commission's
249[harmonised standards page](https://health.ec.europa.eu/medical-devices-topics-interest/harmonised-standards_en).

EU MDR/IVDR

Keep the current consolidated regulation, conformity-assessment route, device classification, technical documentation, QMS, clinical/performance, postmarket, vigilance, registration/UDI, economic-operator, and notified-body evidence as applicable. Verify notified-body designation and codes in NANDO. MDCG guidance is useful but nonbinding; record document number, revision, date, and impact.

For European standards, distinguish ISO publications from EN adoptions, corrigenda, and European A11 amendments. Verify current OJEU citations on the Commission's harmonised standards page.

Raw lines 236 to 250
251## Retention: no universal period
253Do not use generic “5–10 year” statements or “device lifetime” as a complete
254retention schedule. For each record type, authorized reviewers should reconcile:
256- current standard and regulatory sources;
257- product/device lifetime and market-specific periods;
258- complaint, vigilance, traceability, clinical/performance, technical-documentation,
259 and certificate obligations;
260- legal hold, privacy, contract, and business requirements; and
261- system migration and durable retrieval.
263Record the chosen period, start event, source/version, rationale, owner, approval,
264disposition method, and hold override.

Retention: no universal period

Do not use generic “5–10 year” statements or “device lifetime” as a complete retention schedule. For each record type, authorized reviewers should reconcile:

  • current standard and regulatory sources;
  • product/device lifetime and market-specific periods;
  • complaint, vigilance, traceability, clinical/performance, technical-documentation, and certificate obligations;
  • legal hold, privacy, contract, and business requirements; and
  • system migration and durable retrieval.

Record the chosen period, start event, source/version, rationale, owner, approval, disposition method, and hold override.

Raw lines 251 to 265
266## Evidence-quality gate
268A document or record is ready for substantive human review only when:
270- scope and applicability are resolved or explicitly blocked;
271- owner and status are clear;
272- referenced controlled revision exists;
273- approval and effective dates are recorded;
274- implementation evidence is sampled;
275- source versions are current and traceable;
276- open findings and change/CAPA links are visible; and
277- the artifact makes no unsupported compliance, conformity, certification, or
278 readiness claim.
280Use `scripts/audit_document_records.py` for structural checks and
281`scripts/validate_evidence_manifest.py` for a bounded local manifest. Passing either
282means only that the supplied fields passed deterministic checks.

Evidence-quality gate

A document or record is ready for substantive human review only when:

  • scope and applicability are resolved or explicitly blocked;
  • owner and status are clear;
  • referenced controlled revision exists;
  • approval and effective dates are recorded;
  • implementation evidence is sampled;
  • source versions are current and traceable;
  • open findings and change/CAPA links are visible; and
  • the artifact makes no unsupported compliance, conformity, certification, or readiness claim.

Use scripts/audit_document_records.py for structural checks and scripts/validate_evidence_manifest.py for a bounded local manifest. Passing either means only that the supplied fields passed deterministic checks.

Raw lines 266 to 282
Runs code scripts/audit_document_records.py :280
Runs code scripts/validate_evidence_manifest.py :281