Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The workflows themselves are excellent: every lifecycle process is a numbered sequence with explicit validation checkpoints, feedback loops, and checklists, backed by quantitative criteria Claude cannot safely improvise. The main defects are dangling progressive-disclosure references — four linked bundle files do not exist — and noticeable internal duplication (AFAP guidance and acceptability logic repeated across several sections) that inflates token cost. Fixing the missing files or removing the dead links would lift the two weakest dimensions.
Suggestions
Ship the referenced bundle files (references/risk-analysis-methods.md, references/iso14971-implementation-guide.md, references/risk-assessment-templates.md, scripts/risk_matrix_calculator.py) or remove the dead links — every 'See references/...' pointer and the script usage line currently fails when followed.
Consolidate the four overlapping statements of acceptability logic ('Risk Level Actions', the evaluation decision tree, 'Residual Risk Evaluation', 'Risk Acceptability Decision') and the three AFAP callouts into one authoritative section, and cut the Table of Contents and 'Quick Reference: ISO 14971 Process' summary that restate the document's own headings.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense domain reference material Claude should not be trusted to recall (P1–P5 frequency bands, S1–S5 severity, the 5×5 matrix, EU MDR AFAP-vs-ALARP distinction), so most tokens earn their place. However, AFAP guidance is repeated in three sections, acceptability logic appears in four places ("Risk Level Actions", the evaluation decision tree, "Residual Risk Evaluation", "Risk Acceptability Decision"), and the TOC plus "Quick Reference" table restate the document's own structure — noticeable duplication that could be trimmed, placing it between anchors 3 and 4, and closer to 4 since each duplicated table still serves a distinct lifecycle stage. | 4 / 5 |
Actionability | Numbered workflows with defined probability/severity thresholds, a fillable RISK CONTROL OPTION ANALYSIS template, concrete method-selection and verification tables, and a script usage line ("python risk_matrix_calculator.py --help") give mostly executable guidance. It falls short of anchor 5 because that script and all referenced reference files do not exist in the bundle, leaving part of the executable guidance un-runnable as shipped — the 'minor gaps' of anchor 4. | 4 / 5 |
Workflow Clarity | All five workflows are numbered sequences that each end in an explicit bolded "Validation:" checkpoint with concrete completion criteria, the decision trees and "New Hazard Analysis" table provide feedback loops for error recovery, and a hazard-categories checklist is included — matching anchor 5 exactly. Anchor 4 presumes minor validation gaps, and none are present. | 5 / 5 |
Progressive Disclosure | The structure is clean (TOC, labeled sections, clearly signaled one-level references), but the body links references/risk-analysis-methods.md, references/iso14971-implementation-guide.md, references/risk-assessment-templates.md, and scripts/risk_matrix_calculator.py, and none of these files or their directories exist in the bundle — the references dangle. Combined with ~450 lines of inlined reference-grade matrices, criteria tables, and templates that the document itself attributes to separate files, this fits anchor 3 (structure present but content that should be separate is inline, references not dependable) rather than anchor 4, which assumes references resolve. | 3 / 5 |
Total | 16 / 20 Passed |