Skip to content

K-Dense-AI/scientific-agent-skills / skills/iso-standards-readiness

iso-standards-readiness

Verified

Prepares and structurally reviews readiness evidence for ISO management-system and laboratory-competence standards - ISO 13485 medical device QMS, ISO 14971 device risk management, ISO/IEC 17025 testing and calibration laboratories, and ISO 15189 medical laboratories. Use when organizing declared scope, controlled documents, risk-management files, scope of accreditation, traceability, CAPA, external-provider controls, or bounded local evidence manifests, and when separating ISO certification from laboratory accreditation, FDA QMSR inspection, CLIA certification, MDSAP, and EU MDR/IVDR evidence boundaries. Not for legal applicability, compliance, certification, or accreditation decisions; contains no clause text.

FileKindSize
SKILL.mdskill md17.9 KB
assets/templates/capa-record-template.jsonconfig2.9 KB
assets/templates/document-register-template.jsonconfig2.1 KB
assets/templates/evidence-manifest-template.jsonconfig2.0 KB
assets/templates/laboratory-scope-intake-template.jsonconfig3.3 KB
assets/templates/medical-laboratory-scope-intake-template.jsonconfig3.5 KB
assets/templates/procedures/CAPA-procedure-template.mdmarkdown6.4 KB
assets/templates/procedures/document-control-procedure-template.mdmarkdown6.8 KB
assets/templates/qmsr-transition-template.jsonconfig9.4 KB
assets/templates/quality-manual-template.mdmarkdown9.2 KB
assets/templates/scope-intake-template.jsonconfig2.9 KB
assets/templates/supplier-controls-template.jsonconfig4.2 KB
assets/templates/traceability-matrix-template.jsonconfig4.3 KB
references/assurance-lanes.mdmarkdown7.1 KB
references/evidence-architecture.mdmarkdown13.3 KB
references/gap-analysis-checklist.mdmarkdown19.0 KB
references/iso-13485.mdmarkdown12.0 KB
references/iso-14971.mdmarkdown9.3 KB
references/iso-15189.mdmarkdown12.2 KB
references/iso-17025.mdmarkdown12.0 KB
references/quality-manual-guide.mdmarkdown11.3 KB
references/source-ledger.mdmarkdown20.7 KB
scripts/_catalog.pyscript7.6 KB
scripts/_common.pyscript16.4 KB
scripts/audit_document_records.pyscript5.4 KB
scripts/check_capa.pyscript8.7 KB
scripts/check_qmsr_transition.pyscript5.5 KB
scripts/check_supplier_controls.pyscript5.6 KB
scripts/check_traceability.pyscript5.5 KB
scripts/gap_analyzer.pyscript5.5 KB
scripts/validate_evidence_manifest.pyscript8.2 KB
scripts/validate_scope_intake.pyscript7.1 KB

scripts/check_traceability.py

View on GitHub
#!/usr/bin/env python3
"""Check risk/design/production/postmarket traceability references."""

from __future__ import annotations

from typing import Any

from _catalog import TRACEABILITY_LINKS
from _common import (
    ALLOWED_STATUSES,
    Review,
    finish,
    guarded_main,
    load_json,
    require_root_object,
    standard_parser,
)

ARTIFACT_TYPES = {
    "intended-use",
    "hazard",
    "postmarket-signal",
    "risk-evaluation",
    "risk-control",
    "design-input",
    "design-output",
    "verification",
    "validation",
    "production-control",
    "change-control",
    "capa",
    "not-applicable-decision",
    "other",
}


def _reference_list(
    review: Review,
    value: Any,
    path: str,
    artifact_ids: set[str],
) -> list[str]:
    raw = review.list(value, path, min_items=1)
    if raw is None:
        return []
    result: list[str] = []
    for index, item in enumerate(raw):
        item_path = f"{path}[{index}]"
        if not isinstance(item, str) or not item.strip():
            review.add("REFERENCE_REQUIRED", item_path, "requires an artifact id")
            continue
        result.append(item)
        if item not in artifact_ids:
            review.add(
                "REFERENCE_MISSING",
                item_path,
                f"artifact id is not defined: {item}",
            )
    if len(result) != len(set(result)):
        review.add("REFERENCE_DUPLICATE", path, "contains duplicate artifact ids")
    return result


