Content
62%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 presents a well-sequenced, checkpoint-rich workflow with concrete MCP tool names, ordered mutations, and real reference/asset files for deferred detail. Its main weaknesses are the duplicated cache/confirmation/devil's-advocate policies (tokens spent restating the same rule) and the core classification-to-drafting path depending on five agent-mode files that are missing from the bundle.
Suggestions
Ship the five referenced 'agents/*.agent.md' files in the bundle, or replace the routing table in Step 1 with inline drafting guidance backed by the existing fallback templates, so the primary workflow resolves.
State each policy once: consolidate the label/assignee cache rules currently split between 'Required inputs' and Step 6's 'Shared gate cache policy' into Step 6 only, and keep the devil's-advocate escalation triggers in one place (Step 1) instead of repeating them in 'Agent modes'.
Trim the confirmation rules that appear in 'When not to use', Step 5, 'Core behavior to preserve', and 'Safety & constraints' down to Step 5 plus a single 'Safety & constraints' entry to reduce redundant tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no concept over-explanation), but states key policies twice: label/assignee caching appears in 'Required inputs' ('Cache full label set per repo for session; filter locally', 'Reuse cached assignee-candidate results') and again nearly in full in Step 6 ('fetch the repository label set once and cache it for the active session'), and the devil's-advocate escalation conditions are repeated almost verbatim in both the Agent modes section and Step 1 ('when scope/criteria gaps are significant, or when invoked from fusion-issue-task-planning with two or more architecture-ambiguity signals'). This fits 'mostly efficient but could be tightened'; not 2 because nothing is padded or explains known concepts, not 4 because the duplication exceeds minor trimming. | 3 / 5 |
Actionability | Guidance is largely executable — exact MCP tool names ('mcp_github::issue_write', 'mcp_github::search_issues'), an ordered mutation list, concrete defaults ('.tmp/{TYPE}-{CONTEXT}.md') and real fallback template paths ('assets/issue-templates/bug.md.hbs') — but the central drafting step routes to five files absent from the bundle ('Bug -> agents/bug.agent.md', 'agents/feature.agent.md', 'agents/user-story.agent.md', 'agents/task.agent.md', 'agents/devils-advocate.agent.md'), leaving the type-specific drafting logic missing. This matches 'some concrete guidance but incomplete'; not 4 because a missing primary routing target is more than a minor gap. | 3 / 5 |
Workflow Clarity | Eight explicitly numbered steps sequence classification → routing → duplicate check → draft → confirmation → shared gates → ordered mutation → relationship validation, with explicit checkpoints ('Ask explicit publish confirmation before mutation', 'Never publish/update in the same pass as first draft unless user explicitly confirms') and feedback loops for error recovery ('explain the failure clearly... retry after user confirms setup is complete'; 'Keep draft artifacts and return a safe retry plan instead of looping retries'). This matches the top anchor of clear sequence + explicit validation + recovery loops; not 4 because checkpoints are explicit throughout rather than mostly present. | 5 / 5 |
Progressive Disclosure | The body appropriately defers detail to real one-level-deep files ('Use detailed behavior and payload examples in references/instructions.md and references/mcp-server.md', plus assets that all exist in the bundle), but its most prominent routing references — 'agents/bug.agent.md', 'agents/feature.agent.md', 'agents/user-story.agent.md', 'agents/task.agent.md', 'agents/devils-advocate.agent.md' — do not exist in the bundle, breaking navigation from the overview to the primary drafting content. Existing references are clearly signaled, but broken core references are more than the 'minor organization gaps' of the level-4 anchor, so this sits at 3. | 3 / 5 |
Total | 14 / 20 Passed |