Content
85%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.
An exceptionally actionable, well-sequenced safety protocol: executable per-runner commands, pass/fail gates with recovery paths, and a clean one-level-deep reference split verified against the actual bundle. The one weakness is conciseness — several sections argue rationale and re-explain known SRE concepts at a length that could be cut roughly in half without losing any instruction.
Suggestions
Trim persuasive rationale prose (the "Why this protocol is strict" section, the paragraph on the watcher's psychology under time pressure) to single-line pointers — the gate and contract tables already carry the operative rules.
Compress multi-sentence quotations from principlesofchaos and the SRE book to short attributed phrases; Claude already knows error budgets, golden signals, and recoverability, so the cited definitions need not be reproduced verbatim.
Remove the version-pinned citation detail ("ISTQB glossary (V4.7.2)") in favor of the bare link, and drop or compress the refuse-to-start list that restates the four gates already covered by the gate summary table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The protocol substance (contract table, gates, command table, recovery checks) is dense and earns its tokens, but there is genuine tightening available: multi-sentence external quotations (principlesofchaos, SRE book) re-explain concepts Claude already knows such as error budgets, the "Why this protocol is strict" and mid-run-psychology paragraphs argue rather than instruct, the refuse-to-start list restates the four gates already tabulated, and a version-pinned citation ("ISTQB glossary (V4.7.2)") adds time-sensitive detail. This fits the 3 anchor (mostly efficient, some unnecessary explanation that could be tightened); it is above 2 because no section is pure padding, but below 4 because over-explanation appears in several places, not isolated instances. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: per-runner inject/abort commands ("kubectl apply -f <experiment>.yaml" / "kubectl delete -f <experiment>.yaml", "litmusctl chaos run -f", "gremlin attack new --command", "toxiproxy-cli toxic add --type <type> --attribute <name=value> <proxy>"), a fully specified drill contract with exact fields, numeric gate pass/fail conditions, and a complete filled-in output record example. This matches the 5 anchor (fully executable commands covering the common cases). | 5 / 5 |
Workflow Clarity | The four stages are explicitly sequenced ("pre-flight gates, then injection, then the live monitor, then recovery validation") with validation as the backbone: every gate is pass/fail with a defined on-failure action, abort steps require recording timestamp/criterion/signal values, recovery validation runs "regardless of how the run ended", and verdicts feed next actions (NOT_RECOVERED becomes an incident; no next drill from an unrecovered state). Feedback loops are present for this risky-operation skill, matching the 5 anchor; the destructive-operation cap of 3 does not apply because validation is pervasive rather than missing. | 5 / 5 |
Progressive Disclosure | The body is the overview/protocol and the three details that would bloat it are split into real, one-level-deep, well-signaled references: golden-signals.md linked from Gate 3 with its purpose stated, worked-example.md introduced by a section describing exactly what it contains, and anti-patterns.md introduced with an enumeration of all nine entries (verified against the actual files, which exist and match). This matches the 5 anchor; a 4 would require buried or unclearly signaled references, which these are not. | 5 / 5 |
Total | 18 / 20 Passed |