Content
75%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 a lean, executable workflow: every CLI call is concrete with flags, JSON output fields are enumerated, branching logic covers all status outcomes, and guardrails enforce one-artifact-per-invocation discipline. The only notable weaknesses are mild duplication of the context/rules guidance, a verification step that lives in guardrails rather than the step flow, and schema-specific patterns inlined that could be a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence: it jumps straight into commands and JSON fields with no concept explanations or padding ('Run `openspec list --json` to get available changes sorted by most recently modified'). Minor repetition could be trimmed — the context/rules-as-constraints point appears both in the field list ('constraints for you - do NOT include in output') and again as a bolded Guardrails item, and 'STOP after creating ONE artifact' duplicates 'Create ONE artifact per invocation'. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands with flags are given (`openspec list --json`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) plus an enumerated list of parsed JSON fields and concrete selection-display criteria. It falls short of the fully-executable anchor only because the artifact-writing step is delegated to runtime CLI output ('Use `template` as the structure - fill in its sections') with no sample artifact content — a justified flexibility, but still a gap versus specific examples covering common cases. | 4 / 5 |
Workflow Clarity | Steps 1-4 are clearly numbered and sequenced with explicit branching on status ('If all artifacts are complete', 'If artifacts are ready to create', 'If no artifacts are ready (all blocked)') and an explicit STOP after one artifact. A verification checkpoint exists ('Verify the artifact file exists after writing before marking progress'), but it sits in the Guardrails section rather than the step sequence and has no retry/fix loop, fitting 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The single-file body is well organized with clear sections (**Input**, **Steps**, **Output**, **Artifact Creation Guidelines**, **Guardrails**) and horizontal rules separating status branches; no bundle files exist and none are referenced. Minor organization gap: the schema-specific artifact patterns (spec-driven and tdd walkthroughs) are inline reference-style content that could live in a separate file, keeping it at 'good structure; most content appropriately placed' rather than the fully-split 5 anchor. | 4 / 5 |
Total | 16 / 20 Passed |