Content
63%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 well-structured behavioral contract with concrete host mappings, gates, and self-review checkpoints, weakened by duplicated model/effort rules and a bundle that does not contain the DOCTRINE.md, security.md, or skills/<name>/SKILL.md files the body depends on. Instruction-only guidance is otherwise specific and actionable.
Suggestions
State the session-model and reasoning-effort rules once in the Reasoning Policy section and drop the repetitions in the Codex and Grok sections.
Ship DOCTRINE.md, security.md, and the skills/<name>/SKILL.md files referenced by the router table in the bundle, or inline the minimum needed to execute each routed workflow.
Move the per-host adapter detail (Codex and Grok subagent mappings) into reference files (e.g., references/codex.md, references/grok.md) so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense and useful (routing tables, host mappings, a copy-paste fallback template), but the session-model rule ("Every agent runs on the current session model") and the low/medium/high reasoning-effort mapping are each stated two to three times across the Codex, Grok, and Reasoning Policy sections, which is more than minor padding. | 3 / 5 |
Actionability | Concrete, executable behavioral guidance: exact tool names ("multi_agent_v1.spawn_agent", "spawn_subagent"), agent_type mappings, env flags (GROK_AGENT=1, GROK_SUBAGENTS=0), real paths (~/.grok/skills/), and a literal chat-block fallback template. Minor gap: the router defers execution to skills/<name>/SKILL.md workflows, which are not present in the bundle. | 4 / 5 |
Workflow Clarity | The single-agent port has a clear sequenced flow (prefer subagent API → coherent batches → "Self-review each batch before moving on" → "Run a final integration self-review over the cumulative diff") with explicit structural gates and security escalation as checkpoints. Minor gaps: sub-workflows like "amplify → design → decompose" are named but their steps live in the missing skill files. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned with clear one-level headers, but the bundle ships no reference files: the closing pointer to DOCTRINE.md, "the security blocklist in security.md", and the router's skills/<name>/SKILL.md targets are all absent from the directory. Sizable per-host adapter detail (Codex/Grok sections) is also inlined in SKILL.md rather than split out. | 3 / 5 |
Total | 14 / 20 Passed |