Workshop Glossary & Key Concepts

Welcome! This glossary is your guide to the core language for the Safety Shower MVP workflow. The goal is to build a Shared State—a common understanding that enables fast, auditable collaboration.

Core Grammar & Intents

TermDefinitionRelated Workshop Materials
Value PairThe north star: what we do that is valuable and why it matters; anchors each episode.Discovery Documentation/Safety Shower RFQ Workflow.md; Design & Build Workshop/MVP Documentation/Safety Shower MVP.md
SEA HeuristicStreamline (reduce effort), Enrich (improve quality), Accelerate (increase speed); declare primary intent per CF/episode.Infinity Method Grammar/Heuristic - The SEA Framework.md; RFQ Workflow
TOTE FrameworkTest → Operate → Test → Exit; the quality rhythm for every gate and step.Infinity Method Grammar/The TOTE Framework.md; RFQ Workflow
Repo‑relative CitationGuardrail: cite with file path + Doc_No + Section_Title + Page/Line_Range (for PDFs) or MD line range.Design & Build Workshop/MVP Documentation/Standard Work/reference/Citation_Style.md
CSV Coupling RubricMicro‑checklist: High‑Risk rows traced to CSV IDs; Decision_Notes mirror EP Item_IDs; no schema changes.Run of Show; Sequencing

Evidence & RFIs

TermDefinitionRelated Workshop Materials
Evidence Pack (EP Item)A single evidence file tracked to support High‑Risk/Partially Compliant rows; Status = Pending/Parked/Attached.Design & Build Workshop/MVP Documentation/Standard Work/reference/Evidence_Pack_Checklist.md
EP StartersStandard initial EP rows (e.g., EP‑EL‑001 Electrical Spec PDF; EP‑ATEX‑001/002/003; EP‑SPEC‑001).EP Checklist; Run of Show
Evidence Pack GateGate asserting all EP items are Attached or Parked and mirrored in CSV Decision_Notes and manifests.Run of Show; Sequencing
Targeted RFIPrecise client query with repo‑relative citations for Missing_Source or ambiguities (e.g., IP, EMC, FLP).Design & Build Workshop/MVP Documentation/Standard Work/templates/Targeted_RFI_Template.md
Referenced Spec StubA cited spec exists but is empty/unavailable in repo; keep cross‑walk row, add Parked EP + linked RFI.RFQ Workflow; Sequencing
Bid‑phase ATEX MinimaLanguage deferring ATEX protection to bid phase; requires ATEX‑by‑tag RFI before CF03 decisions.RFQ Workflow CF03; Onramp

Matrices, Registers & Cross‑walks

TermDefinitionRelated Workshop Materials
Spec Cross‑walkPer‑row mapping of High‑Risk items to exact sources with Section_Title + Page/Line_Range; retain Missing_Source with RFI link.Design & Build Workshop/MVP Documentation/Standard Work/templates/Spec_Crosswalk_Template.md; Sequencing
Spec Reference RegisterIndex of cited specs/offers with File_Path, Status (Complete/Stub), EP Item_ID, RFI_Link; maintained across episodes.Onramps (Trial Runs/quality-check/Episode_6_Onramp.md, .../Episode_7_Onramp.md)
ATEX/HAC Matrix (by tag)Tag → Zone, Gas Group, T‑Class, Protection Concept (Ex d/e/tb/other), Evidence (EP IDs); compute weakest‑link.Sequencing CF03; RFQ Workflow
Mismatch RegisterTable of Spec vs Offer mismatches with disposition (Variant/Deviation/RFI) and evidence.Sequencing CF03; Deviation template
Last‑validated TimestampCross‑walk metadata to mark the latest human validation time after evidence updates.Sequencing CF02/CF03

Compliance Signals & Checks

TermDefinitionRelated Workshop Materials
High‑RiskRequirements with elevated compliance impact (hazardous area, IP minima, power, EMC, alarms/CCR).Sequencing CF02; RFQ Workflow CF02
Partially CompliantStatus where offered solution differs from spec but may be acceptable with rationale; must cite EP.Run of Show; EP Checklist
Variant Dependency CheckOffers with variants (e.g., FLP vs non‑FLP) require explicit BOM selection and protection concepts.Sequencing CF03; datasheet evidence
Power Supply AlignmentReconcile site baseline vs offered power (e.g., 230 Vac vs 240 Vac; 3 kW) and propose variant/deviation.Sequencing CF03
IP Minima (IEC 60529)Spec requirement for enclosure ingress protection (e.g., IP66/IP67); must be evidenced.Instrumentation Spec; Sequencing CF02
EMC/EMI DeclarationVendor evidence to IEC 61000‑6‑2/‑6‑4 or IEC 61326; NAMUR NE 21 where applicable.EP Checklist; Quality Docs
Weakest‑link ClassOverall hazardous‑area capability determined by the least capable component in the tag assembly.Sequencing CF03

Artifacts & Manifests

TermDefinitionRelated Workshop Materials
Attachments ManifestEnumerates only referenced items with repo‑relative paths and EP filenames; mirror EP statuses.Run of Show CF04
Quality Documents ManifestAnnex manifest enumerating quality certificates and policy docs used as evidence.Run of Show CF04
Reference ListAnnex manifest listing similar past supplies; only if referenced and evidenceable.Run of Show CF04
Deviation (Appendix 2)Documented difference from spec with rationale, impact, proposed wording, and citations.Deviation Report Template; CF03
Clarification (Appendix 3)Documented clarification aligned to spec/offer interpretation with citations.Clarification Template; CF04
Technical Handoff SummaryOne‑pager for Sales with counts by area class, deviations, open RFIs/TQs, and CPQ notes.Run of Show CF04

Episode Rituals & Handoffs

TermDefinitionRelated Workshop Materials
Closure RitualFormal closeout capturing gates, outcomes, open items, and decisions for the next episode.Trial Runs/quality-check/Episode_6_Closure_Ritual.md
Retrospective RitualReflection on SEA/TOTE, friction, metrics, and standards deltas; feeds changelog.Trial Runs/quality-check/Episode_6_Retrospective_Ritual.md
OnrampStateless launch doc listing inputs, saliency, standard works, gates, registers/matrices, and kickoff script.Trial Runs/quality-check/Episode_7_Onramp.md
Kickoff ScriptCopy‑paste block that initializes an episode with the required reading order and guardrails.Onramps; Run of Show
Episode RitualsThe trio of docs (Closure, Retro, Onramp) enabling handoffs without chat memory.Trial Runs/quality-check/*Episode_*

Shared State

  • Always read the RFQ Workflow first to ground the scenario.
  • Use repo‑relative citations; include Doc_No + Section_Title + Page/Line_Range where applicable.
  • CSV remains authoritative; mirror EP Item_IDs in Decision_Notes.
  • Hard‑gate via TOTE at Evidence Pack, Cross‑walk, CF03, CF04.