search-first

# Search First ## Trigger Use this skill before you: - Add a new feature or workflow step - Introduce a new dependency, MCP server, or CLI integration - Write a new utility/helper that might already exist - Copy patterns from another repo (porting) ## Outcome Pick one of: **Adopt**, **Extend**, **Compose**, **Build**, with a short justification and evidence. ## Workflow (Fast) 1. **Define the need** - What is the smallest outcome that solves the problem? - Constraints: platform (macOS/Linux/Windows), clients (codex/claude/gemini/opencode), offline needs, security posture. 2. **Search locally (before the internet)** - CRG (if codemap installed): `semantic_search_nodes(query="<keyword>")` then `query_graph(pattern="callers_of"|"callees_of"|"tests_for", target="<name>")` — returns structural context that text search cannot provide - Code: `rg -n "<keyword>"` in the repo (fallback when CRG doesn't cover what you need) - Scripts: check `scripts/` for existing lifecycle/doctor commands. - Docs: check `README*` and `docs/`. 3. **Search existing skills** - Repo-local: `.codex/skills`, `.claude/skills`, `.agents/skills`. - Global: `~/.codex/skills`, `~/.claude/skills`, `~/.gemini/skills`, `~/.config/opencode/skills`. - Prefer reusing an existing skill name over creating a near-duplicate. 4. **Search the ecosystem (when needed)** - Prefer official docs and primary sources (project docs, RFCs, standards). - Prefer maintained, well-scoped libraries ...