Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and well-sequenced with strong verification discipline, but it is a monolithic file with repeated rules that could be tightened and split into reference materials for progressive disclosure.
Suggestions
Deduplicate the repeated 95%+ confidence and no-PR rules by stating them once in Hard Rules and referencing that section elsewhere.
Move the detailed comment-body template and the common Slate v2 gate commands into reference files (e.g. references/comment-template.md, references/verification-gates.md) linked from the main body to improve progressive disclosure.
Tighten the Hard Rules list by merging near-duplicate constraints (e.g. the three separate 'Do not ... PR' bullets) into a single rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It avoids explaining concepts Claude already knows (no 'what is Slate' or 'what is gh' padding) but repeats key rules multiple times (the 95%+ confidence condition appears across Intake, Execution, and Comment Body; the no-PR rule is restated), so it is mostly efficient but could be tightened; not score 3 because not every token earns its place. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands ('gh issue view <number-or-url> -R udecode/slate --json ...', 'bun --filter slate-react typecheck', 'PLAYWRIGHT_BASE_URL=http://localhost:3100 bun playwright <test-file> --project=chromium --grep "<issue row>"') plus a concrete fill-in comment template; not score 2 because the guidance is complete and executable rather than pseudocode. | 3 / 3 |
Workflow Clarity | Sequences a clear multi-step process (Intake -> Current-State Check -> Execution -> Verification -> Comment Body -> Final Handoff) with a four-state classification table, explicit verification checkpoints, a confidence gate, and a feedback loop ('If bun check fails... isolate the failure and record why'); not score 2 because validation checkpoints are explicit and present for the outward-facing commenting/closing actions. | 3 / 3 |
Progressive Disclosure | Well-organized into clear section headers but it is a single monolithic file with no reference bundles (references/, scripts/, assets/ absent), and detail such as the full comment template and verification gate commands is inline rather than split out; not score 3 because it is neither under 50 lines nor does it use one-level-deep reference files, and not score 1 because the internal structure is good rather than a wall of text. | 2 / 3 |
Total | 10 / 12 Passed |