Content
38%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 content is a generic template that restates the description, offers only vague platitudes instead of executable guidance, and relies on a referenced playbook file that is missing from the bundle.
Suggestions
Replace generic Instructions with concrete, executable guidance: example alert-rule configs, structured-logging snippets, and integration setup commands for common services (Sentry, Datadog).
Add explicit validation checkpoints to the workflow (e.g., trigger a test error and confirm it appears in the dashboard before finalizing alert rules).
Either provide the referenced `resources/implementation-playbook.md` file or remove the broken reference so progressive disclosure navigation actually works.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and sectioned but restates the frontmatter description verbatim ("You are an error tracking and observability expert...") and includes generic filler sections (Use/Do not use/Context) that could be tightened. | 3 / 5 |
Actionability | Only high-level hints are given ("Apply relevant best practices and validate outcomes", "Provide actionable steps and verification") with no code, commands, configs, or concrete examples; the single detailed reference points to a non-existent file. | 2 / 5 |
Workflow Clarity | A rough sequence exists via the eight-item Output Format list and a generic "validate outcomes" instruction, but there are no concrete validation checkpoints or feedback loops for configuration work. | 3 / 5 |
Progressive Disclosure | The body is organized into sections and signals one-level-deep references to `resources/implementation-playbook.md`, but that file does not exist in the bundle, so navigation is broken. | 2 / 5 |
Total | 10 / 20 Passed |