Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise with a well-sequenced, validated workflow and a strong error table, but its actionability and progressive disclosure are undermined by referenced bundle scripts that are stubs rather than real files.
Suggestions
Add the actual backup_database.sh / restore_database.sh / validate_backup.py scripts to the scripts/ bundle instead of leaving them as TODO checkboxes, and link to them from the body.
Replace the placeholder README stubs in references/, scripts/, and assets/ with the real referenced content or remove the references if the material is not needed.
Optionally include one complete copy-paste-ready backup script example inline so the guidance is fully executable without depending on the missing bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it never explains what a backup is, uses concrete inline commands, and each section earns its place. The only mild restatement is the Overview, which stays informative rather than padded. | 3 / 3 |
Actionability | It gives specific executable fragments (pg_dump --format=custom, tar czf, rsync -avz --delete, gpg --encrypt) and a useful error table, but the Output section promises scripts (backup_database.sh, restore_database.sh, validate_backup.py) that exist only as TODO checkboxes in a stub README rather than real, complete files. | 2 / 3 |
Workflow Clarity | A clear 9-step sequence includes an explicit verification checkpoint (restore to a test environment and validate integrity) plus alerting, and the Error Handling table provides feedback loops for recovery, satisfying the batch-operation validation requirement. | 3 / 3 |
Progressive Disclosure | Sections are well organized, but the body references bundled scripts that are not actually present (only placeholder READMEs with unchecked items), and there are no properly signaled one-level-deep reference links into a real bundle. | 2 / 3 |
Total | 10 / 12 Passed |