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 dense, command-driven workflow with strong sequencing, validation checkpoints, and error-recovery feedback loops. Minor conciseness trims and slightly richer reference split would lift it further.
Suggestions
Tighten explanatory clauses (e.g., 'so the repo metadata stays clean', repeated worktree-detection rationale in step 2) to earn full conciseness.
Consider splitting the Conventional Commit format details into the existing reference more aggressively so the body stays a pure overview-plus-workflow.
The body re-states the `.stave/workspaces/*` detection logic already in the description; reference it once to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and command-forward, assuming git/gh competence, with a few explanatory clauses ('so the repo metadata stays clean', repeated worktree-detection rationale) that could be trimmed. | 4 / 5 |
Actionability | Provides fully executable commands throughout — `git stash push --include-untracked -m`, `git worktree add -b <branch> ... HEAD`, `git push -u origin <branch>`, `gh pr create --base ... --head ...`, `git worktree remove` — covering the common cases copy-paste ready. | 5 / 5 |
Workflow Clarity | A 9-step clearly sequenced workflow with explicit validation checkpoints (step 4 verify, clean-status confirmation after commit, conflict surfacing) and feedback loops (cleanup retry on cwd-in-worktree, re-validate). | 5 / 5 |
Progressive Disclosure | Well-organized into Workflow and Guardrails sections with one clearly-signaled one-level-deep reference (references/pr-conventions.md in step 7, verified to exist); a single long body with only one external reference leaves minor organization headroom. | 4 / 5 |
Total | 18 / 20 Passed |