Telemetry: record narrative-layer skip (no protagonist-perceivable moment)#40
Merged
Merged
Conversation
…ment) Resolve the one open pre-implementation question for the Telemetry chain: does a thin driver-device narrative apply, or is the narrative step skipped? Empirical scan of W006 §6.2–§6.5 + the Ubiquitous Language finds no driver-app-perceivable surface — processing is server-side throughout, "driver session" is defined as a logical concept decoupled from any physical stream, and no indicator/permission-prompt/status screen is named in W006 or ADR-018. With nothing for the omniscient narrator to dramatize, the narrative layer does not apply. Mirrors W006's own EM-direct (Domain-Storytelling-skip) precedent one layer up. Recorded in docs/narratives/README.md via a new "When the narrative layer does not apply" section (criterion + empirical test + "Skipped narratives" table) and a v0.3 Document-history entry. Root-level retro added and indexed. No narrative and no prompt doc produced; a disposable 2026-07-10 planning note served as the prompt-equivalent (W005/W006 precedent).
erikshafer
added a commit
that referenced
this pull request
Jul 10, 2026
…nsport build Introduces three handoff notes tracking Telemetry chain progression from PR #39 (protos) through PR #42 (skeleton + slice 1). Post-PR-42 handoff orients next session on PR B: slices 4+2 paired (LastKnownPosition store + ReportLocations gRPC ingest), CritterCab's first gRPC surface in code and first Kafka testcontainer. Documents verified WolverineFx.Grpc client-streaming gap (must hand-wire against IMessageBus through 5.37.2; 6.17 unconfirmed), local Docker wedged state (lean on CI), and ADR-011 amendment locked (IInitialData bootstrap + last-writer-wins singletons). Supersedes three earlier untracked handoffs after PR #40 (narrative decision—does not apply, recorded) and PR #41 (package refresh to 6.17.0) both merged. Carries forward design-locked guardrails, three W006 §11 ADR candidates, and open skill-debt items. Includes narrative-decision and post-PR-41 intermediate handoffs for session lineage; all disposable once next session orients.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Resolves the single open pre-implementation question for the Telemetry chain (item 1 of the post-PR-39 handoff): does a thin driver-device narrative apply to Telemetry, or is the narrative step skipped with recorded rationale?
Decision: the narrative layer does not apply to Telemetry. No narrative is authored.
Why
The narratives README's load-bearing gate is the Voice and perspective rule — the omniscient narrator dramatizes what the protagonist actually perceives. An empirical scan of Workshop 006 §6.2–§6.5 + the Ubiquitous Language finds no driver-app-perceivable surface:
driverIdcomes from the authenticated principal, and all processing is server-side.With Context/Interaction/Response all empty of protagonist perception, there is nothing to dramatize — and forcing a narrative would require inventing UX surfaces the workshop never modeled, violating the "do not carry: UX/UI design" guardrail. This mirrors W006's own EM-direct precedent (it skipped Domain Storytelling for the same machine-to-machine reason).
Changes
docs/narratives/README.md— new "When the narrative layer does not apply" section (criterion + empirical test + a reusable "Skipped narratives (recorded)" table, first entry Telemetry), an Index note, and a v0.3 Document-history entry (the spec-delta closure-loop record).docs/retrospectives/telemetry-narrative-layer-decision.md— root-level retro (self-contained), indexed in the retrospectives README.Scope / process notes