- 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
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# FEATURES KNOWLEDGE BASE
|
|
|
|
## OVERVIEW
|
|
|
|
Claude Code compatibility layer + core feature modules. Commands, skills, agents, MCPs, hooks from Claude Code work seamlessly.
|
|
|
|
## STRUCTURE
|
|
|
|
```
|
|
features/
|
|
├── background-agent/ # Task lifecycle, notifications (460 lines)
|
|
├── builtin-commands/ # Built-in slash commands
|
|
├── builtin-skills/ # Built-in skills (playwright)
|
|
├── claude-code-agent-loader/ # ~/.claude/agents/*.md
|
|
├── claude-code-command-loader/ # ~/.claude/commands/*.md
|
|
├── claude-code-mcp-loader/ # .mcp.json files
|
|
│ └── env-expander.ts # ${VAR} expansion
|
|
├── claude-code-plugin-loader/ # installed_plugins.json (484 lines)
|
|
├── claude-code-session-state/ # Session state persistence
|
|
├── opencode-skill-loader/ # Skills from OpenCode + Claude paths
|
|
├── skill-mcp-manager/ # MCP servers in skill YAML
|
|
└── hook-message-injector/ # Inject messages into conversation
|
|
```
|
|
|
|
## LOADER PRIORITY
|
|
|
|
| Loader | Priority (highest first) |
|
|
|--------|--------------------------|
|
|
| Commands | `.opencode/command/` > `~/.config/opencode/command/` > `.claude/commands/` > `~/.claude/commands/` |
|
|
| Skills | `.opencode/skill/` > `~/.config/opencode/skill/` > `.claude/skills/` > `~/.claude/skills/` |
|
|
| Agents | `.claude/agents/` > `~/.claude/agents/` |
|
|
| MCPs | `.claude/.mcp.json` > `.mcp.json` > `~/.claude/.mcp.json` |
|
|
|
|
## CONFIG TOGGLES
|
|
|
|
```json
|
|
{
|
|
"claude_code": {
|
|
"mcp": false, // Skip .mcp.json
|
|
"commands": false, // Skip commands/*.md
|
|
"skills": false, // Skip skills/*/SKILL.md
|
|
"agents": false, // Skip agents/*.md
|
|
"hooks": false // Skip settings.json hooks
|
|
}
|
|
}
|
|
```
|
|
|
|
## BACKGROUND AGENT
|
|
|
|
- Lifecycle: pending → running → completed/failed
|
|
- OS notification on complete
|
|
- `background_output` to retrieve results
|
|
- `background_cancel` with task_id or all=true
|
|
|
|
## SKILL MCP
|
|
|
|
- MCP servers embedded in skill YAML frontmatter
|
|
- Lazy client loading, session-scoped cleanup
|
|
- `skill_mcp` tool exposes capabilities
|
|
|
|
## ANTI-PATTERNS
|
|
|
|
- Blocking on load (loaders run at startup)
|
|
- No error handling (always try/catch)
|
|
- Ignoring priority order
|
|
- Writing to ~/.claude/ (read-only)
|