Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-organized with a clean one-level reference, but it spends tokens explaining CSS/RTL basics Claude knows and gives abstract Fix guidance without a concrete property-to-logical-property mapping or executable examples. The Check/Fix/Code Review sections function as modes rather than a validated workflow.
Suggestions
Replace the conceptual intro with (or move it to references/rule.md and) a concrete mapping table of physical -> logical properties (e.g. margin-left -> margin-inline-start) so the Fix is copy-paste ready.
Tighten the intro to drop explanations of margin-left/RTL basics that Claude already knows, keeping only rule-specific guidance.
Make the Check -> Fix -> Code Review flow an explicit sequenced workflow with a verification step (e.g. re-check the rendered layout across LTR/RTL and breakpoints after applying changes).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and sectioned, but the intro paragraph explains concepts Claude already knows ('Physical CSS properties... are hardcoded to screen directions', '[dir=rtl] selectors'), matching 'mostly efficient but includes some unnecessary explanation'. | 2 / 3 |
Actionability | The Check section lists concrete properties to find (margin-left, padding-right, etc.) and Quick Reference gives some equivalents, but the Fix section is abstract ('Convert physical direction properties to their CSS logical property equivalents') with no executable mapping table or code, so guidance is incomplete. | 2 / 3 |
Workflow Clarity | Check/Fix/Explain/Code Review read as loose modes rather than a sequenced workflow with validation checkpoints, matching 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'. | 2 / 3 |
Progressive Disclosure | A simple, well-sectioned body under 50 lines signals one clearly-named one-level-deep reference ('see references/rule.md', verified to exist), matching the clear-overview-with-well-signaled-references anchor. | 3 / 3 |
Total | 9 / 12 Passed |