Content
82%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 strong, executable operational guide: project-specific conventions are captured concisely with copy-paste-ready commands, decision tables, and gated cleanup steps for every common scenario. The only soft spots are the absence of error-recovery loops and the entirely prose hotfix/promotion pipeline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific conventions Claude could not know (branch naming, insiders channel, .squad union-merge rules) and avoids explaining git basics. Minor trimmable padding exists ("No filesystem collisions, no branch-switching overhead", the explanatory framing around the .squad section), so it sits at 'Efficient; minor instances of over-explanation' rather than the 'every token earns its place' level of 5. | 4 / 5 |
Actionability | Every common case — single-issue workflow, parallel worktrees, multi-repo coordination, cleanup — has complete, copy-paste-ready command sequences with real example values (squad/195-fix-version-stamp-bug, gh pr create --base dev --draft, git worktree add ../squad-195 -b ... origin/dev). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The issue workflow is a clear 6-step numbered sequence, worktree setup/cleanup is explicitly gated on PR merge, and there are real checkpoints (inspect staged diff before committing, verify cross-repo changes via npm link before pushing). It falls short of 5 because there are no error-recovery feedback loops (e.g., what to do on a failed union merge or red build) and the hotfix path ('cherry-pick to main if urgent') is stated without steps. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content is inline in a single well-organized ~200-line file with clear section headers, decision tables (branch model, worktree-vs-sequential), and an anti-patterns summary — matching 'Good structure; most content is appropriately placed'. Not 5 because at this length the multi-repo scenarios (~50 lines) could plausibly live in a separate reference, and the under-50-line simple-skill exception does not apply. | 4 / 5 |
Total | 17 / 20 Passed |