Architecture

Architecture docs are decision records and maintainer-facing design references. User task guidance lives in the public docs sections linked from docs/index.md.

Start here:

• Modular orchestration architecture
• Workspace isolation architecture
  • ADR 0016: Node-scoped Git workspace isolation
• UI compact dashboard
• ADR 0001: Ports, adapters, and runtime integrations
• ADR 0012: Preflight compiled runtime execution plan

Key architectural constraints:

• Providers communicate through artifacts under .crewplane/, not hidden shared in-memory state.
• Provider integration is CLI-first.
• Runtime execution consumes compiled preflight plans.
• Workspace isolation is optional Git-backed source-tree isolation, not sandboxing.
• Adapter boundaries keep invoker, UI, and artifact implementations replaceable.