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.
The body is a lean, highly actionable reference: concrete commands, canonical code patterns, and decision tables, with details correctly split into four one-level-deep reference files that all exist. Its only weakness is mild repetition of the verify-against-source guidance across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by dense decision tables and shell commands ("ls "$SRC/packages/better-auth/src/plugins"", "rg "^export " "$SRC/packages/better-auth/src/index.ts"") with no explanation of concepts Claude already knows. However, the "Do Not Trust Internal Knowledge" list states the enumerate-before-writing rule twice (items 2 and 4: "Verify plugin names, adapter imports, and option shapes" / "Never invent plugin names, adapter import paths"), and the verify-against-source instruction recurs across the Finding Documentation, adapters, plugins, and databases sections — minor trimmable redundancy that fits the 4 anchor rather than the 5 anchor's "every token earns its place". | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: install commands, source resolution ("SRC=$(ask src better-auth)"), complete server/client setup code blocks, an exact per-framework mount table ("toNextJsHandler(auth) at app/api/auth/[...all]/route.ts"), adapter signatures ("prismaAdapter(prisma, { provider })"), and "npx auth generate / migrate". The single placeholder ("database: /* DB adapter or Kysely dialect — see references/databases.md */") is a required project-specific choice backed by a concrete adapter table and reference file, so it is a deliberate pointer rather than a missing detail — matching the 5 anchor, not the 4 anchor's "minor gaps". | 5 / 5 |
Workflow Clarity | A clear sequence is laid out: verify install in the lockfile → resolve the installed version with `ask` → verify names before generating code → "Run typecheck after changes to surface silent breakage early", plus an explicit error-recovery feedback loop ("grep references/common-errors.md for the failing symptom … If the symptom is not listed, resolve the source and grep the error string"). Explicit validation checkpoints plus a fix-and-retry loop match the 5 anchor; the operations are code-generation rather than destructive/batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is an overview with decision tables, and all detail lives in four real bundle files verified on disk: references/adapters.md, references/plugins.md, references/databases.md, and references/common-errors.md. Every inline pointer is clearly signaled with scope notes ("Full wiring, cookie handling, and CORS gotchas per framework: references/adapters.md") and a terminal References section lists all four with one-line descriptions — one level deep, matching the 5 anchor exactly. | 5 / 5 |
Total | 19 / 20 Passed |