Content
71%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 highly actionable, well-sequenced design review workflow with concrete commands, table templates, and STOP checkpoints throughout. Its main weaknesses are a monolithic 1100-line body with zero bundle files (framework boilerplate, design rules, and blacklists all inlined) and a duplicate 'Step 0' heading that muddles step ordering.
Suggestions
Move the shared framework material (Voice, AskUserQuestion Format, Telemetry, Contributor Mode, Plan Status Footer — roughly the first 380 lines) into a bundled reference file and keep a one-line pointer, cutting body tokens by about a third.
Split the Design Hard Rules and AI Slop blacklist (Pass 4) into references/design-rules.md, keeping only the classifier and litmus checks inline in the pass.
Rename 'Step 0: Detect platform and base branch' (e.g., to 'Step 0P: Platform detection') or fold it into the preamble so 'Step 0' unambiguously means Design Scope Assessment in the priority hierarchy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The design-review core ('Rate 0-10', the AI slop blacklist, pass structure) is dense, but roughly 380 of ~1115 lines are shared framework material (Voice/persona rules, telemetry and proactive prompts, Contributor Mode, Plan Status Footer) that does not serve the design-review task. It fits anchor 3 rather than 2 because it never explains concepts Claude already knows — the padding is structural, not conceptual. | 3 / 5 |
Actionability | Nearly everything is executable: exact commands ('$D variants --brief "..." --count 3 --output-dir', the feedback polling loop), the feedback JSON shape, the interaction state table template, and explicit substitution rules for placeholders like SKILL_NAME/OUTCOME. Copy-paste ready commands with specific examples covering the common cases match anchor 5. | 5 / 5 |
Workflow Clarity | The sequence is explicit (Pre-review audit → Step 0 scope with STOP → Step 0.5 mockups → 7 passes each with STOP/AskUserQuestion → required outputs → review log → dashboard) and validation checkpoints exist ('$D check' quality gate, feedback confirmation loop, fallbacks on failure). Not 5 because two different sections are both titled 'Step 0' ('Detect platform and base branch' vs 'Design Scope Assessment') and the priority hierarchy references 'Step 0' ambiguously, leaving minor sequence gaps. | 4 / 5 |
Progressive Disclosure | No bundle files exist; everything — Voice, Design Hard Rules, the 10-item AI Slop blacklist, dashboard formats — is inlined in a single 1100-line body. Section structure and in-file navigation are good and external framework pointers exist ('$GSTACK_ROOT/ETHOS.md'), but large content that should be in separate reference files is inline, fitting anchor 3 rather than 2 ('minimal structure') because the internal structure is solid. | 3 / 5 |
Total | 15 / 20 Passed |