Content
78%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.
A tight, highly actionable workflow with exact tool orchestration and good error-recovery guidance. The main defect is broken progressive disclosure: both linked reference files are missing from the bundle.
Suggestions
Add the missing references/output-format.md and references/failure-patterns.md files to the bundle, or inline their essential content and drop the links.
Fold the Troubleshooting checks (verify build ID, empty failed_pipeline_tests fallback) into the relevant steps as inline validation checkpoints.
State the analysis-only boundary once (in Rules) and reference it from the intro instead of repeating it three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational with no filler, but the analysis-only boundary is repeated three times (intro 'It does NOT apply fixes', Rules 'Analysis-only: never edit files', step 6 'Recommend azsdk-common-pipeline-fixer'), which is minor over-explanation that could be trimmed. | 4 / 5 |
Actionability | Fully actionable instruction-only guidance: exact MCP tool names, exact parameters (failedTestRunsPath, artifact_file_path, testCaseTitle), a decision rule for per-file vs per-test calls, real build IDs in examples, and concrete fallbacks in Troubleshooting. | 5 / 5 |
Workflow Clarity | Six steps are clearly sequenced with decision points and error recovery, but validation checkpoints ('verify the build ID is correct', the empty-artifacts fallback) sit in a separate Troubleshooting section rather than inline in the step sequence. | 4 / 5 |
Progressive Disclosure | References are well-signaled and one level deep ('[output format](references/output-format.md)', '[failure patterns](references/failure-patterns.md)'), but neither referenced file exists in the bundle, so the navigation chain dead-ends and the disclosure structure cannot function. | 3 / 5 |
Total | 16 / 20 Passed |