| name | subagent |
| description | Multi-subagent framework. Allows the main agent to spawn specialized Claude Code subagents with specific skills. Each subagent runs autonomously (full agentic loop) and returns a structured result. Engine: Claude Code CLI (claude --bare -p). Trigger: "subagent", "spawn agent".
|
Subagent Framework — Multi-Subagent Framework
When to Use
When a task requires a specialized agent with specific skills:
- Presentation generation (pptx skill)
- Document processing (docx, xlsx skills)
- Any task that needs an isolated Claude Code session
Architecture
Main Agent → SubagentExecutor.prepare() → SubagentRequest (CLI command)
→ SubagentExecutor.execute() → SubagentResult
Engine: claude --bare -p with --add-dir for skills, --output-format json.
API
from skills.subagent.executor import SubagentExecutor
executor = SubagentExecutor()
executor = SubagentExecutor(mode="remote", host="root@YOUR_VPS_IP")
request = executor.prepare("presentation-builder", "Create a presentation...")
result = executor.execute(request)
result = executor.run("presentation-builder", "Create a presentation...")
print(result.summary())
Registered Agents
Registry: 99_process/subagent_registry.yaml (field executor for CLI-based agents).
| Agent ID | Skills | Description |
|---|
presentation-builder | pptx | PPTX presentation generation |
Plugin Contract — How to Add a New Subagent
- Create
skills/<name>/api.py with a <Name>Agent class
- Add an entry in
99_process/subagent_registry.yaml with the executor field
- Add a scope in
config/agent_scopes.json
SubagentExecutor will pick it up automatically
Execution Modes
| Mode | How | When |
|---|
local | subprocess.run(claude ...) | Claude Code CLI installed locally |
remote | ssh host "claude ..." | Claude Code CLI on VPS |
🇺🇦 Українською
Мультисубагентний фреймворк для спавну спеціалізованих Claude Code субагентів з конкретними скілами. Кожен субагент працює автономно та повертає структурований результат. Підтримує локальний та віддалений (VPS) режими.
