Content
70%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 highly actionable with strong, validated multi-step workflows and concrete MPS-MCP tool guidance, but it carries some over-explanation of basics and, critically, references seven reference files that are not present in the bundle, breaking progressive disclosure.
Suggestions
Ship the missing references/*.md files (finding-things, node-editing-rules, reference-formats, bulk-creation, analysis-tools, editor-workflow, mcp-tools-index) or inline the essential parts so the signaled navigation resolves.
Trim the Key Concepts section's explanations of AST/projectional-editor fundamentals that Claude already knows, keeping only MPS-specific terminology definitions.
Condense the multi-project and install/refresh notes, which are dense and could move to a single companion reference to reduce body token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is operationally dense and earns its place (specific tool names, ordering chains), but the Key Concepts section explains AST/projectional-editor basics Claude largely knows and some multi-project/installation notes are padded; it could be tightened, matching the "mostly efficient with some unnecessary explanation" anchor. | 3 / 5 |
Actionability | Concrete, specific guidance dominates — named tools like mps_mcp_update_root_node_from_json, mps_mcp_check_root_node_problems, and explicit alter_structure MAKE sequences — with only minor gaps where detail is deferred to reference files, sitting just below the fully copy-paste-ready anchor. | 4 / 5 |
Workflow Clarity | The Structure-to-Aspect Prerequisite Chain is a numbered 4-step sequence with an explicit Verify-Descriptors checkpoint and recovery notes, and the Initialize-a-Session workflow plus "Validate frequently" directive provide clear feedback loops for these destructive/batch model edits, matching the top anchor. | 5 / 5 |
Progressive Disclosure | The body is well-structured with clearly signaled one-level-deep references ("Open references/finding-things.md for..."), but the referenced bundle files do not exist in this package — the ./references/ directory is absent — so the navigation promise is broken and the disclosure structure does not actually deliver, pulling it down to the mid anchor. | 3 / 5 |
Total | 15 / 20 Passed |