Content
90%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 lean, actionable, and clearly sequenced with concrete commands and a worked example. The main gap is that the provided reference files are not surfaced from the body, and the workflow lacks an explicit verification checkpoint before the focus action.
Suggestions
Add one-level-deep links to the existing reference files, e.g. 'See [living_indicators.md](references/living_indicators.md) for the full indicator list and parsing rules' under Core Workflow, to improve navigation and progressive disclosure.
Insert an explicit validation checkpoint before focusing, e.g. 'Confirm the candidate matches a known living indicator (see living_indicators.md) before running `focus on`.', to strengthen workflow clarity.
Reference [action_sequences.md](references/action_sequences.md) from the Example or Key Actions section so the standard transport flow is discoverable rather than only summarized inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-organized with no padding or explanation of concepts Claude already knows; every section (Purpose, Core Workflow, Key Actions, Example, Important Notes) earns its place. It does not reach into verbosity, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Provides copy-paste-ready commands (`look around`, `focus on [IDENTIFIED_OBJECT]`, `pick up [OBJECT]`, `move [OBJECT] to [CONTAINER]`, `teleport to LOC`) plus a fully worked example with a concrete object ('dove egg'), covering the common case. | 5 / 5 |
Workflow Clarity | A clear 4-step sequence with a worked example and prioritization guidance in Important Notes serves as an implicit checkpoint, but there is no explicit 'confirm the candidate is actually living before focusing' validation step, fitting 'clear sequence with most checkpoints, minor validation gaps' rather than the full feedback-loop 5. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and the body is appropriately concise (under 50 lines), but the existing reference files (living_indicators.md, action_sequences.md) containing useful detail (indicator lists, parsing rules, action sequences) are not linked or signaled from the body, leaving a minor navigation gap that keeps it below 5. | 4 / 5 |
Total | 18 / 20 Passed |