Content
50%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 has a sensible structure, strong validation semantics, and appropriate folding of detail into a real reference file, but pervasive mid-sentence truncations, a duplicated paragraph, broken step numbering, and mostly unresolvable reference paths undermine its actionability and navigation. It reads as a compressed artifact whose compression was done mechanically rather than carefully.
Suggestions
Repair the truncated sentences: complete the cut-off clauses in Philosophy ('Higher-priority instructions, command boundaries, and...'), When Not to Use, and Validation, or restructure them as intentional whole-sentence pointers to references/hot-path-folded-context.md instead of mid-sentence dangling fragments.
Fix the structural defects: renumber the Procedure so the second '4.' step ('Translate external material into invariants...') becomes '5.', and delete the duplicated context-disposition paragraph and dangling deferred-context-index pointer at the end of the References section.
Make the validation gates executable: give the actual commands (or a pointer to where they are defined in references/contract.yaml) for 'strict audit', 'OpenClaw', the format lints, and 'Plugin Eval', and resolve or prune the reference paths that do not exist in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean per sentence and assumes Claude's competence (no explanations of known concepts), but it contains clear tightening targets: a duplicated context-disposition paragraph at the end ('Apply the context-disposition policy: move important still-valid context...' appears twice), a dangling pointer line ('../../references/deferred-context-index.md for folded/discarded context'), and five scattered '- See references/hot-path-folded-context.md' bullets. This fits 'mostly efficient but could be tightened' rather than anchor 4, and is nowhere near the padding of anchor 2. | 3 / 5 |
Actionability | Concrete specifics exist (status enum 'pass|fail|blocked', named output sections, named validation tools like 'strict audit, OpenClaw, OpenAI format lint, progressive disclosure lint, Plugin Eval', explicit handoff targets), but no executable commands are given and key details are truncated mid-sentence ('For non-trivial generated improvement artifacts, run or block' ends with no object). This lands between anchors 3 and 4: guidance is specific but incomplete rather than mostly executable. | 3 / 5 |
Workflow Clarity | A sequenced procedure and a genuine feedback loop are present ('stop at the first failed gate, fix or block it, then rerun before broader checks'), but the workflow has real gaps: the Procedure numbers two steps as '4.', and sentences in Philosophy, When Not to Use, and Validation are cut off mid-clause and replaced by folded-context pointers, leaving checkpoint criteria undefined. These gaps match anchor 3 ('sequence present but checkpoints missing or implicit') better than anchor 4. | 3 / 5 |
Progressive Disclosure | Sections are clear, the folded detail genuinely lives one level deep in the real file references/hot-path-folded-context.md, and a dedicated References section exists. However, 7 of the 11 listed references ('../../references/stage-arc-boundary-contract.md', '../../references/subagent-call-contract.md', '../../references/bluf-review-contract.md', '../../references/visual-reference-contract.md', '../../references/deferred-context-index.md', 'Plugins/harness-engineering/references/skill-improvement-loop.md', 'Plugins/harness-engineering/references/agent-native-compression-contract.md') do not resolve within the bundle, references/task-profile.json is never referenced from the body, and the folded-context pointers are buried mid-sentence rather than clearly signaled. That is more than 'minor organization gaps' (anchor 4) but well above anchor 2. | 3 / 5 |
Total | 12 / 20 Passed |