Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a dense, highly actionable testing playbook with concrete commands, named APIs, explicit thresholds, and a clearly sequenced coverage workflow with validation feedback loops. Its main weakness is conciseness (a redundant Quick Reference) and the absence of progressive disclosure via separate bundle files.
Suggestions
Trim or remove the 'Quick Reference' section, which duplicates Core Rules and pass thresholds already stated above, to lift conciseness.
Move the per-package rules (autoformat, markdown, core, slate, etc.) into a references/ file and link to it from the body, splitting the monolithic 246-line file.
Lead the body with a 3-4 line summary of the three-layer goal and the default inner-loop command before the hard constraints, so the overview reads first.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, bullet-driven, and assumes Claude's competence with no basic-concept padding, but the closing 'Quick Reference' section re-states many Core Rules and pass thresholds already covered above, so it is mostly efficient yet could be tightened. | 2 / 3 |
Actionability | It gives fully executable commands and concrete thresholds throughout ('bun run test', 'pnpm test:slowest -- --top 25 --rerun-each 3', '60ms/test or 120ms/file', 'tooling/config/test-suites.mjs') plus specific APIs (createEditor -> createSlateEditor -> createPlateEditor), matching the copy-paste-ready anchor. | 3 / 3 |
Workflow Clarity | The Coverage Strategy lays out a clear pass sequence (>=6 pass, rerun coverage, >=5 follow-up, architecture-safety pass) with explicit validation checkpoints (bun run test:profile, pnpm test:slowest hard gate) and a feedback loop that fixes the warning zone before it becomes a CI failure. | 3 / 3 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ are absent) and the 246-line body is a single well-sectioned file; package-specific rules and the Quick Reference are inline content that could be split out, so it is organized but monolithic rather than overview-plus-references. | 2 / 3 |
Total | 10 / 12 Passed |