[danielbushman]

Summary

The maproom-researcher agent already had Grep in its tools frontmatter, but the prompt confined it to a single Phase 3 "safety net" coverage sweep with a hard budget of 3 calls. This PR makes Grep a standard part of the toolbelt while keeping maproom the primary search tool — the agent's reason for existing.

Changes (all in plugins/maproom/agents/maproom-researcher.md)

• Critical Rule 5 rewritten: maproom is primary; Grep is standard for exact-match work (literal strings, known identifiers, regexes, comments/TODOs) in any phase.
• Phase 1 now says to go straight to Grep for pure exact-match sub-questions instead of spending a maproom search on them.
• Performance Budget: Grep raised from target 0-3 / max 3 to target 0-4 / max 6, with a note that Grep is not counted by the search-cap hook.
• Empty-search-results error handling updated to fall back to Grep directly.
• Changelog entry added; agent version bumped 1.0.0 → 1.1.0.

No hook changes: enforce-search-cap.py only counts maproom search/vector-search Bash calls, so Grep was never hook-limited.

Verification

• bash plugins/maproom/scripts/verify-docs.sh (what the verify-maproom-docs workflow runs): 11/11 checks pass.
• Hook untouched; its test suite couldn't run locally (no pytest in this container) but is unaffected by a markdown-only change.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 148b15b6-5534-4168-95c2-3e2cd2ff018e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch maproom-researcher-grep-toolbelt

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[danielbushman]

Decided against this change.