docs: add default Claude file

Author: ghiscoding

CLAUDE.md

@@ -0,0 +1,31 @@
+### Bash commands
+
+Prefer these over defaults when available. Fall back silently if missing.
+
+- **Search content:** `rg` over `grep`
+- **Find files:** `fd` over `find`
+- **Never** use `find -exec` or `xargs` chains when `fd -x` or `rg -l | xargs` would be clearer. Prefer readable pipelines.
+- **Structural/AST search:** `ast-grep` (`sg`) for refactors and pattern-based code search, especially in TS/TSX
+- **JSON:** `jq` for any parsing, filtering, or transformation in pipelines
+- **YAML/TOML:** `yq`
+- **GitHub operations:** `gh` for PRs, issues, reviews, CI status, and releases. Do not scrape github.com or hit the REST API directly when `gh` can do it.
+- **Benchmarking:** `hyperfine` when comparing command performance
+- **Circular deps (JS/TS):** `madge --circular`
+- **Dead code (JS/TS):** `knip`
+- **Duplication (JS/TS):** `jscpd`
+- **Typecheck only:** `tsc --noEmit` (or `tsc -b --noEmit` in monorepos)### Bash commands
+
+Prefer these over defaults when available. Fall back silently if missing.
+
+- **Search content:** `rg` over `grep`
+- **Find files:** `fd` over `find`
+- **Never** use `find -exec` or `xargs` chains when `fd -x` or `rg -l | xargs` would be clearer. Prefer readable pipelines.
+- **Structural/AST search:** `ast-grep` (`sg`) for refactors and pattern-based code search, especially in TS/TSX
+- **JSON:** `jq` for any parsing, filtering, or transformation in pipelines
+- **YAML/TOML:** `yq`
+- **GitHub operations:** `gh` for PRs, issues, reviews, CI status, and releases. Do not scrape github.com or hit the REST API directly when `gh` can do it.
+- **Benchmarking:** `hyperfine` when comparing command performance
+- **Circular deps (JS/TS):** `madge --circular`
+- **Dead code (JS/TS):** `knip`
+- **Duplication (JS/TS):** `jscpd`
+- **Typecheck only:** `tsc --noEmit` (or `tsc -b --noEmit` in monorepos)