Content
81%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 well-structured, actionable, and sequenced with strong validation checkpoints for destructive database operations. Its main weaknesses are minor redundancy in the Rubric-Critical Facts section and two dead handoff references that slightly undermine navigation.
Suggestions
Deduplicate the RDS-Proxy-does-NOT-support-Oracle and CMAN facts between the Overview, Troubleshooting, and 'Rubric-Critical Facts' sections, and remove meta-commentary like 'the rubric greps for these' to tighten conciseness.
Either add the missing references/handoff-contract.md and references/workload-primary-artifact.schema.json files or remove the Handoff section's citations of them so all in-body links resolve.
Inline one or two complete runnable examples (e.g. a thin-mode Lambda handler with a module-level pool, or a SecretProviderClass YAML) to lift actionability from mostly-executable to fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and action-oriented without explaining concepts Claude already knows, but the 'Rubric-Critical Facts' section repeats CMAN/RDS-Proxy facts also present in Overview and Troubleshooting, and includes meta-commentary like 'the rubric greps for these' that could be trimmed. | 4 / 5 |
Actionability | Provides concrete, executable AWS CLI commands, SQL snippets, and diagnostic commands (e.g. 'aws ec2 authorize-security-group-ingress ...', 'nc -zv <rds-endpoint> 1521', 'SELECT value FROM v$parameter ...'), though some full runnable code (Lambda/EKS manifests) lives in references and a few entries are directives rather than copy-paste snippets. | 4 / 5 |
Workflow Clarity | Multi-step process is clearly sequenced (Classify and Route -> Verify Dependencies -> Execute Workflow) with explicit validation gates: mandatory dependency checks, upfront parameter formats, a refuse-and-offer-assessment gate for destructive ops, and per-scenario checklists ('Rubric-Critical Facts'). | 5 / 5 |
Progressive Disclosure | Clear overview with a routing table mapping user phrases to one-level-deep reference files, all of which exist; however the Handoff section references 'references/handoff-contract.md' and 'references/workload-primary-artifact.schema.json' that are not present in the bundle, creating dead links. | 4 / 5 |
Total | 17 / 20 Passed |