Content
63%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 well-organized and concise with a sound measure-first workflow, but its value is undermined because all detailed content is offloaded to reference files and a script that are not present in the bundle. Adding the missing files or inlining the key profiling recipes would resolve the largest gaps.
Suggestions
Ship the referenced bundle files (references/profiling-recipes.md, references/optimization-playbook.md, scripts/performance_profiler.py) so the offloaded detail and Quick Start commands are actually available.
Inline at least one concrete profiling recipe (e.g. a py-spy or pprof flamegraph command) so the body is actionable even before opening references.
Convert the "Golden Rule: Measure First" from comment prose into an explicit numbered workflow with a concrete validation/re-measure step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (bullet lists, command snippets), but the Overview near-duplicates the frontmatter description and the "Golden Rule" section is comment-only prose that could be trimmed, keeping it just below a 5. | 4 / 5 |
Actionability | Quick Start gives concrete commands, but the substantive profiling know-how (flamegraph generation, py-spy, pprof, EXPLAIN ANALYZE) is deferred to references/profiling-recipes.md and the Golden Rule section is comment-only — and the referenced script/files do not exist in the bundle, leaving key details missing. | 3 / 5 |
Workflow Clarity | The "Golden Rule: Measure First" lays out a clear before/after sequence (baseline → profile → confirm bottleneck → fix → measure → verify) with an implicit verification checkpoint, but it is presented as comments rather than an explicit numbered workflow with validation commands, so it stops short of a 5. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and clearly signals one-level-deep references (profiling-recipes.md, optimization-playbook.md), but those referenced files and the cited script are absent from the bundle, so the disclosure chain leads to dead ends and core profiling content is unreachable. | 3 / 5 |
Total | 14 / 20 Passed |