Skip to content

Telemetry: record narrative-layer skip (no protagonist-perceivable moment)#40

Merged
erikshafer merged 1 commit into
mainfrom
narratives/telemetry-narrative-layer-decision
Jul 10, 2026
Merged

Telemetry: record narrative-layer skip (no protagonist-perceivable moment)#40
erikshafer merged 1 commit into
mainfrom
narratives/telemetry-narrative-layer-decision

Conversation

@erikshafer

Copy link
Copy Markdown
Owner

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:

  • §6.2 GPS ingest is triggered by the device opening a stream; driverId comes from the authenticated principal, and all processing is server-side.
  • §6.3/§6.4/§6.5 are Kafka publish, document upsert + eviction, and the Dispatch-side consumer view — inter-service plumbing throughout.
  • §4 defines driver session as "a logical concept, decoupled from any physical stream."

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

  • No narrative and no prompt doc produced — a disposable 2026-07-10 planning note served as the prompt-equivalent (W005/W006 precedent; the handoff's guardrail Add Skills Foundation #3 permitted retro-direct).
  • Design decision only. Does not start the transport build (item 2 of the 2026-07-04 handoff) — that's the next session. W006's R1–R8, the five slices, and ADR-018 remain untouched.

…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 erikshafer self-assigned this Jul 10, 2026
@erikshafer
erikshafer merged commit 47bfdde into main Jul 10, 2026
1 check passed
@erikshafer
erikshafer deleted the narratives/telemetry-narrative-layer-decision branch July 10, 2026 17:50
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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant