Content
93%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 model lean overview: copy-paste-ready commands, a compact group table, a clear labeled workflow, and a well-signaled one-level-deep reference system whose files all exist. The only meaningful gap is the absence of explicit validation/checkpoint guidance in the workflow (error recovery is deferred to the shell-integration reference), which keeps workflow clarity at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | In ~96 lines it covers a 9-group CLI with zero explanation of concepts Claude already knows: prerequisites are two install lines, capabilities live in a compact table, and every section is commands. The reappearance of `app snapshot`/`session set-var` across the orientation section and the workflow serves distinct purposes (explanation vs. sequence), so every token earns its place — anchor 5 rather than anchor 4's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common agent cases: `cli-anything-iterm2 --json app snapshot`, `app current`, `session send "git status"`, `session scrollback --tail 200 --strip`, `session split --vertical --use-as-context`, and labeled `session set-var user.role` examples. Matches anchor 5; not 4 because there is no missing key detail for the shown cases. | 5 / 5 |
Workflow Clarity | The 'Typical Agent Workflow' is a clear 4-step numbered sequence (orient → establish context → interact → create workspace) with a built-in send→read-scrollback feedback step, matching anchor 4. Not 5 because there are no explicit validation/error checkpoints (e.g., what to do if context isn't set or a sent command fails); not 3 because the sequence is coherent and verification via reading output is present, if implicit. | 4 / 5 |
Progressive Disclosure | The body is a clean overview with a 'Reference Files' table that signals exactly when to read each of 12 one-level-deep reference files ('Read only what the task requires — each file is a single narrow concern'); all 12 listed files exist in references/ with no nested cross-references, and detail is appropriately deferred. Matches anchor 5's well-signaled, easy-navigation structure. | 5 / 5 |
Total | 19 / 20 Passed |