Content
78%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 well-structured, actionable, and uses progressive disclosure effectively with a clear reference-loading table and verified one-level-deep references. Main improvements are removing the repeated generic note and the source-policy duplication, and adding an output-validation feedback loop.
Suggestions
State the generic reference/template note once (e.g. in Instructions) and reference it from the workflow steps instead of repeating it three times.
Trim the duplicated source-root/revision detail in 'Live HSB IP Source Policy' by deferring to references/source-policy.md, keeping only the decision rule inline.
Add an explicit output-validation step (e.g. re-check emitted signal groups against the active defs macros and live HOLOLINK_top port map) with a fix-and-retry loop after scaffold generation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and assumes Claude's competence (no basic SystemVerilog concept padding), but the generic reference/template note is restated three times and the source-policy detail duplicates content in references/source-policy.md, which are minor instances that could be trimmed. | 4 / 5 |
Actionability | Concrete decision tree (Workflow Decision), per-workflow numbered steps, a Reference Loading table, and three fully-walked examples give mostly executable guidance; the executable signal-shape code is appropriately delegated to references/fixed-format.md rather than inlined. | 4 / 5 |
Workflow Clarity | Standalone, Handoff, and Explain workflows are clearly sequenced with input-validation checkpoints ('stop before generation', 'do not proceed from an unvalidated defs file') and a Troubleshooting section, but there is no explicit output validation or fix-and-retry feedback loop after scaffold generation. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with a Reference Loading table that signals each one-level-deep reference (fixed-format.md, source-policy.md, handoff-contract.md) and its trigger; all referenced files exist and content is appropriately split out. | 5 / 5 |
Total | 17 / 20 Passed |