Content
61%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 lean and reasonably actionable with good structural organization and clear routing to reference files. Its weak points are missing validation feedback loops for destructive database operations and reference files that are advertised but not actually shipped in the bundle.
Suggestions
Ship the referenced companion files (crud-operations.md, complex-queries.md, pagination.md, aggregation.md, geolocation.md, security-rules.md) or remove the 'Quick routing' links so navigation is not broken.
Add explicit validation checkpoints to destructive/batch workflows (e.g., verify a doc exists and confirm a where-clause match count before .update()/.remove()), with a fix-and-retry feedback loop.
Tighten the 'Best practices' and 'Working rules' sections by merging redundant guidance into the checklist to recover a few tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence, with executable snippets and no padding about basic concepts; only minor over-explanation in the 'Working rules' and 'Best practices' lists could be trimmed. | 4 / 5 |
Actionability | Concrete executable code exists (canonical init, env targeting, basic collection access, doc reference), but the bulk of operational guidance is routed to 'Quick routing' files (crud-operations.md, complex-queries.md, etc.) that are not present in the bundle, leaving real execution gaps. | 3 / 5 |
Workflow Clarity | A 'Minimal checklist' provides a rough sequence, but database delete/update operations are destructive/batch and lack explicit validation checkpoints or feedback loops, which per the rubric caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | Structure is good with clearly signaled one-level-deep references in 'Quick routing' and a concise overview, but the referenced reference files are absent from references/scripts/assets, a minor navigation gap against the actual bundle. | 4 / 5 |
Total | 14 / 20 Passed |