2.1 KiB
ADR 0006: Adopt CommandKit's Native Operator Interfaces
Status
Accepted. Complements ADR 0004 and ADR 0005. Both remain accepted and are not superseded.
Date
2026-11-19.
Context
Scriptorium is adopting CommandKit's native operator interfaces within the PromptKit and ConfigKit boundaries established by ADRs 0004 and 0005.
Decision
Scriptorium adopts CommandKit's native operator interfaces.
ConfigKit owns configuration policy and everything in the configuration lifecycle before the final, fully resolved configuration handoff. Application schema and domain callbacks operate through ConfigKit's supported extension points within that lifecycle.
PromptKit owns prompt definitions, preparation, execution, validation, and inspection semantics. Its configuration is resolved through ConfigKit, with PromptKit supplying its domain schema and rules through ConfigKit's supported extension points.
Scriptorium owns the domain. After the handoff, it interprets the resolved configuration values and uses them to perform useful work that satisfies the user's request. It does not revise what constitutes effective configuration. It supplies requests through PromptKit's supported APIs and uses the returned results without redefining their meaning.
CommandKit's ckconfig and ckprompt integrations expose upstream ConfigKit
and PromptKit features. Scriptorium neutrally makes those features available
through the native interfaces, preserving upstream semantics.
Alternatives Considered
Retaining custom configuration and prompt inspection would duplicate upstream behavior and create another owner for its semantics. Use the native integrations instead.
Consequences
Standard inspection exposes the upstream result without constructing a different effective document, reconciling separate explanation trees, or reinterpreting upstream paths. The completed adoption record remains in Git history.