YeonGyu-Kim
c8da697a10
- Root: Add Prometheus/Metis/Momus agents, MCP architecture, 82 test files - agents/: Document 7-section delegation and wisdom notepad - auth/: Multi-account load balancing (10 accounts), endpoint fallback - features/: Update background-agent 825 lines, builtin-skills 1230 lines - hooks/: 22+ hooks with event timing details - tools/: sisyphus-task 583 lines, LSP client 632 lines - cli/: config-manager 725 lines, 17+ doctor checks - shared/: Cross-cutting utilities with usage patterns
2.9 KiB
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 (825 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
└── context-injector/ # Context collection and injection
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_outputto retrieve results,background_cancelfor cleanup- Automatic task expiration and cleanup logic
SKILL MCP
- MCP servers embedded in skill YAML frontmatter
- Lazy client loading via
skill-mcp-manager skill_mcptool 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