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 an exceptionally lean, highly actionable rulebook: every section carries concrete API names, file paths, or code, and the reference structure is well designed around a real index. The only notable weaknesses are the absence of an explicit compile/run validation step in the workflow and the examples/iced_wgpu paths referenced in the body being missing from the actual bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense rules and pointers with no explanation of concepts Claude already knows ("Read the canonical example in `examples/`, never generate 0.14 code from memory"); even the tables are functional indexes rather than padding. This matches anchor 5 — lean, assumes competence, every token earns its place; it is not 4 because there are no identifiable instances of over-explanation to trim. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: exact file paths per need ("examples/custom_widget/src/main.rs"), a runnable lookup command ("ctx7 docs /websites/iced_rs \"<query>\""), a copy-paste theming snippet ("Theme::custom_with_fn(\"My Dark\", palette, |p| theme::palette::Extended::generate(p))"), and a WRONG/RIGHT code pair for the common tree-consistency mistake. This matches anchor 5 — copy-paste ready material covering the common cases. | 5 / 5 |
Workflow Clarity | The 4-step workflow (classify surface → read canonical example → read guide → check failure modes when debugging) is clearly sequenced, with an error-recovery feedback loop ("If geometry updates on a second click, check that the first state change invalidates layout") and a symptom→cause checklist reference. It is not 5 because no explicit build/run verification step (e.g. compile or run against the pinned upstream workspace) appears within the workflow sequence itself; it is not 3 because checkpoints and error-recovery guidance are clearly present, not merely implicit. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with a verified references/INDEX.md hub, well-signaled one-level-deep links (all referenced references/*.md files and section anchors exist), and lookup tables routing each need to a specific file. It is not 5 because the examples/ and iced_wgpu/ paths prominently referenced in the tables do not exist in the bundle, breaking navigation for a large part of the advertised material; it is not 3 because the structure that is present is clearly organized and clearly signaled. | 4 / 5 |
Total | 18 / 20 Passed |