Content
92%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.
A dense, high-signal body: concrete scripts, commands, and APIs back every rule, CI changes get an explicit prove-it loop, and the Design E2E detail is properly deferred to a real, well-signaled reference. The only cost is dated capacity history (specific dates and slot counts) in the motivation section that will age and could be trimmed or moved.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (no explanation of what CI, Vitest, or E2E testing is) and every rule carries a repo-specific payoff, but time-sensitive facts — "on 2026-09-29 the Fast tests gate waited a median 445 s", "moved to Enterprise Cloud in October 2026, which raises the pool to 500 jobs" — sit in the motivation section rather than a deprecated/old-patterns section and will rot. Efficient with minor trimmable material fits 4; not 3 (no genuinely unnecessary explanation) and not 5 (the dated capacity history costs tokens without guiding action). | 4 / 5 |
Actionability | Guidance is concrete and executable throughout: a copy-paste test command ("node --experimental-strip-types --test scripts/ci-change-scope.test.ts ..."), named scripts and outputs (ci-change-scope.ts, query_budget_apps, script_tests, MIN_SHARD_FILES), exact APIs (testInfo.outputPath, expectOnlyChanged, app.savedNodes), and tooling (actionlint). Specific examples cover the common cases, matching the 5 anchor rather than 4's "minor gaps". | 5 / 5 |
Workflow Clarity | "Proving a CI change" is an explicit validation loop — add classifier test cases, run the test command, verify against real main history and post before/after, run each run: snippet against matching and empty inputs, actionlint, and mind the self-test gap — and "Adding a test" is sequenced from should-it-exist to where-it-lives to what-runs-it. Clear sequences with explicit checkpoints fit the 5 anchor; nothing lands in the destructive/batch cap. | 5 / 5 |
Progressive Disclosure | The bundle is one clearly signaled, one-level-deep reference ("Design's harness ... and its traps are in references/design-e2e.md") that exists and correctly absorbs the harness API table and trap list, while the body keeps the decision-level guidance with well-organized sections. Content is appropriately split with easy navigation, matching the 5 anchor; 4's "minor organization gaps" does not apply. | 5 / 5 |
Total | 19 / 20 Passed |