persona-garden-patch

Functional Types in Agent Taxonomy

Context

The estate accumulated 10+ agent roles over several weeks of development. Initially described informally — “the orchestrator manages the garden,” “the reader assesses citations” — the relationships between agents were implicit. Some coordinated others; some worked alone on bounded tasks; some enforced rules across the whole estate. Without a taxonomy, new agent proposals lacked a framework for evaluating whether they filled a real gap or duplicated an existing function.

The taxonomy emerged from observing what each agent actually does, not from top-down design. Three types were initially identified (orchestrator, worker, boundary guardian). The strategic coordinator was classified as a boundary guardian alongside the constraint enforcer, but this proved inaccurate — one sets architectural direction and coordinates orchestrators, while the other enforces constraints. These are different functions. The introduction of a tactical coordinator spanning precincts confirmed that estate-level coordination was a distinct type, not a variant of boundary enforcement. The fourth type — steward — was added to reflect this.

Decision

Classify all estate agents into four functional types:

Type Role Examples
Steward Estate-level strategic and tactical coordination spanning precincts Strategic director (Seneschal Persona), tactical coordinator
Orchestrator Coordinates workers within a precinct Chancellor Persona (Household), Groundskeeper Persona (Garden)
Worker Executes commissions in bounded scope Gardener, Cultivator, Forager, Pruner
Boundary guardian Enforces constraints across precincts Chatelaine Persona (privacy/secrets)

Stewards span precincts without managing one. They set direction or translate direction into tactical execution across precincts. Orchestrators deploy workers via commissions within their precinct. Workers report back; orchestrators decide what to act on. Boundary guardians enforce cross-precinct constraints without managing content or coordinating workers.

Consequences

Alternatives Considered

Relations