agent-delegate

agent-delegate is an MCP-first delegation advisor for coding agents. It helps a main agent decide when to delegate read-only investigation, generate bounded subagent briefs, and summarize subagent results back into compact main-agent context.

Status

This repository implements v1: Read-only Delegation Advisor.

v1 does not execute write-code subagents, edit files on behalf of agents, run background monitoring, or orchestrate worktrees.

Related MCP server: delegations-mcp

Install

npm install

Run the MCP Server

npm run --silent agent-delegate -- serve

Configure your agent tool to launch that command as a local MCP server.

Check MCP Setup

npm run agent-delegate -- doctor

doctor verifies that dependencies are installed, the local MCP server can start, and all five v1 MCP tools are visible through stdio. It also prints a copyable MCP configuration.

Analyze a Sample Agent State

npm run agent-delegate -- analyze examples/agent-state.sample.json

Expected output includes a recommendation such as:

{
  "recommendation": "dispatch_readonly"
}

Dogfood Before Release

This project should be dogfooded before any open-source release. Unit tests are not enough because the core product is an MCP tool used by real agents.

Run the MCP smoke test:

npm run smoke:mcp

Run realistic fixtures:

npm run check:fixtures

See docs/dogfood.md for the full dogfood protocol.

Generate Rules

npm run agent-delegate -- init codex
npm run agent-delegate -- init claude-code
npm run agent-delegate -- init generic

MCP Tools

• record_event

• assess_delegation_need

• generate_delegation_briefs

• assess_brief_quality

• summarize_subagent_results

Documentation

• Dogfood protocol

• Dogfood results

• MCP configuration

• Release checklist

• Contributing

• Security policy

• Changelog

Development

npm test
npm run typecheck
npm run build

Roadmap

• v1: Read-only Delegation Advisor

• v2: Write-readiness Assessor

• v3: Controlled Write-agent Delegation

• v4: Parallel Write-agent Orchestration