Content
81%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 a strong, highly actionable workflow: concrete parameterized MCP invocations and CLI commands for every entry path (PR, branch, working tree), an explicitly sequenced review process with decision checkpoints, and a genuine error-recovery fallback. Its only real weakness is token efficiency — the opening bullets duplicate the detailed sections, the terminal-CLI equivalent is repeated, and dense field-level API detail is inlined rather than offloaded to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every token is Repowise-specific with no explanations of concepts Claude already knows, but it could be tightened: the two-bullet intro duplicates the "Score the whole change first" section, the `repowise risk <revspec>` CLI equivalent is stated twice nearly verbatim ("The `repowise risk <revspec>` CLI is the identical scorer" and "The equivalent from a terminal is `repowise risk <revspec>`"), and the `tests_to_run` bullet inlines dense field-by-field API detail. Mostly efficient with some redundancy — anchor 3. | 3 / 5 |
Actionability | Fully concrete invocations with parameters cover the common cases: `get_change_risk(revspec="main..HEAD")`, `get_risk(targets=<changed files>, changed_files=<same changed files>)`, `get_why(query="<file>")`, `get_health(targets=..., include=["biomarkers"])`, plus terminal paths `gh pr diff <number>`, `git diff --name-only main...HEAD`, and `repowise impacted-tests <revspec>` with `--format list | xargs pytest`. Placeholders like `<changed files>` are inherently variable and appropriately used. | 5 / 5 |
Workflow Clarity | The headers impose an explicit sequence ("Score the whole change first" → "Then drill into the per-file directive" → "Then go deeper where it matters"), with decision checkpoints ("read `directive` first", "Check `tests_run_all` first", a `warning` field or `unknown` status means an all-zero score is not a clean bill of health) and an error-recovery feedback path (if `get_risk` errors, review from the raw diff and note Repowise was unavailable, suggesting `/prompts:repowise-init`). This is read-only analysis, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the ~115-line body is well-organized under clear section headers with a logical overview-to-detail flow. Not 5 because all content is inlined — the field-level semantics of `tests_to_run`, `tests_run_all`, `tests_to_run_basis`, and `impacted_tests` read like API-reference material that could live in a one-level-deep reference file; not 3 because structure and placement are otherwise good with nothing buried. | 4 / 5 |
Total | 17 / 20 Passed |