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
69 lines
2.9 KiB
Markdown
69 lines
2.9 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 (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
|
|
```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
|
|
- 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`
|