Content
42%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 well-sectioned but verbose persona/knowledge dump that mostly restates .NET concepts Claude already knows, with one good code example and a high-level response workflow lacking validation checkpoints. It functions as a role profile more than executable guidance.
Suggestions
Cut the 'Knowledge Base' section and trim the Capabilities catalog to only non-obvious, project-specific conventions; assume Claude knows standard .NET features.
Replace the generic Instructions ('Apply relevant best practices and validate outcomes') with concrete, executable steps or checklists.
Add explicit validation checkpoints to the Response Approach (e.g., 'Verify the build compiles', 'Run tests before declaring done') to create real feedback loops.
Move the detailed capabilities catalog and code-style examples into reference files (e.g., references/capabilities.md, references/code-style.md) and link them one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a long enumeration of capabilities, behavioral traits, and a 'Knowledge Base' section cataloguing well-known facts ('Microsoft .NET documentation', 'xUnit test framework', 'Clean Architecture') that Claude already knows, making it noticeably padded. | 2 / 5 |
Actionability | One genuinely executable C# code-style block provides concrete guidance, but the bulk (Capabilities, Behavioral Traits, Response Approach) is descriptive with high-level steps like 'Design architecture with appropriate patterns' rather than executable instruction. | 3 / 5 |
Workflow Clarity | The 8-step 'Response Approach' gives a clear sequence but lacks explicit validation checkpoints or feedback loops, and the Instructions only abstractly mention 'validate outcomes' and 'verification'. | 3 / 5 |
Progressive Disclosure | Sections are well-organized, but at ~185 lines the capabilities catalog and code-style examples are all inlined in a single file with no references to separate files, and no bundle files exist to split the detail into. | 3 / 5 |
Total | 11 / 20 Passed |