Content
85%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, project-specific instruction set that respects Claude's competence — it teaches only non-obvious gotchas and conventions, sequences a ten-step workflow with explicit build-fix-retry validation loops, and pushes the worked code and detection procedure into well-signaled one-level-deep references. The only improvements available are trimming cross-section repetition and specifying the build command and contract-verification method.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries project-specific knowledge Claude would not reliably have (NodeNext .js suffixes break the build, useSearchParams needs Suspense or static generation fails, Drizzle has no findOne, repositories are the single query path). Minor trimming is possible: the tests rule, the docs-editing prohibition, the layout-detection pointer, and the .js-suffix rule each appear twice, and the Gaps section runs long, so it sits at anchor 4 rather than the lean anchor 5; it is clearly above anchor 3, which expects filler-style unnecessary explanation. | 4 / 5 |
Actionability | Highly concrete: exact folder anatomy with file names, a copy-paste-ready marker comment format, an executable transaction snippet, and the single-row-read pattern with code. The common cases are delegated to a real worked example (read and write use case, backend and frontend). It stays at anchor 4 rather than 5 due to minor gaps: the actual build command is never stated ("run its build") and step 9's contract check names what to verify (field names, types, nullability) but no method. | 4 / 5 |
Workflow Clarity | The 10-step workflow is clearly sequenced with explicit validation checkpoints and feedback loops: "fix each reported error and build again until it passes" at steps 6 and 8, a JSON-contract agreement check at step 9, and a final business-rule marker audit at step 10. It also guards risky operations (new migration, never edit an applied one), fully matching anchor 5. | 5 / 5 |
Progressive Disclosure | The heavy material is correctly split into two real, one-level-deep bundle files, each clearly signaled with what it contains and when to read it: references/project-layout.md (detection procedure, read before writing anything) and references/worked-example.md (end-to-end Product feature, read while implementing). Sections are well-organized (Instructions, DO NOT, markers, gaps, workflow, backend, frontend, resources) and navigation is easy, with no nested reference chains in either file. | 5 / 5 |
Total | 18 / 20 Passed |