Content
17%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 content is a verbose capability catalog that restates Flutter/Dart knowledge Claude already has, with no executable guidance, a generic high-level workflow, and a broken single reference. It needs concrete code, tightened prose, and real progressive-disclosure structure.
Suggestions
Add concrete, copy-paste-ready code examples for the common cases (e.g. a Riverpod provider, a platform channel, a widget test) instead of only listing capabilities.
Move the large capability/architecture/platform catalogs into separate reference files under references/ and link to them one level deep, fixing the dangling `resources/implementation-playbook.md` path.
Replace the generic Instructions and high-level Response Approach with a concrete, sequenced workflow with explicit validation checkpoints (e.g. analyze -> implement -> run flutter test -> profile in DevTools).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~190-line body is a padded catalog of capabilities, behavioral traits, and knowledge topics (e.g. 'Null safety mastery', 'Widget composition patterns') that Claude already knows, with several sections restating familiar Flutter/Dart concepts. | 2 / 5 |
Actionability | There is no executable code or concrete commands anywhere; the body only describes capabilities ('Impeller rendering engine optimization', 'Widget rebuilds minimization with const constructors') and the Instructions are generic ('Apply relevant best practices and validate outcomes'), with the single reference path being broken. | 1 / 5 |
Workflow Clarity | The 'Response Approach' section lists an 8-step rough sequence, but the steps are high-level and abstract ('Analyze requirements for optimal Flutter architecture') with many gaps and no validation checkpoints. | 2 / 5 |
Progressive Disclosure | Nearly all content is inlined in one monolithic file — the large capability catalogs clearly belong in separate reference files — and the only reference (`resources/implementation-playbook.md`) does not exist, making it a dangling, broken pointer. | 2 / 5 |
Total | 7 / 20 Passed |