Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, well-sequenced workflow with concrete command fragments, explicit verification, and a useful error-handling table. Its main weaknesses are incomplete actionability (no real scripts — only placeholder checkboxes) and broken progressive disclosure (empty bundle directories, nothing linked from the body).
Suggestions
Provide the actual scripts referenced in scripts/README.md (backup_database.sh, restore_database.sh, validate_backup.py) as real, executable files and link to them from the Instructions/Output sections.
Move the detailed restore runbook and per-database examples into references/ files (e.g., RESTORE_RUNBOOK.md, DATABASE_EXAMPLES.md) and signal them from the body to deepen progressive disclosure.
Add a complete, copy-paste-ready example script with logging, lock file, and error handling to lift actionability from fragments to fully executable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it does not explain what tar, rsync, pg_dump, or backups are, and every section (Overview, Prerequisites, Instructions, Output, Error Handling, Examples, Resources) earns its place with terse, actionable content. | 3 / 3 |
Actionability | Provides concrete command fragments and flags ('pg_dump --format=custom', 'tar czf', 'rsync -avz --delete', 'gpg --encrypt', 'sha256sum'), but no complete, copy-paste-ready scripts; the promised backup/restore/validate scripts exist only as unchecked checkboxes in scripts/README.md rather than real files, leaving guidance incomplete. | 2 / 3 |
Workflow Clarity | The Instructions form a clear 9-step sequence (inventory → classify → select strategy → generate → retention → encrypt → schedule → verify → alert) with an explicit verification step ('restore to a test environment on a weekly schedule and validate data integrity') and an Error Handling table providing cause/solution feedback loops, matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | The body is well-organized into clear sections, but the bundle directories are placeholder READMEs only — references/ and assets/ are empty and scripts/README.md lists four planned scripts as unchecked checkboxes — and none of these are referenced or linked from the body, so content that should live in separate files (backup scripts, restore runbook, validation script) is promised but absent. | 2 / 3 |
Total | 10 / 12 Passed |