Content
88%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 exemplar of executable, validated workflow writing: concrete commands, pinned versions, explicit checkpoints, and thorough error-recovery guidance. Its only real weaknesses are repeated warnings that could be consolidated and one dangling reference to a missing SERVER_SETUP.md file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it never explains what Mattermost or WebSocket is — but repeats guidance: the 'Do not change AllowCorsFrom' warning appears three times, WEBHOOK_HOST=0.0.0.0 instructions twice, and the troubleshooting section restates the step-2 SiteURL settings. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | Every step is copy-paste executable: exact curl/mmctl/pnpm commands, precise regex validators for each prompt, pinned dependency versions (ws@8.21.3, @types/ws@8.18.1), and script invocations that resolve to real files in scripts/ (discover-server.mjs, select-server.mjs, read-response.mjs, configure.ts, remove-config.mjs, verify-runtime.ts). This matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | A clear discovery-first phase plus seven explicitly numbered steps, each with a validation checkpoint: the config-client check ('must print {{base_url}} and then a blank line'), build, tests, restart, and a runtime verifier that creates and cleans up a diagnostic card. The troubleshooting section supplies feedback loops (401 → replacement token; verification timeout → remove diagnostic card), matching the top anchor with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Sections are clear, references are one level deep, and six script paths all resolve to real bundle files — but SERVER_SETUP.md is linked and absent from the bundle (the official URLs are duplicated inline, which mitigates it), and the long troubleshooting section is entirely inline. This fits 'good structure; references mostly clear; minor organization gaps' rather than the clean split of the 5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |