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.
The body is an executable, well-sequenced procedure: concrete commands, enumerated outcomes, explicit validation checkpoints, feedback loops with retry ceilings, and hard boundary restatements. It is lean with only minor duplication, and its doctrine delegation to named one-level-deep files is sensible; the main improvement would be light trimming of repeated boundaries and slightly less dense §-cross-referencing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense procedural prose with zero explanations of concepts Claude already knows, but boundaries are stated twice ("Never prompt the operator; never answer an approval gate" in §0 and again in Boundaries; queue read-only in §6 and Boundaries) and "the moai MCP broker tools were removed in card t1908" is time-sensitive detail — minor trimming opportunities matching the efficient-with-minor-overreach anchor. Not 5: the duplication means not every token earns its place. | 4 / 5 |
Actionability | Copy-paste-ready commands throughout — "moai factory renew <card-id> --json", "git rev-parse --short HEAD", "moai integration status", "moai decision read --scope card:<id>" — with enumerated outcomes ("renewed, refused-expired, refused-not-holder, or error"), explicit ceilings ("retry at most 3 times", "do not wait a third time"), and a literal decision-record line template; every classified cause has a concrete remedy. Not 4: the few unspecified artifacts (e.g. the "session-handoff resume message") are deliberately delegated to named doctrine files rather than left vague. | 5 / 5 |
Workflow Clarity | The pass is explicitly ordered (§0a renew → §1 measure → §2 classify → §3 remedy → §5 record → §7 output) with validation checkpoints on every branch: the all-three-channels-unchanged-plus-N-minutes stall test, fail-open first observation, transient-vs-determinate adjudication with a retry ceiling, and the two-consecutive-wakes delegate escalation; "Every iteration ends in exactly one of" three terminal states. Not 4: checkpoints are explicit, not implicit; the destructive/batch cap does not apply since the skill is queue-readonly and writes only its own snapshot and records. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), so the full ~220-line procedure lives inline, delegating semantics to clearly-signaled one-level-deep external files (".claude/rules/moai/workflow/auto-semantics.md", factory-dispatch.md, cross-session-messaging.md) with each file's role stated — good structure with minor gaps, the 4 anchor. Not 5: navigation leans on dense §-cross-references into the doctrine (§6–7, §11, §14, §5.1) and no actual bundle reference files exist to carry the detail. | 4 / 5 |
Total | 18 / 20 Passed |