Content
90%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 a lean, highly actionable quick-reference card with concrete qsv commands and a well-sequenced fix-ordering workflow. Its main gap is the lack of an explicit post-fix verification feedback loop and the absence of any bundle-file references for the extensive advanced-stats material.
Suggestions
Add an explicit verification step after the Fix Ordering sequence (e.g., re-run `stats --cardinality` or `validate` and confirm the flagged issue is resolved before proceeding).
Consider moving the Advanced Stats distribution-metrics table into a separate reference file (e.g., references/advanced-stats.md) linked from the main body to improve progressive disclosure.
Clarify the handoff to /data-profile at the top with a one-line statement of when each is preferred.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense reference tables with no padding or over-explanation of concepts Claude already knows; every row maps a concrete check or cache column to a quality signal, so each token earns its place. | 5 / 5 |
Actionability | Provides concrete, executable qsv commands throughout (stats, validate schema.json, fixlengths, input, safenames, sqlp with TRIM(), dedup, joinp --left-anti) with a clear problem-to-command mapping covering common cases. | 5 / 5 |
Workflow Clarity | The Fix Ordering section gives a clear numbered sequence (input -> safenames -> fixlengths -> TRIM -> dedup -> validate) with rationale, and the decision tree's "When to Skip" columns act as pre-check checkpoints, but there is no explicit re-verify feedback loop after destructive fixes. | 4 / 5 |
Progressive Disclosure | Well-organized into clear sections with headers and tables and no nested references, but the content is entirely inline (no bundle files present) and the lengthy Advanced Stats table could arguably live in a separate reference file. | 4 / 5 |
Total | 18 / 20 Passed |