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.
A well-structured, highly actionable design-critique workflow: explicit phase gating, concrete output templates, worked examples, and conditional rules throughout. Its main weaknesses are the three referenced files the workflow depends on but which are absent from the bundle, plus some duplicated command lists and tone-coaching content that could be trimmed.
Suggestions
Add the three referenced files (reference/cognitive-load.md, reference/heuristics-scoring.md, reference/personas.md) to the bundle — or inline the essential details (the 8-item checklist, P0–P3 severity definitions, persona selection table) — since workflow steps in Phases 1–2 depend on them and the paths currently do not resolve.
State the suggested-command vocabulary once (in the Phase 4 recommendation rules) and reference it from the Priority Issues section, instead of repeating the full command list in both places.
Trim the duplicated tone coaching ('Be brutally honest', the six-bullet 'Remember' block) — the specificity directives ('Be specific — "the submit button" not "some elements"') already imply it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every line is a directive, checklist prompt, output template, or rule — 'Score each of Nielsen's 10 heuristics 0–4', 'tag with **P0–P3 severity**' — with no concept explanations. Minor trimmable instances exist: tone coaching is repeated ('Be brutally honest', the six-bullet '**Remember**' block restating style directives) and the suggested-command vocabulary is listed in full twice (Priority Issues and Phase 4 rules). Not 5 because of those redundancies; not 3 because there is no padding or explanation of things Claude already knows. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: a full heuristic scoring table with 'Total ??/40' format, worked persona output examples ('Alex (Power User): No keyboard shortcuts detected. Form requires 8 clicks for primary action.'), sample questions, an explicit command vocabulary, and conditional rules ('If the user chose a limited scope, only include items within that scope'). The gap: workflow-critical specifics are deferred to referenced files — the '8-item cognitive load checklist', 'P0–P3 severity definitions', and the persona 'selection table' — none of which exist in the bundle, so those steps cannot be fully executed as shipped. Not 5 due to those unavailable details; not 3 since the inline guidance itself is specific and executable apart from the missing references. | 4 / 5 |
Workflow Clarity | Four numbered phases with explicit entry/exit gating ('**After presenting findings**, use targeted questions', '**After receiving the user's answers**'), a mandatory precondition ('if no design context exists yet, you MUST run /teach-impeccable first'), conditional branches ('If findings are straightforward (e.g., only 1–2 clear issues), skip questions and go directly to Phase 4'), and per-phase rules lists. Not 4: sequencing, gating, and conditionals are explicit throughout with no checkpoint gaps relevant to this read-only evaluation task (the destructive/batch cap does not apply). | 5 / 5 |
Progressive Disclosure | The body uses a consistent, clearly signaled one-level-deep citation pattern ('> *Consult [cognitive-load](reference/cognitive-load.md) for the working memory rule and 8-item checklist*'), but none of the three referenced files (cognitive-load.md, heuristics-scoring.md, personas.md) exist in the bundle — the promised details (checklist, severity definitions, persona catalog) don't resolve. Additionally, content that arguably belongs in those references (the full 10-row heuristic table) is inline. Not 4 because missing referenced files is more than a minor organization gap; not 2 because the body itself is well-structured and references are prominently signaled rather than buried. | 3 / 5 |
Total | 16 / 20 Passed |