Content
50%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 with a clear diagnosis flow and a service routing table, but its guidance is undermined by bundle integrity problems: three of six service guides point to nonexistent files, the bundled diagnostic scripts are mandated by rule but never identified, and the trigger list plus several CLI blocks duplicate content. Workflow steps exist but lack any verification checkpoints.
Suggestions
Fix or add the missing troubleshooting/ files (aks-troubleshooting.md, vm-troubleshooting.md, messaging/README.md) — or repoint the routing table, Routing section, and References section to the paths that actually exist in the bundle.
Name and link the bundled diagnostic scripts (e.g., scripts/aks-baseline.sh, scripts/appservice-diagnostics.sh, scripts/test-messaging-connectivity.sh) in Rule 7 or a table, since the rules direct running 'the applicable script first' without ever identifying one.
Add a verification step to the Quick Diagnosis Flow (e.g., confirm the suspected root cause against resource health/logs before remediating, and re-check the symptom after remediation), and trim the duplicated Triggers section and repeated az CLI blocks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean (tables, terse rules, command blocks, no explaining concepts Claude already knows), but there is real tightening to do: the 14-bullet Triggers section largely duplicates the frontmatter description's trigger list; 'az resource show' and 'az monitor activity-log list' appear identically in both 'Quick Reference' and 'Check Azure Resource Health'; and the 'AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE' banner adds no information. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 4 because the duplication is recurring, not a minor instance. | 3 / 5 |
Actionability | There is concrete, executable guidance (az CLI commands, a KQL example query, a routing table), but key details are missing: the three primary troubleshooting guides referenced for AKS, VM, and Messaging ('troubleshooting/aks/aks-troubleshooting.md', 'troubleshooting/compute/vm-troubleshooting.md', 'troubleshooting/messaging/README.md') do not exist in the bundle, so following the routing leads nowhere for half the services; the MCP blocks use a non-executable intent/command/parameters pseudocode format; and Rule 7 directs 'run the applicable script first' without ever naming or linking any of the 12 bundled scripts in scripts/. This matches anchor 3 ('some concrete guidance but incomplete... missing key details'); not 4 because the broken links and unnamed scripts are gaps in the core guidance, not minor ones. | 3 / 5 |
Workflow Clarity | The 'Quick Diagnosis Flow' gives a coherent 5-step sequence (identify symptoms, check resource health, review logs, analyze metrics, investigate recent changes) reinforced by Rules 4 and 7, but there are no validation checkpoints or feedback loops — nothing like 'verify the remediation resolved the symptom' or what to do when a step yields nothing. This matches anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit'); not 4 because every checkpoint in the flow is implicit. | 3 / 5 |
Progressive Disclosure | Structure is good in places — a service routing table with clearly signaled references, one-level-deep reference dirs (references/functions/ with README.md, durable.md, triggers.md), and top-level reference files that all exist. But scored against the actual bundle: 3 of the 9 referenced paths (the entire troubleshooting/ tree) are missing, and the 12 scripts in scripts/ are never linked or named anywhere despite Rule 7 making them the preferred collection path. That is more than the 'minor organization gaps' of anchor 4, fitting anchor 3 ('some structure but could be better organized'). | 3 / 5 |
Total | 12 / 20 Passed |