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.
The body is a strong, highly executable operational runbook: every command is copy-paste ready and the Chrome setup path includes real validation and error-recovery loops. Its main weaknesses are redundancy — the same rules are restated across 'Plate Defaults', 'Rules', and 'Preferred Shape', plus an empty 'Fallback Setup' stub — and a scattered top-level structure that could push platform-specific detail into a reference file.
Suggestions
Merge the 'Plate Defaults', 'Rules', and 'Preferred Shape' sections into one rule set; directives like the dedicated --user-data-dir, macOS 'open -na', and 'not the daily Default profile' currently appear two or three times.
Delete or flesh out the 'Fallback Setup' section — it currently contains a single sentence that duplicates the Plate Defaults connect-failure guidance.
Move the macOS-specific Local State enumeration, rsync clone, and launch block into a one-level-deep reference file (e.g., references/macos-chrome-setup.md) and link it from a short platform note, keeping the main body lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes Claude's competence (no explanation of what Chrome or CDP is), but the 'Plate Defaults', 'Rules', and 'Preferred Shape' sections restate the same directives two or three times — persistent profile, dedicated --user-data-dir, macOS 'open -na', and 'do not use the daily Default profile' each appear in at least two sections — and the 'Fallback Setup' section is a one-sentence stub. Not 4 because the duplication is a genuine tightening opportunity, not just a minor instance. | 3 / 5 |
Actionability | The guidance is fully executable and copy-paste ready: install commands, the default connect command, a Python snippet to enumerate Chrome profiles, an rsync profile-clone command with the right Singleton/lockfile exclusions, the macOS launch invocation, curl sanity checks, the WebSocket-URL fallback, and lsof to identify a port thief. Specific examples cover the common cases (default connect, broken CDP endpoint, wrong process on 9222). | 5 / 5 |
Workflow Clarity | The Google Chrome path is a clear 5-step sequence with explicit validation checkpoints (curl /json/version health check, page-title verification, WebSocket-URL fallback) and error-recovery loops (lsof, kill the wrong listener, relaunch). Not 5 because the top-level flow across sections is scattered — the 'Fallback Setup' section is an empty stub with no steps, and the connect-first-then-inspect ordering lives in bullet lists rather than an explicit sequence. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so there is no nested-reference risk; sections are clearly headed and navigable. Not 5 because the body runs ~130 lines with the macOS-specific Local State/rsync/open path inlined — platform-specific setup that would fit a one-level-deep reference file — and the duplicate 'Plate Defaults'/'Rules' sections could be consolidated. | 4 / 5 |
Total | 16 / 20 Passed |