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 content is highly actionable with a clear, validated two-phase workflow and executable SQL throughout, but it is somewhat verbose and fails to wire its existing bundle scripts into the body for navigation. Tightening the examples and referencing the report-generation script would raise the weaker dimensions.
Suggestions
Reference the bundled generate_validation_report.py and configure_validation_rules.py scripts from the Instructions or Output sections so the bundle is discoverable and progressive disclosure improves.
Tighten the Examples section and condense the Error Handling table to reduce verbosity while preserving the actionable SQL.
Reconcile the scripts README with the actual bundle: validate_data.py is listed but absent — either add it or remove the dangling reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable SQL and no concept tutorials, but it is long and the Examples section plus the verbose error-handling table add illustrative padding that could be tightened, matching the score-2 'mostly efficient but could be tightened' anchor rather than the lean score-3. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready SQL for auditing, referential checks, regex validation, CHECK/FK constraints, triggers, and a two-phase NOT VALID application, matching the score-3 fully-executable anchor. | 3 / 3 |
Workflow Clarity | A 10-step sequence with an explicit two-phase approach (find violations + cleanup, then apply constraints with NOT VALID and validate) and an error-handling table providing feedback loops matches the score-3 anchor with explicit validation checkpoints for these database operations. | 3 / 3 |
Progressive Disclosure | Bundle scripts exist (configure_validation_rules.py, generate_validation_report.py) and a referenced validate_data.py is missing, but the body never links to or signals any bundle file, leaving the instructions as an inline monolith — matching the score-2 anchor of references present but not signaled and inline content that should be separate. | 2 / 3 |
Total | 10 / 12 Passed |