Add Promptkit configuration and inspection seams

docs/internal/app-orchestration.md

@@ -23,6 +23,12 @@ protocols, and report definitions belong in [the CLI reference](../cli.md),
 [the configuration reference](../config.md), [operations](../operations.md),
 and their focused integration and internal documents.
 
+`InspectPromptExecution` is a side-effect-free preflight helper for the prompt
+workflow. It verifies the exact report prompt version, its required YAML input,
+the generated-text JSON Schema contract, the selected profile, and any required
+environment credential before collection or persistence begins. It returns only
+safe project-owned identity and provenance values.
+
 ## Single-Report Workflow
 
 `GenerateDetailed` first collects weather data, then resolves the requested