Content
100%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 model instruction document: numbered steps, a copy-paste command for every check, an explicit final validation with deviation interpretation, and disciplined externalization of the exhaustive per-page checklist. It assumes Claude's competence throughout and adds only non-obvious domain knowledge (Obsidian vault behavior, wikilink false-positive shapes) and project-specific rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | No passage explains anything Claude already knows; the densest asides are non-obvious domain facts ("a target ending in `\` is an alias inside a table cell — where Obsidian requires the pipe escaped so the table does not split on it", "it indexes `main`, not this branch"). Rule statements carry their rationale in a single clause ("rewriting a page while reviewing it is how this family of drift starts"), so every token earns its place — matching the lean/efficient anchor rather than the minor-trimmable over-explanation of a 4. | 5 / 5 |
Actionability | Every check has a copy-paste shell form: the heredoc report skeleton, `BASE=$(git config --get branch.$(git branch --show-current).gh-merge-base || echo main)`, the `comm -23` broken-wikilink pipeline, and the claim-shape table mapping each pattern to an exact command (`git grep -l '"name": "@scope/name"' -- '**/package.json'`). The finding block is a literal fill-in template, and the final `grep -c` checks are executable as written. | 5 / 5 |
Workflow Clarity | Steps 0–5 are explicitly numbered with per-step report-writing instructions ("Write `## Scope` now"), and validation is explicit with error recovery: "Both must print `3`. A first count under 3 means a section was renamed or demoted; a second count above 3 means you added a top-level section". The "No step is a stop" section supplies a feedback loop for environment failure ("Every check below has a shell form; use it"), and the external checklist covers the complex `--full` process. | 5 / 5 |
Progressive Disclosure | The single bundle file `references/checklist.md` exists and its headings (currency, bloat, aids, structure, frontmatter, links, hygiene) match the body's description verbatim; it is referenced once, clearly signaled with its content and trigger condition ("on a `--full` sweep, work through it page by page"), and is one level deep with no nested references. The inline body is exactly the per-run core procedure — the appropriate split, matching the clear-overview/well-signaled-references anchor. | 5 / 5 |
Total | 20 / 20 Passed |