Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a concise, well-organized set of concrete conventions that respects Claude's intelligence and needs no external references. Its main weaknesses are suggestive rather than directive phrasing in places and implicit rather than explicit error-recovery feedback loops in the workflows.
Suggestions
Convert suggestive guidance ('suggest', 'prefer', 'try using RUST') into firm directives or qualify exactly when the choice is the user's call, to lift actionability.
Add an explicit validate->fix->retry feedback loop for the SQL chunking and TDD workflows (e.g. 'if typecheck fails, fix and re-typecheck before proceeding').
Clarify the contradictory backend guidance ('always ask, never local postgres' vs 'usually Supabase, Neon') with a single decisive rule to remove ambiguity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean bullet directives with no concept-explanation padding (e.g. 'Use ES modules (import/export) syntax', 'Minimize use client'), assuming Claude's competence with every token earning its place. | 3 / 3 |
Actionability | Guidance is specific (e.g. 'const toggle = () =>', '@phosphor-icons/react', 'TailwindCSS v3.x (never v4)') but much is suggestive ('suggest', 'prefer', 'try using RUST') with no complete executable code blocks, fitting the 'some concrete guidance but incomplete' anchor. | 2 / 3 |
Workflow Clarity | The 'Explore -> Plan -> Code -> Commit' process and TDD cycle list steps with checkpoints (typecheck after changes, run tests before commit), but error-recovery feedback loops (validate -> fix -> retry) are implicit rather than explicit. | 2 / 3 |
Progressive Disclosure | A single self-contained conventions file organized into clearly headed sections with no nested external references; per the simple-skills note this is well-organized enough to score 3 without bundle files. | 3 / 3 |
Total | 10 / 12 Passed |