Content
61%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 strongly structured, largely actionable workflow for invention decomposition with concrete tables, templates, and a reviewer validation step. Its main weaknesses are the dense, redundant reviewer-routing boilerplate at the top and a defined but unused refinement loop, which leave the validation feedback path implicit.
Suggestions
Replace the opening reviewer-routing blockquote with a single line pointing to `../shared-references/reviewer-backends.md`, and drop the duplicated routing caveat in Step 6.
Define the refinement loop that `MAX_REFINEMENT_ROUNDS = 3` implies: when the reviewer flags issues, revise the decomposition/claim plan and re-run validation, stopping after 3 rounds.
Clarify Inputs by marking which of the four inputs are required vs. optional (e.g., PRIOR_ART_REPORT.md and NOVELTY_ASSESSMENT.md appear to be prerequisites for deriving the Technical Problem).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The workflow body (tables, dependency diagram, output template) is efficient, but the opening reviewer-routing blockquote ("resolve invocation → `.aris/reviewer.json` → Claude Code default (Codex MCP) with `reviewer_route.py` through the canonical helper resolver, preserving this slot's tier, fresh contexts, source/image inputs and deterministic gates") is dense boilerplate largely irrelevant to invention structuring, and Step 6 repeats its content. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not severely padded (1-2) but not clean of over-explanation (4). | 3 / 5 |
Actionability | Concrete, near-executable guidance throughout: the copy-paste-ready `mcp__codex__codex` call with model and reasoning-effort config, category/drawing tables, the claim-hierarchy ASCII template, and a full output markdown template. It falls short of fully-executable (5) due to placeholders like "[Problem-Solution-Advantage summary]", the undefined consumption of `MAX_REFINEMENT_ROUNDS`, and ambiguity about which reviewer backend/contract actually applies after the routing caveat — minor gaps consistent with anchor 4. | 4 / 5 |
Workflow Clarity | The seven steps are clearly sequenced and Step 6 provides an explicit validation checkpoint, but the feedback loop is missing: `MAX_REFINEMENT_ROUNDS = 3` is defined yet the workflow never says what to do when the reviewer finds problems (revise decomposition? re-validate? when to stop?). The sequence-present-but-checkpoints-implicit gap fits anchor 3 better than anchor 4, whose 'most checkpoints present' standard the absent refine-and-revalidate loop undermines. | 3 / 5 |
Progressive Disclosure | Structure is good: well-organized sections with two clearly signaled, one-level-deep references ("Load `../shared-references/patent-writing-principles.md`" in a dedicated Shared References section). Not anchor 5 because the reviewer-routing protocol is inlined in a blockquote instead of being pushed to `reviewer-backends.md`, and the cross-bundle `../shared-references/` paths could not be verified to exist in the skill's environment. Still clearly above anchor 3's 'references present but not clearly signaled'. | 4 / 5 |
Total | 14 / 20 Passed |