YeonGyu-Kim
a1fe0f8517
- 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
2.2 KiB
2.2 KiB
SHARED UTILITIES KNOWLEDGE BASE
OVERVIEW
Cross-cutting utilities: path resolution, config management, text processing, Claude Code compatibility helpers.
STRUCTURE
shared/
├── 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 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
├── snake-case.ts # Case conversion
└── tool-name.ts # PascalCase normalization
WHEN TO USE
| 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
const output = dynamicTruncate(result, remainingTokens, 0.5)
// Deep merge priority
const final = deepMerge(deepMerge(defaults, userConfig), projectConfig)
// Safe JSONC
const { config, error } = parseJsoncSafe(content)
ANTI-PATTERNS
- 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)