Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is dense, executable, and well-structured as a verification-harness authoring guide, scoring high on conciseness, actionability, and progressive disclosure. The main gap is workflow clarity: it defines validation at each step but lacks validate->fix->retry feedback loops for the destructive/batch operations it covers.
Suggestions
Add explicit error-recovery feedback loops for the database/batch operations - e.g., 'if the SHA check fails, re-run the backup with verbose logging and re-verify; if the restore spot-check fails, alert the on-call and open a ticket' - to move from validation-only to a validate->fix->retry cycle.
In Step 6, wrap the retention test's head_object call in try/except inside the code block itself rather than only noting it afterward, so the example is correct and executable as written.
Add a short 'Definition of done / audit checklist' consolidating the assertions across all eight steps, so an auditor can verify the harness is complete in one pass.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-heavy - concrete tables and executable bash/yaml/python blocks with only brief, load-bearing framing (e.g., "Backups silently fail in many ways...") rather than explanations of concepts Claude already knows. | 3 / 3 |
Actionability | Provides fully executable code and commands throughout - pg_dump/sha256sum/gpg pipelines, a CI cron job, pg_restore and S3 version-id commands, and pytest functions - that are copy-paste ready, matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | Steps 1-8 are clearly sequenced with explicit verification checkpoints (SHA match, signature verify, count>0), but error-recovery feedback loops (validate -> fix -> retry) are absent for database/batch operations, which the rubric caps at 2. | 2 / 3 |
Progressive Disclosure | A single well-organized file with clearly labeled sections and a References block pointing one level deep to sibling skills (dr-drill-runner, restore-time-tests, secrets-rotation-runner) and an external DR guide, with no nested references. | 3 / 3 |
Total | 11 / 12 Passed |