Content
75%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 dense, operative, and well-wired: every section points to real scripts or anchored reference sections, commands are copy-paste ready, and risky operations (emergency merge) come with verification and rollback steps. The main weaknesses are the overloaded refresh-consumer table cell and refresh workflow branching that would read better as sequenced steps or a reference page.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operative throughout — e.g. "Run `scripts/validate-standard.sh` for a read-only report" — with zero padding or explanation of known concepts. Not 5 because the `refresh/refresh-consumer.sh` table cell compresses ~25 operational rules into one run-on paragraph where brevity starts to sacrifice clarity. | 4 / 5 |
Actionability | Concrete, executable commands are given: `gh pr edit <PR#> --add-reviewer @copilot`, `gh pr merge <N> --admin --match-head-commit <SHA>`, `fleet repos kendex-refresh`, plus a numbered 4-step bypass procedure. Not 5 because the `refresh/*.sh` scripts lack exact invocation syntax (arguments, checkout steps) and depend on external skill docs for orch/github paths. | 4 / 5 |
Workflow Clarity | Validation checkpoints are explicit — "reads both rulesets back" after adding and removing bypasses, "Confirm that the arm enabled auto-merge", "Wait for GitHub to show the published head" — and error paths are enumerated ("A failed direct merge reports `refresh-error=merge`"). Not 5 because the refresh workflow's branching conditions (bypass-present vs not, armed/disarmed states) are compressed into prose and a table cell rather than a clearly sequenced step list. | 4 / 5 |
Progressive Disclosure | The body is an overview with well-signaled, one-level-deep references to real files: [references/adoption.md](references/adoption.md) with specific section anchors (all verified present), [references/vendored-paths.md](references/vendored-paths.md), and a scripts table pointing to actual bundle scripts. Not 5 because the refresh-consumer behavior spec is inlined in a table cell rather than split to a reference, and several paths point outside the bundle (release checkout, orch/github skills). | 4 / 5 |
Total | 16 / 20 Passed |