Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concrete and highly actionable with minimal fluff, but two gaps hold it back: workflows involving destructive cache clearing lack explicit validation checkpoints, and the provided reference bundle is unused — its content is duplicated inline rather than split out and navigated to.
Suggestions
Add an explicit validation checkpoint to the destructive cache-clearing workflow (e.g., 'Confirm Cursor is fully quit before running rm -rf' and 'Verify a fresh re-index begins on restart') to lift workflow_clarity to 3.
Reference the bundle files from the body instead of duplicating their content — e.g., replace the inlined .cursorignore block with 'See [references/.cursorignore-configuration.md] for full patterns' and point troubleshooting detail to [references/common-indexing-issues.md] and [references/errors.md].
De-duplicate the .cursorignore patterns and the stuck-indexing / empty-search fixes that currently appear in both the body and the reference files so each topic lives in one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and action-oriented — mostly tables, commands, and config snippets — and does not explain concepts Claude already knows; it assumes competence throughout. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready guidance: `rm -rf` cache paths, `Cmd+Shift+P > Cursor: Resync Index`, sysctl commands, settings.json snippets, and complete .cursorignore/.cursorindexingignore examples. | 3 / 3 |
Workflow Clarity | Steps are sequenced (Step 1/2/3, Check 1-4) but lack explicit validation checkpoints, and the destructive `rm -rf` cache-clearing step has no verify-before/after checkpoint — capping at 2 per the destructive-operations guideline. | 2 / 3 |
Progressive Disclosure | Five bundle reference files exist (common-indexing-issues.md, errors.md, examples.md, index-verification.md, .cursorignore-configuration.md) but none are linked or signaled from the body, and their content is duplicated inline — matching the 'references present but not clearly signaled; content that should be separate is inline' anchor. | 2 / 3 |
Total | 10 / 12 Passed |