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 well-crafted body: lean and code-focused, with an explicit pipeline, per-stage validation checkpoints, and a clean one-level-deep reference structure where every referenced file exists and complements the inline excerpts. The only deduction is that body code snippets are intentionally partial, delegating completeness to the reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is entirely code, tables, and actionable checkpoints with zero explanations of concepts Claude already knows — no "a lexer is..." padding, no library recommendations, no filler. Every section (token types, precedence table, AST unions, evaluator dispatch) earns its tokens, matching the score-5 anchor ("lean and efficient; every token earns its place"). Score 4 would require minor over-explanation to trim, and none is present. | 5 / 5 |
Actionability | Every stage has concrete TypeScript — the TokenType enum, the lexer dispatch loop, the precedence table, the AST discriminated unions, and the evaluator switch — but the body snippets are deliberately partial: the lexer omits helper methods, the parser stops at "// Continue down precedence...", and the interpreter switch is missing several cases. This falls between the score-4 anchor ("concrete code with minor gaps") and the score-5 anchor ("fully executable; copy-paste ready"): the gaps are justified by explicit pointers to the full implementations in references/lexer.md and references/parser.md, but the body code alone is not copy-paste runnable. | 4 / 5 |
Workflow Clarity | The pipeline sequence (Source Code → Lexer → Tokens → Parser → AST → Interpreter → Result) is paired with explicit per-stage validation checkpoints: "feed a test string, inspect token stream for correct types/values", "print AST for a simple expression, confirm node shape matches type definitions", and "evaluate a literal or binary expression before wiring up the full pipeline". Error recovery is additionally signaled via references/error-handling.md. This matches the score-5 anchor (clear sequence, explicit validation steps, error recovery); score 4's example only verifies at the end of the flow, which is clearly weaker than this per-stage checkpointing. | 5 / 5 |
Progressive Disclosure | All five referenced files (lexer.md, parser.md, environment.md, error-handling.md, builtins.md) exist, are exactly one level deep (they complement the body rather than chaining to further files), and are signaled both inline at each excerpt ("// Full implementation → references/lexer.md") and in a dedicated Reference Files section with per-file descriptions. Core patterns live in the body, full implementations in references — matching the score-5 anchor (clear overview, well-signaled one-level-deep references, appropriate split). | 5 / 5 |
Total | 19 / 20 Passed |