Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, lean workflow document with concrete version-resolution logic and a useful checklist. Its main gaps are abstract git/PR operations and the absence of a verification feedback loop for the batch refresh process.
Suggestions
Add concrete, copy-paste-ready git and gh commands for Steps 1 and 7 (e.g., `git fetch origin main && git checkout -b refresh/<pkg>-<date>`, `gh pr create --title "Prepare release for Azure.ResourceManager.XXX Version 1.x.x"`).
Add an explicit verification checkpoint after Step 7 — e.g., confirm the PR was created, check CI status, and loop back to fix the changelog/csproj if validation fails.
Clarify the exact PR title-version interpolation (where the 1.x.x comes from) so the title can be assembled deterministically rather than left as a template.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean bullet-style workflow with no explanations of concepts Claude already knows; each section (Prerequisites, Steps 1–7, Checklist) earns its place, and the closing checklist serves as a quick reference rather than padding. | 3 / 3 |
Actionability | Concrete file paths (eng/centralpackagemanagement/Directory.Packages.props, src/Azure.ResourceManager.XXX.csproj, metadata.json) and detailed version-resolution logic are actionable, but the git/PR steps ('Commit with a refresh-focused message', 'Push branch to origin', 'Create PR') are described rather than given as copy-paste commands. | 2 / 3 |
Workflow Clarity | Steps are clearly numbered and the Step 2 eligibility check is a validation checkpoint, but this batch operation across packages lacks an explicit verify→fix→retry feedback loop, capping workflow clarity at 2 per the batch-operations guideline. | 2 / 3 |
Progressive Disclosure | A single self-contained file with well-organized sections (When to Use, Scope Boundaries, Prerequisites, Workflow, Checklist) and no need for external references; structure is clear and easy to navigate. | 3 / 3 |
Total | 10 / 12 Passed |