Content
82%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 highly actionable with executable commands, a clearly sequenced and verified workflow, and well-organized progressive disclosure via a real bundled script. The main gaps are minor: a missing explicit error-recovery loop in the workflow and some inlined snapshot-usage detail that could live in a reference file.
Suggestions
Add an explicit validate→fix→retry feedback loop in the workflow (e.g., if the re-run does not show reduced RSS, return to Classify and re-inspect retainers) to push workflow_clarity toward 5.
Move the detailed snapshot-comparison flag usage and the runtime-fix harness modes into a short references/ doc, keeping the body as a concise overview that links out, to lift progressive_disclosure.
Tighten a few repetitive phrasings (e.g., repeated full paths to heapsnapshot-delta.mjs) to push conciseness toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-rich with every line carrying actionable domain specifics (config names, script paths, classification heuristics) and assumes Claude's competence without explaining what Vitest or RSS is; it is efficient with only minor phrasing that could be trimmed, landing just below the lean/5 anchor. | 4 / 5 |
Actionability | It provides fully executable, copy-paste-ready commands throughout (pnpm test:perf:groups with config/output flags, /usr/bin/time -l pnpm test <file> --maxWorkers=1, the snapshot delta invocation with --top/--min-kb/--pid flags), with concrete examples covering the common cases. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (Reproduce → Collect evidence → Classify → Fix → Verify) with an explicit verification checkpoint (re-run and confirm the max-RSS trend/OOM is reduced); it stops short of 5 because there is no explicit validate→fix→retry error-recovery loop for the batch/grouped operations. | 4 / 5 |
Progressive Disclosure | Well-organized sections and the one bundle file (scripts/heapsnapshot-delta.mjs, a real 556-line script) is referenced repeatedly with clear one-level-deep paths; it sits at 4 rather than 5 because some snapshot-comparison usage detail is inlined in the body rather than moved to a separate reference doc, and no references/ directory is used. | 4 / 5 |
Total | 17 / 20 Passed |