Content
81%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 tightly written, highly actionable workflow with an explicit step sequence, hard validation gates, and feedback loops for ratification and design deltas. The main gaps are minor redundancy in the anti-patterns and reliance on external templates that are referenced but not included in any bundle.
Suggestions
De-duplicate the anti-patterns and the 'NO redactes spec sin story brief' warnings to tighten conciseness toward a fully lean body.
Bundle the referenced templates (01-spec-template.md, story-ui/agentic/service.yaml) under references/ and link to them so the grader examples and schemas live in one discoverable place.
Add a short 'verify before hand-off' checklist in Step 7 confirming scenario coverage + ratification state, making the validation gates uniform across the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and command-style, assuming Claude knows Gherkin/specs without explaining them; every section earns its place, though the anti-patterns and a few repeated warnings (e.g. 'NO redactes spec sin story brief' restated) could be trimmed, so it sits above the midpoint but not fully lean. | 4 / 5 |
Actionability | Provides concrete bash commands (cat/ls), copy-ready grader YAML blocks per story type, trial_policy, and exact output-format strings; the only gap is that the underlying templates (01-spec-template.md, story-*.yaml) are referenced rather than inlined, leaving minor detail to external files. | 4 / 5 |
Workflow Clarity | An explicit 8-step sequence with hard validation gates ("Si 00-story.md no existe → escala /pm", "Si falta UNO → /po rechaza spec, no procede") and genuine feedback loops — the Chris ratification loop (Step 6) and the UX delta loop — covering error recovery and re-validation. | 5 / 5 |
Progressive Disclosure | Well-organized into Inputs, Workflow, UX delta loop, Anti-patterns, and Output format with signaled external references (templates, personas, rubrics); no bundle files exist, and the inlined grader YAML examples are appropriately kept as illustrations rather than buried, but overall content density keeps it just short of a fully split, one-level-deep structure. | 4 / 5 |
Total | 17 / 20 Passed |