NewOpenAgents/context/openagents-repo/lookup/subagent-framework-maps.md
cclohmar 0764127e46 chore: extract OpenAgents Control (OAC) with local customizations
Snapshot of the installed OAC framework (/app/.opencode) including Claus's custom agents:
- agent/OpenArchitect.md (Aiden, the architect)
- agent/subagents/openagent.md (GMS sub-agent builder)
- agent/core/openagent.md, agent/core/opencoder.md (customized)
- agent/subagents/{code,core,development,system-builder}/*
- command/, context/, skills/, tool/, README.md, env.example

Excluded runtime artifacts: node_modules/, bin/opencode (184MB binary), lockfiles.
2026-10-12 08:24:00 +00:00

1.9 KiB

Lookup: Subagent Framework Maps

Purpose: Quick reference for adding subagents to eval framework
Last Updated: 2026-01-09


Critical: THREE Maps Must Be Updated

When adding a new subagent, update these THREE locations:

1. Parent Map (run-sdk-tests.ts ~line 336)

Purpose: Maps subagent → parent agent for delegation testing

const subagentParentMap: Record<string, string> = {
  'contextscout': 'openagent',     // Core subagents → openagent
  'task-manager': 'openagent',
  'documentation': 'openagent',
  
  'coder-agent': 'opencoder',      // Code subagents → opencoder
  'tester': 'opencoder',
  'reviewer': 'opencoder',
};

2. Path Map (run-sdk-tests.ts ~line 414)

Purpose: Maps subagent name → file path for test discovery

const subagentPathMap: Record<string, string> = {
  'contextscout': 'ContextScout',
  'task-manager': 'TaskManager',
  'coder-agent': 'CoderAgent',
};

3. Agent Map (test-runner.ts ~line 238)

Purpose: Maps subagent name → agent file for eval-runner

const agentMap: Record<string, string> = {
  'contextscout': 'ContextScout.md',
  'task-manager': 'TaskManager.md',
  'coder-agent': 'CoderAgent.md',
};

Error Messages

Error Missing From Fix
"No test files found" Path Map (#2) Add to subagentPathMap
"Unknown subagent" Parent Map (#1) Add to subagentParentMap
"Agent file not found" Agent Map (#3) Add to agentMap

Testing Commands

# Standalone mode (forces mode: primary)
npm run eval:sdk -- --subagent=contextscout

# Delegation mode (tests via parent)
npm run eval:sdk -- --subagent=contextscout --delegate

  • guides/testing-subagents.md - Full testing guide
  • guides/adding-agent.md - Creating new agents