Skip to main content

Agent Team Topology ADR-024

ADR-024: Agent Team Topology

Date: 2026-05-09 | Status: Accepted

Context

Phase D (2026-05-07) converted ~/companies/ to symlink → ~/system/agents/personas/. Link count = 1 (single inode per file). NOT hardlink mirror.

Decision

Canonical: ~/system/agents/personas/<X>/ (12 agent teams)

Backward-compat alias: ~/companies/<X>/ (symlink, transparent to all resolvers)

Future target: ~/system/teams/<X>/ (deferred)

Consequences

  • ✅ Zero refactor needed
  • ✅ No divergence risk
  • ⚠️ Naming semantics (accepted debt)

References

  • Decision memo: ~/system/specs/anvil-fs-d2-decision.md [CEO_APPROVED] 2026-05-09
  • Expert briefs: /tmp/anvil-fs-d2/
  • Canonical registry: ~/system/specs/canonical-registry.md

See full ADR at: ~/system/specs/adr-024-agent-team-topology.md

Back to top