Orchestrator Agent with Parallel Sub-Agents in Kiro CLI

Thu, 02 Jul 2026 00:00:00 +0200

Figure 1. kiro orchestrator agents

Overview

Kiro CLI allows us to configure an orchestrator agent that executes specialized sub-agents in parallel. Each sub-agent has its own tools, permissions, and MCP servers – the parent’s trust settings are not inherited.

Architecture

Figure 2. Agents flow

Step 1: Define Specialized Agents

We give each sub-agent its own JSON configuration under .kiro/agents/.

.kiro/agents/code-agent.json

{
  "name": "code-agent",
  "description": "Implements features and writes code",
  "prompt": "You are an experienced Kotlin/Java developer. Write clean, tested code.",
  "tools": ["read", "write", "shell", "code", "grep"],
  "allowedTools": ["read", "code", "grep"],
  "toolsSettings": {
    "write": {
      "allowedPaths": ["./src/**", "./tests/**"],
      "deniedPaths": ["./.env", "./secrets/**"]
    },
    "shell": {
      "allowedCommands": ["mvn test", "mvn compile"],
      "autoAllowReadonly": true
    }
  }
}

Agent on Micha Kops' Tech Notes

Orchestrator Agent with Parallel Sub-Agents in Kiro CLI

Overview

Architecture

Step 1: Define Specialized Agents