Files
oh-my-opencode/src/features/AGENTS.md
T
justsisyphus 2ad8173144 docs: update AGENTS documentation metadata and agent model references
- Update generated timestamp and commit hash metadata
- Normalize agent model names with provider prefixes (anthropic/, opencode/, google/)
- Remove deprecated Google OAuth/Antigravity references
- Update line counts and complexity hotspot entries
- Adjust test count from 82 to 80+ files and assertions from 2559+ to 2500+

🤖 Generated with assistance of oh-my-opencode
2026-01-15 15:53:51 +09:00

2.9 KiB

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 (928 lines manager.ts)
├── boulder-state/              # Boulder state persistence
├── builtin-commands/           # Built-in slash commands
│   └── templates/              # start-work, refactor, init-deep, ralph-loop
├── builtin-skills/             # Built-in skills (1230 lines skills.ts)
│   ├── git-master/             # Atomic commits, rebase, history search
│   ├── playwright              # Browser automation skill
│   └── frontend-ui-ux/         # Designer-turned-developer skill
├── 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
├── claude-code-session-state/  # Session state persistence
├── context-injector/           # Context collection and injection
├── opencode-skill-loader/      # Skills from OpenCode + Claude paths
├── skill-mcp-manager/          # MCP servers in skill YAML
├── task-toast-manager/         # Task toast notifications
└── 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

{
  "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
  • Concurrency limits per provider/model (manager.ts)
  • background_output to retrieve results, background_cancel for cleanup
  • Automatic task expiration and cleanup logic

SKILL MCP

  • MCP servers embedded in skill YAML frontmatter
  • Lazy client loading via skill-mcp-manager
  • skill_mcp tool for cross-skill tool discovery
  • Session-scoped MCP server lifecycle management

ANTI-PATTERNS

  • Sequential execution for independent tasks (use sisyphus_task)
  • Trusting agent self-reports without verification
  • Blocking main thread during loader initialization
  • Manual version bumping in package.json