From 647a9d5372557b11e4188c7952775329024d18fe Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Fri, 6 Nov 2026 22:02:32 +0000 Subject: [PATCH] Record ownership principles at the top of the roadmap --- docs/roadmap/promptkit-v0.19.0.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/roadmap/promptkit-v0.19.0.md b/docs/roadmap/promptkit-v0.19.0.md index 8690da6..b741aca 100644 --- a/docs/roadmap/promptkit-v0.19.0.md +++ b/docs/roadmap/promptkit-v0.19.0.md @@ -6,6 +6,24 @@ recommendations except where explicitly recorded as agreed below. Accepted report formats are an initial implementation target; practical beta feedback will guide later refinements rather than requiring exhaustive layout design now. +## Ownership principles + +Applications and integration handlers choose the operation and report content; +CommandKit core supplies the shared CLI mechanics. Integrated libraries retain +ownership of their domain behavior. + +| Area | CommandKit Owns | CommandKit Does Not Own | +| --- | --- | --- | +| **CLI output — core** | Format selection, serialization, template execution, and output delivery | Choosing report content or detail level; authoring application-specific text templates | +| **PromptKit/ConfigKit integrations** | Standard commands, flags, and report content that expose useful operator tasks through upstream public APIs | Helpers or convenience interfaces for application-internal use of upstream APIs | +| **CLI inputs** | CLI syntax, parsing, typed bindings, presence tracking, and usage diagnostics | Application business rules or upstream domain-validation semantics | +| **Upstream behavior** | Selecting and invoking supported capabilities, adapting their results, and preserving their meaning | Reimplementing upstream configuration resolution, prompt preparation, validation, or other domain algorithms | +| **Outcomes and errors — core** | Carrying and presenting selected outcomes; handling CommandKit's own parsing, rendering, and delivery failures | Deciding application recovery policy or terminating the process | +| **Application lifecycle** | Command dispatch and invocation reporting lifecycle | Application startup, engine construction, credential provisioning, signal handling, or long-lived application state | + +These agreed principles are recorded here for eventual incorporation into +[architecture.md](../policy/architecture.md). + ## Purpose and ownership Adopt released PromptKit v0.19.0 and expose useful operator tasks through