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