Content
86%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 body is an actionable, well-structured overview that defers detail to real bundle files and supplies executable code and CLIs. It is slightly verbose in its guardrail/encoding lists and lacks an explicit error-retry feedback loop.
Suggestions
Tighten the 'Non-negotiable guardrails' and 'Choose an honest encoding' bullet lists by merging near-duplicate items to reduce token load.
Add an explicit feedback loop in Step 6 (e.g., 'If metadata/contrast checks fail, fix the export and re-run inspection') to reach the top workflow-clarity anchor.
Note that some inline Seaborn/Plotly version details could move to references/matplotlib_examples.md to keep the overview leaner.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and technical with no basic-concept padding (it does not explain what Matplotlib or a PDF is), but the guardrails list and the many sub-bullets in 'Choose an honest encoding' could be trimmed slightly to tighten token use. | 4 / 5 |
Actionability | Provides copy-paste-ready code (object-oriented Matplotlib with style_context, TwoSlopeNorm, Seaborn errorbar API, Plotly export) and fully-specified CLI invocations with flags covering the common cases. | 5 / 5 |
Workflow Clarity | A clearly sequenced 6-step workflow with explicit validation checkpoints (inspect metadata, audit contrast, compare to a dated snapshot, re-check the live journal page) and a final checklist, though an explicit 'on failure, fix and re-run' feedback loop is not stated. | 4 / 5 |
Progressive Disclosure | The body is an overview that signals one-level-deep references ('Read references/publication_guidelines.md', 'See references/color_palettes.md') with a References section describing each file; verified referenced files (references/*.md, scripts/*, assets/*) all exist and content is appropriately split. | 5 / 5 |
Total | 18 / 20 Passed |