Architecture Layers (G-KD-05)

Purpose: Import/dependency boundary enforcement. Enforced by scripts/check_boundaries.py in CI.

---

Layer Dependency Graph

config          (no deps)
output_parser   (no deps)
contracts       → config
models          → config, contracts
execution       → config, contracts, models
agents          → config, contracts, models
operations      → config
orchestration_modes (no deps)

cli_impl        → config, contracts, models, execution, agents, output_parser, operations, orchestration_modes
cli             → config, contracts, models, execution, agents, output_parser, cli_impl, operations, orchestration_modes
mcp_server      → config, contracts, models, execution, agents, output_parser, operations, orchestration_modes, cli_impl
main            → config, contracts, models, execution, agents, cli_impl, cli

---

Rules

• contracts: Schema, adapters, validation, policy, telemetry. No agents/execution.
• agents: Runners, registry, resilience, state_machine. May use contracts.
• cli_impl: Implementation shared by CLI and MCP. May use all core layers.
• mcp_server: MCP tools/resources. May use cli_impl and core layers.

---

Verification

python scripts/check_boundaries.py
# or
pytest tests/test_ci_architecture.py -v

---

See also

• WORK_STREAM.md — canonical backlog
• 05-ARCHITECTURE.md — architecture overview
• 00-MASTER-INDEX.md — plan index