Content
43%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 concise and well-sectioned but its instructions are abstract rather than actionable, the steps are not a sequenced workflow with validation, and progressive disclosure is undermined by a broken reference path that ignores the actual bundle files.
Suggestions
Replace abstract directives with concrete, executable guidance — e.g. specific DI registration snippets, EF Core query patterns, or commands — or at minimum point to the bundled templates in `assets/` and patterns in `references/`.
Turn the Instructions list into a numbered workflow with explicit validation checkpoints (e.g. 'verify data-access performance' with a concrete check).
Fix the reference path: change `resources/implementation-playbook.md` to the real `references/dapper-patterns.md` and `references/ef-core-best-practices.md`, and add navigation entries for `assets/repository-template.cs.template` and `assets/service-template.cs.template`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with tight sectioned lists and no padding about basic .NET concepts; the only minor waste is the opening line repeating the description verbatim and a 'Do not use' section of borderline value. | 4 / 5 |
Actionability | The Instructions are high-level hints ('Define architecture boundaries', 'Apply DI, async patterns, and resilience strategies') with no concrete code, commands, or specific steps to execute, matching the 'minimal concrete guidance; high-level hints' anchor. | 2 / 5 |
Workflow Clarity | The bullets are parallel activities rather than a sequenced workflow — no numbering, no defined sequence, and no validation/verification checkpoints — fitting the 'rough sequence present but many gaps; validation absent' anchor. | 2 / 5 |
Progressive Disclosure | Sections are clearly organized and a one-level-deep reference is signaled, but the body points to `resources/implementation-playbook.md` which does not exist while the real bundle files in `references/` and `assets/` go unreferenced, so navigation is partly broken. | 3 / 5 |
Total | 11 / 20 Passed |