Content
88%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.
A tight, highly executable smoke-test runbook with real validation checkpoints and an honest reporting template that discloses isolation limitations. The main improvements are moving the version-pinned crash-signature example out of the main flow (or into a labeled section/reference) to protect long-term conciseness and structure.
Suggestions
Move the OpenCode 1.17.11-specific signature regex into a clearly labeled 'Known crash signatures' section or a one-level-deep reference file so the mainline steps stay version-agnostic.
Add an explicit failure branch for the signature search (e.g., 'If matches appear, the fix is not verified — do not publish; attach the log excerpt to the release issue') to make the go/no-go outcome unambiguous.
State what to do when the expected 'OK' output is not returned, mirroring the existing host-alias fallback guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — copy-paste bash blocks with almost no concept explanation and no padding ('Use env -i for the cleanest smoke. This strips host OPENCODE_*...') earns its tokens by explaining a non-obvious isolation rationale. It misses anchor 5 because it embeds a time-sensitive version-specific example ('For the OpenCode 1.17.11 malformed-message crash, use:') inline rather than in a dedicated section, which the guidelines penalize. | 4 / 5 |
Actionability | Every step is fully executable: complete bash for packing, tarball install with a version verification one-liner, a heredoc config, env -i invocations, the run command with timeout, and a concrete rg pattern for the crash-signature search, plus an expected output ('OK') and a fill-in reporting template. Nothing is pseudocode or hand-waved. | 5 / 5 |
Workflow Clarity | The 'Core Workflow' numbers steps 1-8 in execution order, and explicit validation checkpoints are woven throughout: verify 'plugin_origins has exactly one entry', confirm the model, check the expected 'OK' result, and 'No matches should appear' for the signature search. Conditional recovery paths are also handled ('If OpenCode needs provider aliases from the host environment, run a second non-isolated... smoke and clearly label it'). | 5 / 5 |
Progressive Disclosure | Sections are well organized (Core Workflow, Pack Candidate, Isolated Config, Runtime Smoke, Host-Provider Smoke, Reporting Template) with no nested references and no orphaned pointers — the bundle has no external files and the body references none. It is not anchor 5 because at ~150 lines the version-specific signature detail and the host-provider variant are candidates for a one-level-deep reference file rather than staying fully inline. | 4 / 5 |
Total | 18 / 20 Passed |