Content
92%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 with executable patterns, an explicit workflow including validation checkpoints and a feedback loop, and a clean reference table linking real bundle files. The only weakness is minor duplication (the runBlocking point appears twice) that slightly dents conciseness.
Suggestions
Remove the duplicated runBlocking guidance: keep it in either the code anti-pattern comment or the MUST NOT list, not both.
Trim the Knowledge Reference line, which restates technologies already named in the description and Reference Guide table, to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with inline one-line comments and no padding over basic Kotlin concepts, but the runBlocking anti-pattern is stated twice (code comment and MUST NOT) and the Knowledge Reference list restates already-named technologies; minor trimming possible. Not a 5 due to this duplication, not a 3 since nothing extensively explains what Claude already knows. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready Kotlin for sealed-class state modeling, a Flow-backed repository with StateFlow, null-safety idioms, and scope functions, plus concrete tooling (detekt, ktlint, runTest, Turbine) and named anti-patterns. | 5 / 5 |
Workflow Clarity | The six-step Core Workflow has an explicit checkpoint ('Verify coroutine cancellation is handled... before proceeding') and a feedback loop ('If detekt/ktlint fails: Fix all reported issues and re-run both tools before proceeding to step 5'). | 5 / 5 |
Progressive Disclosure | The body is an overview pointing to five one-level-deep reference files via a 'Load When' table; all referenced paths (coroutines-flow.md, multiplatform-kmp.md, android-compose.md, ktor-server.md, dsl-idioms.md) exist in ./references/, giving clear, navigable structure. | 5 / 5 |
Total | 19 / 20 Passed |