| Id | D01 |
|---|
| Title | The Staged RAG Diagnosis Demo |
|---|
| Type | instructor-projected troubleshooting and diagnosis asset |
|---|
| Accountable Owner | Pradeep Menon |
|---|
| Engineering Builder | [VERIFY — TO ASSIGN] |
|---|
| Builder Gap | Assign one engineering builder who owns the corpus-to-trace implementation, replay/live interface, acceptance suite, offline package and one-page runbook. Pradeep Menon remains accountable for content, rehearsal sign-off and delivery. |
|---|
| Content Gate Status | The delivery-asset specification is complete for content approval. Implementation remains blocked until an engineering builder is assigned; content approval must not be represented as demo readiness. |
|---|
| Build Status | NOT BUILT — owner assignment, implementation, trace acceptance, offline packaging and rehearsal remain delivery-stage work. |
|---|
| Ready By | 5 October 2026 |
|---|
| Purpose | Let the room diagnose four upstream or generation failures from visible answer and evidence traces before the trainer reveals the originating component. |
|---|
| Delivery | | Mode | Instructor-projected; no participant access |
|---|
| Default Path | Capture-and-replay through the same interface used by the live system |
|---|
| Proof Path | Live execution can be selected from the runbook if the room asks whether the pipeline is real |
|---|
| Opening Rule | Do not run a correct end-to-end example before Act 1 |
|---|
| Reveal Rule | Reveal one act at a time; preserve the completed four-row board through consolidation |
|---|
|
|---|
| Shared System | | Corpus | One versioned illustrative corpus of 24 invented source documents for a generic regulated institution. It contains no real institution policy text and no MUFG material. The builder may vary chunk count as required, but the 24 source documents, their versions and every locked baseline below remain fixed after owner sign-off. |
|---|
| Corpus Method | Derive a schema from realistic policy structure, generate varied invented documents from configurations, and derive the fixed questions and agreed answers from those configurations so ground truth is known by construction. |
|---|
| Required Corpus Features | - The exact T2 illustrative rule: Role-change access reviews must be completed within 10 business days.
- The exact T2 illustrative exception: Exception: where privileged access is suspended, approval is required before access is restored.
- Rare, lexically similar exact identifiers including TS-999, which is reserved for D01 and never appears in the teaching sequence before slide 35.
- A superseded policy and replacement with effective-from plus effective-to or superseded-by metadata.
- An unanswerable gap surrounded by a densely covered neighbouring policy that shares vocabulary, entities and register.
- Document type, stable source/version/location, effective date, jurisdiction and access-class metadata.
|
|---|
| Pipeline | One seven-stage teaching pipeline — Ingest, Chunk, Embed, Index, Retrieve, optional Re-rank, Generate — with query embedding inside Retrieve and intermediate output exposed at every stage. Break switches select versioned configurations or snapshots on this one visible instance; they do not create four separate applications. |
|---|
| Interface | One projected interface with V01 stage highlight, break control, fixed query ID, answer and citation pane, retrieved-chunk pane, agreed-evidence pane, and replay/live indicator. Captured traces and live traces render through the same components so replay is not visibly a video. |
|---|
| Invariants | - Same synthetic corpus, pipeline implementation and projected interface across all four acts.
- A different fixed query/baseline pair is locked for each act; do not claim that one literal query runs across all four.
- The broken prompt carries no abstention instruction in any act because that is Act 4's revealed mitigation.
- Only the named switch or input condition changes within an act; the trainer says a change was made without naming its component.
|
|---|
|
|---|
| Query Baseline Pairs | | Act | Act 1 |
|---|
| Pair Id | D01-A1 |
|---|
| Query | What must happen after a role change, including when privileged access has been suspended? |
|---|
| Baseline | The agreed evidence and answer must preserve both exact T2 clauses: the review is completed within 10 business days, and where privileged access is suspended, approval is required before access is restored. |
|---|
| Manual Evidence | Show the retrieved rule chunk beside the separately located exception that should govern it. |
|---|
| Status | LOCKED FOR BUILD — the corpus writer must preserve both exact clauses and place the exception outside the broken fixed-size chunk. |
|---|
| Act | Act 2 |
|---|
| Pair Id | D01-A2 |
|---|
| Query | What is the approval route for TS-999? |
|---|
| Baseline | In the illustrative corpus, TS-999 requires the product owner to submit the release request to the Product Governance Committee and obtain recorded approval before release. |
|---|
| Manual Evidence | Show the TS-999 procedure that hybrid retrieval should return beside the topically related, wrong product-family chunks returned by dense-only retrieval. |
|---|
| Status | LOCKED FOR BUILD — TS-999 and its baseline are reserved for D01; the T5 teaching case uses AC-417. |
|---|
| Act | Act 3 |
|---|
| Pair Id | D01-A3 |
|---|
| Query | How often must high-risk customer files be reviewed under the policy currently in force? |
|---|
| Baseline | Every 12 months under the illustrative Customer Risk Review Policy v2, effective 1 July 2026; v1's superseded interval was 24 months. |
|---|
| Manual Evidence | Show the superseded and replacement policy passages side by side with both effective dates visible. |
|---|
| Status | LOCKED FOR BUILD — the corpus must include both policy versions and explicit effective-from, effective-to and superseded-by metadata. |
|---|
| Act | Act 4 |
|---|
| Pair Id | D01-A4 |
|---|
| Query | What retention period applies to biometric voiceprints used for branch queue analytics? |
|---|
| Baseline | The agreed answer is that the corpus does not contain enough evidence to answer. The gap originates at Ingest; the demonstrated failure is Generate not saying so. |
|---|
| Manual Evidence | Show every retrieved near-miss chunk and the recorded absence of an agreed supporting chunk; do not fabricate a should-have-been-retrieved passage. |
|---|
| Status | LOCKED FOR BUILD — no source document may answer this question; neighbouring policies may share retention, analytics and branch vocabulary but must not mention biometric voiceprints. Re-test if the delivery model changes. |
|---|
|
|---|
| Break Switches | | Command | break=chunking |
|---|
| Act | Act 1 |
|---|
| Change | Select the fixed-size chunk configuration whose boundary severs the T2 rule from its exception; lock overlap so it cannot silently repair the break. |
|---|
| Intended Bad Signature | The answer states the review rule while omitting the separately located restoration-approval condition. |
|---|
| Origin | Chunk |
|---|
| Mitigation | Use the cheapest defensible fixed-size-with-overlap baseline, then move to hierarchical retrieval when the typical answer spans a child chunk. |
|---|
| Command | break=dense_only |
|---|
| Act | Act 2 |
|---|
| Change | Disable sparse retrieval and fusion while leaving the same index, pipeline and interface visible. |
|---|
| Intended Bad Signature | The system returns topically related product-family material but misses the exact TS-999 procedure. |
|---|
| Origin | Retrieve |
|---|
| Mitigation | Restore sparse retrieval and fuse it with dense results; re-ranking cannot recover a candidate that was never retrieved. |
|---|
| Command | break=stale_index |
|---|
| Act | Act 3 |
|---|
| Change | Point the same pipeline at the pre-supersession index snapshot or disable the validity filter so the superseded policy remains answerable. |
|---|
| Intended Bad Signature | The answer is fluent, cited and out of date, and its citation resolves visibly to the superseded policy. |
|---|
| Origin | Index |
|---|
| Mitigation | Apply effective-date metadata at chunk time, filter validity at retrieval, propagate supersession and assign a refresh owner. |
|---|
| Command | break=out_of_corpus |
|---|
| Act | Act 4 |
|---|
| Change | Select the fixed gap query while leaving the pipeline configuration unchanged; retrieval must return near-miss neighbours and the broken prompt must contain no abstention instruction. |
|---|
| Intended Bad Signature | Generate invents a plausible unsupported answer from near-miss evidence instead of stating that the corpus cannot answer. |
|---|
| Origin | The gap originates at Ingest; the failure to say so originates at Generate. |
|---|
| Mitigation | Add an abstention clause to the prompt contract and enforce citation support, while stating that neither control guarantees correctness. |
|---|
|
|---|
| Five Beats | | Beat | 1 |
|---|
| Name | Break |
|---|
| Timing | about 20 sec |
|---|
| Instruction | Trigger the act's named switch and say that one thing changed, without naming where. |
|---|
| Beat | 2 |
|---|
| Name | Run |
|---|
| Timing | about 40 sec |
|---|
| Instruction | Run the act's fixed query through the same visible interface and show the captured bad answer and citation. |
|---|
| Beat | 3 |
|---|
| Name | Diagnose |
|---|
| Timing | about 60 sec |
|---|
| Instruction | Ask which component failed and hold the silence; accept a concise hypothesis but do not answer it. |
|---|
| Beat | 4 |
|---|
| Name | Inspect |
|---|
| Timing | about 2 min |
|---|
| Instruction | Retrieve the evidence manually and show actual versus agreed evidence side by side. For Act 4, show near-miss chunks and the known absence of support rather than inventing a missing chunk. |
|---|
| Beat | 5 |
|---|
| Name | Reveal |
|---|
| Timing | about 1 min |
|---|
| Instruction | Name the origin, pin it to V01, state one mitigation and reset to the next locked pair. |
|---|
|
|---|
| Timing | | Topic Total | 24 min |
|---|
| Setup | 1 min; name the synthetic corpus, shared system, replay default and subset framing; do not show a correct run |
|---|
| Acts | 20 min; four acts at roughly 5 min each, each protecting about 60 sec of diagnosis and the manual evidence check |
|---|
| Consolidation | 3 min; completed four-row board plus subset qualification |
|---|
| Closing | 4 min; 2 min V04/manual diagnostic and 2 min M02.2 bridge plus M02.3 signpost |
|---|
| Combined T7 And Closing | 28 min |
|---|
|
|---|
| Execution Paths | | Replay Default | - Run every act live during build until the intended signature is produced and the accountable owner accepts the evidence pair.
- Capture the complete trace: configuration and index version, query ID, retrieved chunks and scores, prompt, answer, citations, stage events and timing.
- Replay those trace events locally through the same interface and stage-highlighting components used by live execution.
- Record seed and sampling settings as build metadata only; fixed seeds do not guarantee hosted-model determinism.
|
|---|
| Live Proof Path | - Expose one runbook control that switches the same interface from replay to live without changing query IDs or stage labels.
- Use live only on request or during rehearsal proof, state that output may vary, and return to the accepted replay trace for teaching.
- Re-capture and re-accept affected traces after any model, embedding, vector-store, prompt or corpus change.
|
|---|
|
|---|
| Acceptance Tests | - Replay mode produces byte-identical trace output for each act in 20 consecutive runs, including chunks, prompt, answer, citations and stage events.
- The same visible corpus, pipeline and interface are used across all four acts; each act has a distinct locked query/baseline pair and exactly one named break condition.
- Act 1 returns the rule without the separately located exception, and its evidence pane reuses the exact illustrative clause shown in T2.
- Act 2 returns topically related wrong material while the signed-off TS-999 evidence is recoverable through the baseline hybrid path.
- Act 3 returns a fluent, cited, out-of-date answer whose citation opens the superseded policy with its effective date visible; the replacement policy is available in the agreed-evidence pane.
- Act 4's corpus has no supporting answer, retrieval returns near-miss neighbours, and Generate fails to abstain; the test record states separately that the gap began at Ingest.
- Run Act 4 live more than 20 times during build and again at rehearsal; any correct abstention blocks capture approval until the corpus/prompt is retuned and the test rerun. Repeat after any delivery-model change.
- Every act completes inside roughly five minutes while preserving the diagnosis pause and manual evidence check; cut trainer commentary before either protected beat.
- The V01 stage highlight and V04 placement use the same stage order, geometry, build/run split and dashed optional Re-rank treatment.
- The full replay path passes with the network disabled, and the live proof control fails closed to replay rather than leaving the interface blank.
- A venue-resolution fallback recording covers all four acts and can be launched locally if the interactive interface fails.
- Pradeep Menon signs the four baselines, accepted wrong signatures, offline package and runbook at the rehearsal-ready gate on 5 October 2026.
|
|---|
| Offline Fallback | | Primary | Local replay package containing accepted trace files, assets and the same projected interface; no network call is required. |
|---|
| Secondary | One locally stored venue-resolution recording covering all four acts in order, including manual evidence panes and stage placements. |
|---|
| Preflight | Before rehearsal and delivery, disable the network, run all four replay traces, open the recording, verify fonts and resolution, and confirm that the live control falls back to replay with a visible status label. |
|---|
| Recovery Rule | If live or venue networking fails, state that replay is the designed default and continue from the current act; if the interface fails, switch to the recording at the same beat. |
|---|
|
|---|
| Runbook | | Format | One page, available both printed and locally as PDF |
|---|
| Required Fields | - Preflight checklist: network-off replay, recording, fonts, resolution, timer and V01 stage highlight.
- Act order and exact commands: break=chunking, break=dense_only, break=stale_index, break=out_of_corpus.
- For each act: pair ID, literal locked query, accepted bad-answer signature, retrieved/agreed evidence, origin stage, one-line mitigation and five-beat timing cues.
- Replay/live switch and the exact sentence explaining why replay is the default.
- Fallback point for every act and the local recording path.
- Reset step between acts and recovery steps for blank UI, wrong trace, accidental good answer or time overrun.
- Version manifest for corpus, chunker, embedding, index snapshot, retriever, optional re-ranker, prompt and model.
|
|---|
| Trainer Rule | Do not improvise a query, baseline, answer or citation. If a trace does not match the accepted signature, switch to its accepted replay trace and continue. |
|---|
|
|---|
| Role Lenses | | Developer | Own switch behaviour, trace completeness, intermediate-output visibility and the manual evidence comparison. |
|---|
| Infrastructure | Own versioned index snapshots, replay/live controls, network-off operation, local assets, latency headroom and recovery steps. |
|---|
| Risk Operations | Co-author and approve the baselines, effective-date logic, absence-of-support record, citation checks and rehearsal acceptance evidence. |
|---|
|
|---|
| Outputs | - One versioned illustrative synthetic corpus and schema/configuration manifest.
- Four signed-off fixed query/baseline pairs and four accepted captured traces.
- One replay/live projected interface keyed to V01.
- One 20-run-plus acceptance log with a separate Act 4 live firing log.
- One offline replay package, one venue-resolution fallback recording and one-page runbook.
|
|---|
| Scope Guards | - No participant access, fifth act, opening success run, evaluation harness or UI polish beyond back-of-room legibility.
- No agentic RAG, Graph RAG or RAFT in D01.
- Do not present the four modes as complete, standard or frequency-ranked.
- Do not use real institutional policy text, real MUFG material, a fabricated incident or unsupported literal query details.
|
|---|