Content
85%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 well-structured overview with concrete commands, a clear sequenced workflow with red-flag feedback loops, and clean one-level-deep references to 10 verified files. The main lever is tightening repeated root-cause maxims and surfacing a few more executable commands inline.
Suggestions
Consolidate the repeated 'no fixes without root cause' messaging so it appears once (e.g., in Rule 5) rather than restated in the intro and Red Flags, to tighten conciseness.
Inline one or two concrete Delve/GODEBUG example commands in the body's escalation guidance so actionability does not depend solely on the reference files.
Consider a short 'verify the fix' checkpoint line in the Golden Rules (beyond the decision-tree summary) to make the validate-fix-retry loop explicit in the body itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, directive prose that assumes Go knowledge and a compact decision tree, but the no-root-cause/maxim themes are restated across the intro, rule 5, and the Red Flags section, leaving minor tightening possible. | 4 / 5 |
Actionability | Concrete commands appear in the decision tree (go build, GOTRACEBACK=all, go test -race, curl pprof endpoint, dlv install), but much of the body is methodology/principle with executable detail deferred to reference files, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear numbered workflow (decision tree → golden rules → methodology → red flags → incremental escalation) with explicit recovery feedback loops ('3+ fix attempts → re-read code', 'each fix reveals a new problem → return to Step 1'). | 5 / 5 |
Progressive Disclosure | The body is an overview that one-level-deep references 10 verified reference files, each clearly signaled with a one-line description in the Reference Files section, with no nested references. | 5 / 5 |
Total | 18 / 20 Passed |