Content
92%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 disciplined, dense instruction-only skill: every rule is a decision rule, the workflow has a genuine human validation gate before publishing, and detail is deliberately deferred to its one home instead of restated. The only meaningful gap is the absence of a worked example (a full gh command or sample ticket body) for the publish step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every rule is a distinct decision rule and each line earns its place; rationale appears only where it counteracts instinct ("an agent asked to size itself has every incentive to answer 'the strongest one'"). It assumes competence — no space is spent explaining what a PRD, ticket, or DAG is. Not 4: there is no padding to trim. | 5 / 5 |
Actionability | Concrete, executable guidance throughout — "gh issue create", "Part of #<prd>", "Blocked by: #N", "Tier: <tier>", "ready-for-agent", "sh scripts/agents.lib.sh <tier>" — with specific quiz-step content. Not 5: the publish step lacks a full gh invocation with flags, and no example ticket body is shown, leaving minor gaps for the most fragile step. | 4 / 5 |
Workflow Clarity | A five-step procedure with an explicit, mandatory validation checkpoint before the batch publish operation ("Do not publish until they confirm") that specifies exactly what to present (DAG, labels, tier mix) and what to ask the user to challenge. The trust-boundary stop-and-surface rule adds an error-recovery path, so the batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with clean, well-labeled sections, and it defers the tier rubric to its single home with a clearly signaled path and section title ("constitution/local-workflow.md, 'Capability tiers — the cost/benefit call'") rather than duplicating it — exactly the one-level-deep disclosure the rubric rewards. No bundle files exist to verify, but the structure and signaling stand on their own. | 5 / 5 |
Total | 19 / 20 Passed |