feat: add Brave Search integration for researchers

- Add `websearch` command to gsd-tools.js for Brave API
- Detect BRAVE_API_KEY env var or ~/.gsd/brave_api_key file
- Persist brave_search setting to config.json on project init
- Update researcher agents to check config before calling

Graceful degradation: if brave_search is false, agents use
built-in WebSearch without wasted Bash calls.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

agents/gsd-phase-researcher.md

@@ -97,6 +97,22 @@ When researching "best library for X": find what the ecosystem actually uses, do
 
 **WebSearch tips:** Always include current year. Use multiple query variations. Cross-verify with authoritative sources.
 
+## Enhanced Web Search (Brave API)
+
+Check `brave_search` from init context. If `true`, use Brave Search for higher quality results:
+
+```bash
+node ~/.claude/get-shit-done/bin/gsd-tools.js websearch "your query" --limit 10
+```
+
+**Options:**
+- `--limit N` — Number of results (default: 10)
+- `--freshness day|week|month` — Restrict to recent content
+
+If `brave_search: false` (or not set), use built-in WebSearch tool instead.
+
+Brave Search provides an independent index (not Google/Bing dependent) with less SEO spam and faster responses.
+
 ## Verification Protocol
 
 **WebSearch findings MUST be verified:**

agents/gsd-project-researcher.md

@@ -91,6 +91,22 @@ Problems:  "[tech] common mistakes", "[tech] gotchas"
 
 Always include current year. Use multiple query variations. Mark WebSearch-only findings as LOW confidence.
 
+### Enhanced Web Search (Brave API)
+
+Check `brave_search` from orchestrator context. If `true`, use Brave Search for higher quality results:
+
+```bash
+node ~/.claude/get-shit-done/bin/gsd-tools.js websearch "your query" --limit 10
+```
+
+**Options:**
+- `--limit N` — Number of results (default: 10)
+- `--freshness day|week|month` — Restrict to recent content
+
+If `brave_search: false` (or not set), use built-in WebSearch tool instead.
+
+Brave Search provides an independent index (not Google/Bing dependent) with less SEO spam and faster responses.
+
 ## Verification Protocol
 
 **WebSearch findings must be verified:**