Skip to content

ADR 0005: Technology extension model

  • Status: Accepted provisionally
  • Date: 2026-08-30

Decision

Technology support is split across four mechanisms:

  • Detector: read-only identification with confidence and evidence.
  • Profile: declarative defaults for commands, validators, policies and capabilities.
  • Extension implementation: executable behavior for complex detection, validation or integration.
  • Project configuration: project-specific selection, unit roots, command overrides and thresholds.

The MVP ships Python and Node.js profiles to prove that the core is not tied to a single ecosystem. Both must pass the same contract test kit and produce the same normalized result schemas.

Plugin safety

A plugin may return results and evidence references. It may not mutate the run store, change the workflow, grant itself capabilities or turn a missing mandatory check into success. Protocol and schema failures fail closed.