Content
100%Reviews 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, expert-level overview: operational 'Critical Directives', a validated multi-step workflow with an error-recovery feedback loop, and a clean reference index pointing to seven substantive, verified reference files. It assumes Claude's competence and delegates executable detail to appropriately split bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding — it never explains what MPS or a constraint is, and lines like 'Setter (propertySetter) — normalises and must explicitly assign node.<prop> = propertyValue' assume Claude's competence; every token carries domain-specific knowledge Claude does not already have, matching the 'lean and efficient; every token earns its place' anchor rather than the score-2 'includes some unnecessary explanation'. | 3 / 3 |
Actionability | It gives concrete, executable guidance — specific MCP tool calls with parameters (mps_mcp_insert_root_node_from_json, mps_mcp_check_root_node_problems, mps_mcp_parse_java_and_insert), exact model imports (jetbrains.mps.lang.constraints, jetbrains.mps.scope), and named concept roots (ConceptConstraints, NodePropertyConstraint); per the code-vs-instruction note, deferring full JSON/code blueprints to reference files is not penalized since the in-body guidance is concrete and actionable, clearing the 'fully executable code/commands; specific examples' anchor. | 3 / 3 |
Workflow Clarity | The 'Common-Path Workflow' is a clearly sequenced 6-step process with an explicit validation checkpoint (step 6: 'Validate with mps_mcp_check_root_node_problems and rebuild the language') and a feedback loop for error recovery ('if the new constraint is invisible at runtime, run mps_mcp_reload_all'), matching the 'clear sequence with explicit validation steps; feedback loops for error recovery' anchor rather than the score-2 'validation gaps; checkpoints missing'. | 3 / 3 |
Progressive Disclosure | The body is a focused overview with a 'Reference Index' that gives 'Open references/X.md when ...' guidance for each of seven one-level-deep reference files (all verified present — referent-constraints.md is ~46KB, scope-fqn-reference.md ~13KB, confirming heavy detail was correctly externalized); navigation is well-signaled and content appropriately split, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 3 / 3 |
Total | 12 / 12 Passed |