Content
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body has a strong, well-sequenced design workflow with explicit validation and checklists, and includes some real executable tooling examples. Its main weaknesses are severe verbosity from restating generic design knowledge, and a monolithic structure whose referenced progressive-disclosure files are missing with their content inlined instead.
Suggestions
Cut generic design-knowledge sections Claude already knows (UX principles, accessibility basics, color/typography theory) and remove duplicated prohibition lists and the oversized tone-options list to recover the token budget.
Actually create the referenced bundle files (ACCESSIBILITY.md, MOTION-SPEC.md, RESPONSIVE-DESIGN.md) and move the corresponding inline content into them so the progressive-disclosure pointers resolve instead of dangling.
Replace abstract design-direction prose with more concrete, copy-paste-ready code and templates so guidance is uniformly actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~983-line body is verbose and explains concepts Claude already knows (typography and color theory, UX principles like direct manipulation/feedback/forgiveness, WCAG accessibility basics), and is padded with repetition such as the "NEVER use these fonts/colors" list stated three times and a 50+ item tone-options list, matching the level-1 anchor. | 1 / 3 |
Actionability | It provides real executable guidance (shadcn/phosphor/sonner imports, Tailwind responsive classes, CSS clamp, a rem typographic scale, box-shadow examples), but this is mixed with substantial abstract design-direction prose, so it is not uniformly copy-paste-ready as required for level 3. | 2 / 3 |
Workflow Clarity | It gives a clear sequence (Design Thinking Protocol, then Design Workflow: understand context → explore options → implement iteratively → validate) with an explicit validate step (playwright MCP, test at each stage, verify accessibility) plus multiple checklists (Design Decision Checklist, Testing Checklist, rule-breaking checklist), matching the level-3 anchor. | 3 / 3 |
Progressive Disclosure | It has section structure and a signaled References section listing ACCESSIBILITY.md, MOTION-SPEC.md, and RESPONSIVE-DESIGN.md, but those referenced files do not exist in the bundle and the corresponding accessibility/responsive/motion content is inline in this monolithic file, fitting the level-2 "content that should be separate is inline" anchor. | 2 / 3 |
Total | 8 / 12 Passed |