Parent PRD

#2

What to build

Extend @agentskit/runtime with multi-agent orchestration. A parent agent can delegate subtasks to child agents via directed delegation, and agents can communicate through an optional shared context.

Parent agent decides when to delegate, receives structured results. Children can read the shared context but only write to their result. Tree-shaped execution: parent waits for child results before proceeding.

Acceptance criteria

• runtime.run() accepts delegates config mapping names to agent configs (skill + tools)
• Parent agent can invoke delegates during ReAct loop via tool-like interface
• Child agents run their own ReAct loops independently
• Parent receives structured results from children
• createSharedContext() provides optional shared state
• Parent reads and writes shared context
• Children read shared context, write only to their result
• AgentEvents emitted for delegation: agent:delegate:start, agent:delegate:end
• Unit tests: parent delegates to one child, parent delegates to multiple children
• Integration test: planner skill delegates research to researcher + code to coder
• Shared context isolation test: child cannot overwrite parent's context entries

Blocked by

• Blocked by Minimal AgentRunner with ReAct loop #6 (AgentRunner / runtime)
• Blocked by Skill system + starter skills #8 (skills — delegates field)

User stories addressed

• User story 27 (multi-agent with directed delegation)
• User story 28 (shared context for collaborating agents)