Heterogeneous Agent Development

Use this skill when the bug or feature lives in the external CLI agent pipeline, not the normal server-side agent runtime.

Use This Skill For

Adding or changing a driver under apps/desktop/src/main/modules/heterogeneousAgent/drivers/
Editing an adapter under packages/heterogeneous-agents/src/adapters/
Debugging heteroAgentRawLine transport, window.__HETERO_AGENT_TRACE, or executeHeterogeneousAgent
Fixing Claude Code stream-json bugs such as duplicate partial/full chunks, broken message.id boundaries, missing tool_result, TodoWrite state drift, or subagent thread routing
Fixing Codex JSONL bugs such as mixed multi-tool messages, broken turn boundaries, or missing tool-result mapping
Fixing step-boundary, tool persistence, subagent thread, or resume bugs in Claude Code / Codex flows
Reproducing multi-tool mixing, orphan tool messages, or stuck tool-result loading