Files
kandev/docs/specs/executors/README.md
T
2026-09-10 11:05:05 +01:00

2.9 KiB

status, system, specification_version, migration, owners
status system specification_version migration owners
draft executors 1 in_progress
kandev

Executor system

Purpose

The executor system owns the runtime environments that execute agent work, including local, container, and SSH execution boundaries.

Ownership

This system owns executor profiles, environment construction, SSH lifecycle, runtime resource admission, process and port safety, and executor-specific failure and recovery contracts.

Exclusions

  • Agent identity and provider capabilities belong to the agent system.
  • Task ownership of worktrees belongs to the task system.
  • Desktop process supervision belongs to the desktop system.

Specification map

Requirements

System design

Migration record

Migration remains in progress while legacy source detail is extracted from the canonical requirement and system-design documents above.

The Kubernetes executor foundation remains the current lifecycle contract. The three Kubernetes pairs own additive presets, launch diagnostics, and retained-compute visibility. They do not replace the foundation's resource ownership, recovery, or cleanup rules.

  • Agents: supplies the agent command and profile.
  • Tasks: owns task-scoped execution lifecycle.