Content
75%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 delivers a strong, executable worktree workflow with concrete git commands, dependency auto-detection, and an explicit verification checklist. Its main weakness is padding — an anti-rationalization table, an orchestrator diagram, and basic worktree-concept explanations that assume Claude needs convincing or education rather than instruction.
Suggestions
Delete the Anti-Rationalization table — it argues against hypothetical excuses rather than instructing, adding ~8 lines of non-operational content.
Compress Step 4 and the @orchestrator ASCII diagram to operational facts only (e.g., 'commits land on worktree/$ARGUMENTS'); Claude already knows worktrees are isolated repo copies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The command blocks are tight, but several sections pad or over-explain: the Anti-Rationalization table ('"I'll remember what I was working on" | "You won't."'), the @orchestrator ASCII diagram, and Step 4's explanation that 'The worktree is a full copy of the repo. Changes here do NOT affect the main worktree' — a concept Claude already knows. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 2 because the core workflow, commands, and rules are lean and operational. | 3 / 5 |
Actionability | Guidance is fully executable and copy-paste ready, covering all common cases: 'git worktree add .claude/worktrees/$ARGUMENTS -b worktree/$ARGUMENTS', a complete dependency auto-detect if/elif block (npm ci / yarn / pnpm / bun), and merge ('git merge worktree/$ARGUMENTS'), PR ('gh pr create'), discard, list, and prune variants. The only placeholders ($ARGUMENTS, /path/to/main/repo) are inherently context-dependent substitutions, not gaps. | 5 / 5 |
Workflow Clarity | The 5-step workflow (select directory → create → setup → work → merge/discard) is clearly sequenced with an explicit Verification Protocol checklist ('git worktree list shows the new worktree', 'Tests pass in the worktree'), satisfying the destructive/batch validation requirement. It falls short of anchor 5 only because there is no error-recovery feedback loop — nothing instructs what to do when a verification check fails — matching 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The body is a well-organized single file with clear sections (When to Use, Workflow, Worktree Management, Verification Protocol, Rules) and no nested or buried references. At ~155 lines it exceeds the under-50-line simple-skill exception that would allow a 5, and marginal content like the orchestrator integration keeps it at 'good structure; most content is appropriately placed; minor organization gaps' rather than an optimally split overview. | 4 / 5 |
Total | 16 / 20 Passed |