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/shared/AGENTS.md

@@ -2,81 +2,62 @@
 
 ## OVERVIEW
 
-Cross-cutting utility functions used across agents, hooks, tools, and features. Path resolution, config management, text processing, and Claude Code compatibility helpers.
+Cross-cutting utilities: path resolution, config management, text processing, Claude Code compatibility helpers.
 
 ## STRUCTURE
 
 ```
 shared/
-├── index.ts              # Barrel export (import { x } from "../shared")
-├── claude-config-dir.ts  # Resolve ~/.claude directory
-├── command-executor.ts   # Shell command execution with variable expansion
-├── config-errors.ts      # Global config error tracking
-├── config-path.ts        # User/project config path resolution
-├── data-path.ts          # XDG data directory resolution
-├── deep-merge.ts         # Type-safe recursive object merging
-├── dynamic-truncator.ts  # Token-aware output truncation
-├── file-reference-resolver.ts  # @filename syntax resolution
-├── file-utils.ts         # Symlink resolution, markdown detection
+├── index.ts              # Barrel export
+├── claude-config-dir.ts  # ~/.claude resolution
+├── command-executor.ts   # Shell exec with variable expansion
+├── config-errors.ts      # Global error tracking
+├── config-path.ts        # User/project config paths
+├── data-path.ts          # XDG data directory
+├── deep-merge.ts         # Type-safe recursive merge
+├── dynamic-truncator.ts  # Token-aware truncation
+├── file-reference-resolver.ts  # @filename syntax
+├── file-utils.ts         # Symlink, markdown detection
 ├── frontmatter.ts        # YAML frontmatter parsing
-├── hook-disabled.ts      # Check if hook is disabled in config
-├── jsonc-parser.ts       # JSON with Comments parsing
-├── logger.ts             # File-based logging to OS temp
-├── migration.ts          # Legacy name compatibility (omo -> Sisyphus)
+├── hook-disabled.ts      # Check if hook disabled
+├── jsonc-parser.ts       # JSON with Comments
+├── logger.ts             # File-based logging
+├── migration.ts          # Legacy name compat (omo → Sisyphus)
 ├── model-sanitizer.ts    # Normalize model names
-├── pattern-matcher.ts    # Tool name matching with wildcards
-├── snake-case.ts         # Case conversion for objects
-└── tool-name.ts          # Normalize tool names to PascalCase
+├── pattern-matcher.ts    # Tool name matching
+├── snake-case.ts         # Case conversion
+└── tool-name.ts          # PascalCase normalization
 ```
 
-## UTILITY CATEGORIES
+## WHEN TO USE
 
-| Category | Utilities | Used By |
-|----------|-----------|---------|
-| Path Resolution | `getClaudeConfigDir`, `getUserConfigPath`, `getProjectConfigPath`, `getDataDir` | Features, Hooks |
-| Config Management | `deepMerge`, `parseJsonc`, `isHookDisabled`, `configErrors` | index.ts, CLI |
-| Text Processing | `resolveCommandsInText`, `resolveFileReferencesInText`, `parseFrontmatter` | Commands, Rules |
-| Output Control | `dynamicTruncate` | Tools (Grep, LSP) |
-| Normalization | `transformToolName`, `objectToSnakeCase`, `sanitizeModelName` | Hooks, Agents |
-| Compatibility | `migration.ts` | Config loading |
-
-## WHEN TO USE WHAT
-
-| Task | Utility | Notes |
-|------|---------|-------|
-| Find Claude Code configs | `getClaudeConfigDir()` | Never hardcode `~/.claude` |
-| Merge settings (default → user → project) | `deepMerge(base, override)` | Arrays replaced, objects merged |
-| Parse user config files | `parseJsonc()` | Supports comments and trailing commas |
-| Check if hook should run | `isHookDisabled(name, disabledHooks)` | Respects `disabled_hooks` config |
-| Truncate large tool output | `dynamicTruncate(text, budget, reserved)` | Token-aware, prevents overflow |
-| Resolve `@file` references | `resolveFileReferencesInText()` | maxDepth=3 prevents infinite loops |
-| Execute shell commands | `resolveCommandsInText()` | Supports `!`\`command\`\` syntax |
-| Handle legacy agent names | `migrateLegacyAgentNames()` | `omo` → `Sisyphus` |
+| Task | Utility |
+|------|---------|
+| Find ~/.claude | `getClaudeConfigDir()` |
+| Merge configs | `deepMerge(base, override)` |
+| Parse user files | `parseJsonc()` |
+| Check hook enabled | `isHookDisabled(name, list)` |
+| Truncate output | `dynamicTruncate(text, budget)` |
+| Resolve @file | `resolveFileReferencesInText()` |
+| Execute shell | `resolveCommandsInText()` |
+| Legacy names | `migrateLegacyAgentNames()` |
 
 ## CRITICAL PATTERNS
 
-### Dynamic Truncation
 ```typescript
-import { dynamicTruncate } from "../shared"
-// Keep 50% headroom, max 50k tokens
+// Dynamic truncation
 const output = dynamicTruncate(result, remainingTokens, 0.5)
-```
 
-### Deep Merge Priority
-```typescript
-const final = deepMerge(defaults, userConfig)
-final = deepMerge(final, projectConfig) // Project wins
-```
+// Deep merge priority
+const final = deepMerge(deepMerge(defaults, userConfig), projectConfig)
 
-### Safe JSONC Parsing
-```typescript
+// Safe JSONC
 const { config, error } = parseJsoncSafe(content)
-if (error) return fallback
 ```
 
-## ANTI-PATTERNS (SHARED)
+## ANTI-PATTERNS
 
-- **Hardcoding paths**: Use `getClaudeConfigDir()`, `getUserConfigPath()`
-- **Manual JSON.parse**: Use `parseJsonc()` for user files (comments allowed)
-- **Ignoring truncation**: Large outputs MUST use `dynamicTruncate`
-- **Direct string concat for configs**: Use `deepMerge` for proper priority
+- Hardcoding paths (use getClaudeConfigDir, getUserConfigPath)
+- JSON.parse for user files (use parseJsonc)
+- Ignoring truncation (large outputs MUST use dynamicTruncate)
+- Direct string concat for configs (use deepMerge)