Content
75%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 well-structured, actionable orchestration playbook with concrete gradle commands and named Compose APIs. Its main gaps are a small block of generic philosophy padding and the absence of an explicit error-recovery loop and copy-paste code in the verify/orchestrate steps.
Suggestions
Drop the "Philosophy" truisms (e.g., "A screen is just a function of its state") that Claude already knows; keep only team-specific guidance like the journaling rules.
Add an explicit feedback loop to VERIFY: "If lintDebug or testDebugUnitTest fail, fix the reported issues and re-run before proceeding to the PR."
Include a minimal executable snippet (e.g., a type-safe kotlinx.serialization NavKey route or a WindowSizeClass adaptive branch) so the orchestration guidance is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and actionable, but the "Philosophy" bullets ("A screen is just a function of its state", "State hoisting is the bedrock of reusable UI") restate Compose truisms Claude already knows. | 4 / 5 |
Actionability | Concrete commands (./gradlew ktfmtFormat, lintDebug, testDebugUnitTest) and named APIs (WindowSizeClass Compact/Medium/Expanded, 800.dp cap, rememberViewModelStoreNavEntryDecorator, kotlinx.serialization NavKey) give mostly executable guidance, though no copy-paste Compose code snippet is included. | 4 / 5 |
Workflow Clarity | PROFILE → SELECT & PROPOSE (await approval) → ORCHESTRATE → VERIFY → PRESENT is clearly sequenced with gradle-based validation gates, but the VERIFY step lacks an explicit validate→fix→retry feedback loop for failing tests or lint. | 4 / 5 |
Progressive Disclosure | Well-organized into Goal, Constraints, Instructions, and Examples with no nested references and no bundle files to navigate; slightly above the simple-skill line with all content inline, though nothing clearly warrants a separate file. | 4 / 5 |
Total | 16 / 20 Passed |