def validate(data: dict[str, Any]) -> tuple[Review, dict[str, int]]:
    review = Review()
    metadata = review.object(data.get("metadata"), "metadata")
    if metadata is not None:
        review.controlled_item(metadata, "metadata", require_approved=True)
        review.text(metadata, "matrix_id", "metadata", max_chars=120)
        review.date(metadata, "review_date", "metadata")

    artifacts = review.list(data.get("artifacts"), "artifacts", min_items=1) or []
    artifact_ids: set[str] = set()
    for index, value in enumerate(artifacts):
        path = f"artifacts[{index}]"
        artifact = review.object(value, path)
        if artifact is None:
            continue
        identifier = review.text(artifact, "id", path, max_chars=120)
        if identifier:
            artifact_ids.add(identifier)
        review.choice(artifact, "type", ARTIFACT_TYPES, path)
        review.text(artifact, "title", path, max_chars=300)
        review.text(artifact, "owner", path, max_chars=200)
        status = review.choice(artifact, "status", ALLOWED_STATUSES, path)
        review.evidence(artifact, path)
        review.approval(
            artifact,
            path,
            require_approved=status in {"approved", "implemented", "verified", "closed"},
        )
        review.source_refs(artifact, path)
        if artifact.get("type") == "not-applicable-decision":
            review.text(artifact, "rationale", path, max_chars=2_000)
            review.approval(artifact, path, require_approved=True)
    review.unique_ids(artifacts, "artifacts")

    rows = review.list(data.get("rows"), "rows", min_items=1) or []
    verified_rows = 0
    for index, value in enumerate(rows):
        path = f"rows[{index}]"
        row = review.object(value, path)
        if row is None:
            continue
        review.text(row, "id", path, max_chars=120)
        review.text(row, "product_id", path, max_chars=120)
        review.text(row, "owner", path, max_chars=200)
        status = review.choice(row, "status", ALLOWED_STATUSES, path)
        review.text(row, "linkage_rationale", path, max_chars=3_000)
        review.evidence(row, path)
        review.source_refs(row, path)
        review.approval(row, path, require_approved=status == "verified")

        links_path = f"{path}.links"
        links = review.object(row.get("links"), links_path)
        if links is not None:
            for link_name in TRACEABILITY_LINKS:
                _reference_list(
                    review,
                    links.get(link_name),
                    f"{links_path}.{link_name}",
                    artifact_ids,
                )

        change_refs = row.get("change_control_refs")
        if change_refs in (None, []):
            review.add(
                "CHANGE_LINK_REQUIRED",
                f"{path}.change_control_refs",
                "requires a change-control artifact or approved not-applicable decision",
            )
        else:
            _reference_list(
                review,
                change_refs,
                f"{path}.change_control_refs",
                artifact_ids,
            )

        gaps = review.list(row.get("open_gaps"), f"{path}.open_gaps", min_items=0)
        if status == "verified":
            verified_rows += 1
            if gaps:
                review.add(
                    "VERIFICATION_BLOCKED",
                    f"{path}.open_gaps",
                    "verified row must not contain open gaps",
                    "blocker",
                )
    review.unique_ids(rows, "rows")

    return review, {
        "artifacts": len(artifacts),
        "rows": len(rows),
        "verified_rows": verified_rows,
    }


def main() -> int:
    parser = standard_parser(
        "Check explicit traceability from risks and design through postmarket evidence.",
        "Path to the local traceability-matrix JSON file",
    )
    args = parser.parse_args()
    data = require_root_object(load_json(args.input))
    review, metrics = validate(data)
    return finish("check_traceability", review, args, metrics=metrics)


if __name__ == "__main__":
    guarded_main(main)
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall