Content
75%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 dense, expert-level distillation of genuinely non-obvious Iced 0.14 invariants with a clear workflow and a well-signaled, verified one-level-deep reference structure. The consistent gap from a 5 is minor: some pane_grid/theming detail duplicates reference files, there is no compile-verification step, and the heavily-referenced examples/ and iced_wgpu/ directories are missing from the bundle as provided.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and fluff-free — every rule is an Iced-specific invariant like "request_redraw() repaints but does not call view()" rather than concepts Claude already knows. Minor trimming is possible: the pane_grid tab-drag state machine ("Idle → Pressed(origin) → Dragging state machine at an 8px threshold") and theming token routing duplicate detail that belongs in the already-bundled references, keeping it just short of the lean 5-anchor. | 4 / 5 |
Actionability | Guidance is concrete and API-level: exact calls ("shell.request_redraw() and shell.invalidate_layout()", "Rectangle::INFINITE as the viewport"), a WRONG/RIGHT code diff, runnable discovery commands ("ctx7 docs /websites/iced_rs \"<query>\""), and need→example-file tables. It falls short of fully copy-paste-ready because most rules are principles with only one inline snippet, delegating runnable code to the examples/ directory. | 4 / 5 |
Workflow Clarity | The 4-step workflow (classify surface → read canonical example → read guide → debug fallback) is clearly sequenced, and step 4 provides an explicit error-recovery path ("the guide's 'Common failure modes' / 'Gotchas', then guide-animation-debugging.md") naming the three most common failure signatures. No compile/verify checkpoint exists after writing code, so it stops short of the 5-anchor's explicit validation steps. | 4 / 5 |
Progressive Disclosure | Excellent structure: an overview body, a hub ("Full list in references/INDEX.md; load on demand"), and need→file tables, with every cited references/*.md file verified present and one level deep. However, the workflow's step 2 ("Read the canonical example in examples/") and the iced_wgpu/ section point to directories absent from the actual bundle, so the pointers are not fully resolvable as shipped. | 4 / 5 |
Total | 16 / 20 Passed |