AgentCanvas / Pages / Developer Guide / Core / Decisions / Platform / ADR-platform-001
2026-03-20
Date
2026-03-20
Status
accepted
Field
platform
Old ID
ADR-003

Context

The platform should support any VLN agent architecture, not just specific ones. Coupling domain code (policies, prompts, tools) into the framework limits extensibility.

Decision

All domain-specific code lives in workspace/. The framework (agentcanvas/backend/app/) discovers components at runtime via WorkspaceComponentRegistry using base class inheritance — it never imports domain code directly.

Alternatives

(a) Plugin system with explicit registration. (b) Domain code inside the framework with feature flags.

Rationale

Auto-discovery is zero-friction — drop a file, reload, it works. Base class inheritance provides a clear contract without configuration files. Keeps the framework small and domain-agnostic.

Affected docs

architecture.md, blueprint.md