docs(agents): regenerate all AGENTS.md files with comprehensive codebase analysis

- Regenerated root AGENTS.md with overview, structure, and complexity hotspots
- Regenerated all 7 subdirectory AGENTS.md files: hooks, tools, features, agents, cli, auth, shared
- Used 11 background explore agents for comprehensive feature and architecture analysis
- All files within size limits (root: 112 lines, subdirs: 57-68 lines)
- Includes where-to-look guide, conventions, anti-patterns, and agent model information

🤖 Generated with assistance of oh-my-opencode

src/tools/AGENTS.md

@@ -2,33 +2,26 @@
 
 ## OVERVIEW
 
-Custom tools extending agent capabilities: LSP integration (11 tools), AST-aware code search/replace, file operations with timeouts, background task management.
+Custom tools: 11 LSP tools, AST-aware search/replace, file ops with timeouts, background task management, session navigation.
 
 ## STRUCTURE
 
 ```
 tools/
 ├── ast-grep/           # AST-aware code search/replace (25 languages)
-│   ├── cli.ts          # @ast-grep/cli subprocess
-│   ├── napi.ts         # @ast-grep/napi native binding (preferred)
-│   ├── constants.ts, types.ts, tools.ts, utils.ts
+│   ├── napi.ts         # @ast-grep/napi binding (preferred)
+│   └── cli.ts          # @ast-grep/cli fallback
 ├── background-task/    # Async agent task management
 ├── call-omo-agent/     # Spawn explore/librarian agents
-├── glob/               # File pattern matching (timeout-safe)
-├── grep/               # Content search (timeout-safe)
+├── glob/               # File pattern matching (60s timeout)
+├── grep/               # Content search (60s timeout)
 ├── interactive-bash/   # Tmux session management
 ├── look-at/            # Multimodal analysis (PDF, images)
-├── lsp/                # 11 LSP tools
+├── lsp/                # 11 LSP tools (611 lines client.ts)
 │   ├── client.ts       # LSP connection lifecycle
 │   ├── config.ts       # Server configurations
-│   ├── tools.ts        # Tool implementations
-│   └── types.ts
-├── session-manager/    # OpenCode session file management
-│   ├── constants.ts    # Storage paths, descriptions
-│   ├── types.ts        # Session data interfaces
-│   ├── storage.ts      # File I/O operations
-│   ├── utils.ts        # Formatting, filtering
 │   └── tools.ts        # Tool implementations
+├── session-manager/    # OpenCode session file ops
 ├── skill/              # Skill loading and execution
 ├── skill-mcp/          # Skill-embedded MCP invocation
 ├── slashcommand/       # Slash command execution
@@ -37,47 +30,39 @@ tools/
 
 ## TOOL CATEGORIES
 
-| Category | Tools | Purpose |
-|----------|-------|---------|
-| LSP | lsp_hover, lsp_goto_definition, lsp_find_references, lsp_document_symbols, lsp_workspace_symbols, lsp_diagnostics, lsp_servers, lsp_prepare_rename, lsp_rename, lsp_code_actions, lsp_code_action_resolve | IDE-like code intelligence |
-| AST | ast_grep_search, ast_grep_replace | Pattern-based code search/replace |
-| File Search | grep, glob | Content and file pattern matching |
-| Session | session_list, session_read, session_search, session_info | OpenCode session file management |
-| Background | background_task, background_output, background_cancel | Async agent orchestration |
-| Multimodal | look_at | PDF/image analysis via Gemini |
-| Terminal | interactive_bash | Tmux session control |
-| Commands | slashcommand | Execute slash commands |
-| Skills | skill, skill_mcp | Load skills, invoke skill-embedded MCPs |
-| Agents | call_omo_agent | Spawn explore/librarian |
+| Category | Tools |
+|----------|-------|
+| LSP | lsp_hover, lsp_goto_definition, lsp_find_references, lsp_document_symbols, lsp_workspace_symbols, lsp_diagnostics, lsp_servers, lsp_prepare_rename, lsp_rename, lsp_code_actions, lsp_code_action_resolve |
+| AST | ast_grep_search, ast_grep_replace |
+| File Search | grep, glob |
+| Session | session_list, session_read, session_search, session_info |
+| Background | background_task, background_output, background_cancel |
+| Multimodal | look_at |
+| Terminal | interactive_bash |
+| Skills | skill, skill_mcp |
+| Agents | call_omo_agent |
 
-## HOW TO ADD A TOOL
+## HOW TO ADD
 
-1. Create directory: `src/tools/my-tool/`
-2. Create files:
-   - `constants.ts`: `TOOL_NAME`, `TOOL_DESCRIPTION`
-   - `types.ts`: Parameter/result interfaces
-   - `tools.ts`: Tool implementation (returns OpenCode tool object)
-   - `index.ts`: Barrel export
-   - `utils.ts`: Helpers (optional)
+1. Create `src/tools/my-tool/`
+2. Files: `constants.ts`, `types.ts`, `tools.ts`, `index.ts`
 3. Add to `builtinTools` in `src/tools/index.ts`
 
 ## LSP SPECIFICS
 
-- **Client lifecycle**: Lazy init on first use, auto-shutdown on idle
-- **Config priority**: opencode.json > oh-my-opencode.json > defaults
-- **Supported servers**: typescript-language-server, pylsp, gopls, rust-analyzer, etc.
-- **Custom servers**: Add via `lsp` config in oh-my-opencode.json
+- Lazy init on first use, auto-shutdown on idle
+- Config priority: opencode.json > oh-my-opencode.json > defaults
+- Servers: typescript-language-server, pylsp, gopls, rust-analyzer
 
 ## AST-GREP SPECIFICS
 
-- **Meta-variables**: `$VAR` (single node), `$$$` (multiple nodes)
-- **Languages**: 25 supported (typescript, tsx, python, rust, go, etc.)
-- **Binding**: Prefers @ast-grep/napi (native), falls back to @ast-grep/cli
-- **Pattern must be valid AST**: `export async function $NAME($$$) { $$$ }` not fragments
+- Meta-variables: `$VAR` (single), `$$$` (multiple)
+- Pattern must be valid AST node, not fragment
+- Prefers napi binding for performance
 
-## ANTI-PATTERNS (TOOLS)
+## ANTI-PATTERNS
 
-- **No timeout**: Always use timeout for file operations (default 60s)
-- **Blocking main thread**: Use async/await, never sync file ops
-- **Ignoring LSP errors**: Gracefully handle server not found/crashed
-- **Raw subprocess for ast-grep**: Prefer napi binding for performance
+- No timeout on file ops (always use, default 60s)
+- Sync file operations (use async/await)
+- Ignoring LSP errors (graceful handling required)
+- Raw subprocess for ast-grep (prefer napi)