Content
75%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, well-structured set of terse, actionable directives with concrete Effect v4 APIs and a clear sequenced source-of-truth procedure. It would benefit from a couple of full executable code examples and an explicit validate-and-retry loop.
Suggestions
Add 1-2 small complete code blocks (e.g. a minimal Effect.gen service method and a testEffect(...)) to lift actionability from directive to copy-paste ready.
Make the source-of-truth workflow an explicit validate->fix->retry loop (e.g. 'If the cloned reference lacks the API, search nearby repo code; if still missing, say so before implementing').
De-duplicate the 'do not answer from memory / verify against the reference' guidance, which appears in both Source Of Truth and Guidelines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — guidelines are terse directives like 'Use Effect.gen(function* () { ... })' with no padding about what Effect is; only minor redundancy between the 'Source Of Truth' and 'Guidelines' lists keeps it from a 5. | 4 / 5 |
Actionability | It gives specific, executable API names (Effect.fn('Name'), Schema.TaggedErrorClass, testEffect(...), it.live(...)) and concrete file paths, though most guidance is directive rather than full copy-paste examples. | 4 / 5 |
Workflow Clarity | The 'Source Of Truth' section is a numbered, sequenced procedure with an explicit verification checkpoint ('Do not answer from memory. Verify against .opencode/references/effect'), but it lacks an explicit validate->fix->retry loop, which keeps it at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Content is well-organized into clear sections (Source Of Truth, Guidelines, Testing Patterns) and points to one-level-deep external references (.opencode/references/effect, packages/core/test/lib/effect.ts); it stays just under 50 lines with no nested references, leaving only minor room to improve. | 4 / 5 |
Total | 16 / 20 Passed |