Content
96%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.
An exceptionally lean, actionable runbook: every step is executable, the workflow closes with an explicit re-validation loop, and detail is delegated to COLLECTION_SPEC.md. The only weakness is that a few spec rules are restated inline, slightly blurring the overview-vs-reference split.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational content only — exact script invocations, thresholds ("over **500** code points"), field names, and failure conditions — with zero explanation of concepts Claude already knows and no padded sections. Every line carries repo-specific information that earns its place. | 5 / 5 |
Actionability | Commands are copy-paste ready throughout: `uv run python scripts/validate_collection_compliance.py`, `uv run python scripts/bootstrap_catalog.py --plugin <plugin>`, `uv run python scripts/catalog_yaml_to_json.py --plugin <plugin>`, `make catalog-mirror-json`, and a concrete Example usage block covering the common case (rh-developer). Classification criteria give exact rules (refs must start with `#`, `name == <n>`, GREEN/ORANGE maturity). | 5 / 5 |
Workflow Clarity | The four-step workflow has an explicit validate→fix→re-validate feedback loop (step 1 re-run and capture errors, step 4 "Re-validate — `make validate-collection-compliance`"), a classification checklist for error recovery, and explicit fail conditions for the semantic review ("Fail review if any of these drift conditions are found"). Validation checkpoints are present, so no cap applies. | 5 / 5 |
Progressive Disclosure | Sections are well organized and [COLLECTION_SPEC.md](../../COLLECTION_SPEC.md) is a clearly signaled, one-level-deep reference used consistently for full spec detail. However, some spec-level policy text (fragment provenance banner rules, thin deploy_and_use MCP criteria) is inlined rather than fully delegated, which is a minor organization gap rather than the clean split of a 5. | 4 / 5 |
Total | 19 / 20 Passed |