Giving a Coding Agent an Org Chart

说明与用途

subsession 协议将代理上下文增长限制为结构化报告，实现高效的多子代理管理，并在浏览器中可视化层级结构。

问题

When an agent spawns multiple subagents, the mother’s context swells with each child’s transcript, exhausting limited context windows and obscuring the final outcome.

结果

The subsession protocol limits mother context growth to report size, enables structured reporting, and provides a clear org‑chart UI for human oversight, improving scalability and traceability of multi‑agent workflows.

工作流

• 1. Mother writes a brief with mission, file globs, token cap, depth allowance, report contract, and optional verify list.
• 2. Mother spawns child subsessions via role‑typed spawn, each child receives its own runtime, context window, and tool permissions.
• 3. Child executes, sending progress reports through a single tool and final reports that satisfy the report contract.
• 4. If a child blocks (e.g., needs approval), it checkpoints and reports the blocker; the human reviews the blocked queue in the UI.
• 5. Human may spawn a successor with the same brief and a continues reference to the predecessor, triggering a fresh hire with handover.
• 6. The system performs a quiescence sweep to clean up dead children before succession.
• 7. The browser UI polls RPC endpoints to render the org tree, live token usage, checkpoint badges, and blocked queue with a handover button.

证据

The mother sees only structured reports.

来源

Four phases, four gates, one rule kept throughout: no pass claim without machine evidence.

来源