CHANGELOG — MVP Updates

Context

• Project: Q-32705 — Saipem COMP3 | Episode: 4→5 transition
• Objective: Improve adherence to The Infinity Method Grammar and the Safety Shower RFQ Workflow while reducing time-to-flow for Episode 5

Summary of updates

• Run of Show (Safety Shower MVP)
  • Added path remap micro‑step in CF04; strengthened Evidence Pack gate (manifest mirroring + CSV Decision_Notes EP IDs); appended “Appendices Closure Rule” (Why Closed + citations)
• Master Sequencing (MVP Sequencing)
  • Added 0a Repo Path Remap; tightened SpecCrosswalk assert to allow Missing_Source with RFI note; added csv_is_source_of_truth assert under EvidencePackGate
• Standards (reference/templates)
  • Citation_Style: EP Decision_Notes examples; repo‑relative path example; precise line guidance
  • Spec_Crosswalk_Template: repo‑relative paths requirement; Missing_Source→RFI note; allow EP Item_ID in Notes
  • Evidence_Pack_Checklist: Status normalized (Pending/Parked/Attached); mirroring into Manifest + CSV Decision_Notes
  • Appendix2_Technical_Deviation_List_Template & Appendix3_Technical_Clarification_List_Template: “Why Closed” requirement
  • Metrics_Template: Episode 4 metrics fields (evidence completeness %, citation coverage %, RFIs closed, deviations accepted, High‑Risk finalized)
• Episode rituals and onramp
  • Episode_4_Closure_Ritual: Gate checks and TOTE; added cross‑links in references
  • Episode_4_Retrospective_Ritual: SEA wins, friction; standards deltas cross‑linked
  • Episode_5_Onramp: Inputs, saliency, SW‑E5‑01..04, TOTE, pass/fail gates, kickoff script

Rationale (Infinity Method coupling)

• SEA: Streamline entry (path remap; operator scripts); Enrich quality (citations precision; EP mirroring; Missing_Source policy); Accelerate handoff (explicit gates + DoD)
• TOTE: Each gate includes Test criteria, Operate action, Re‑Test, Exit conditions
• Friction Lens: Addressed path migration, evidence attachment ambiguity, missing sources, and citation precision

Actionable guidance for next episode

• Use repo‑relative paths only (e.g., Reference Examples/Q-32705 - Saipem COMP3/...; Trial Runs/Q-32705/...)
• Enforce EP mirroring across Evidence_Pack_Checklist • Attachments Manifest • CSV Decision_Notes
• For Missing_Source in cross‑walk, create RFI using Targeted_RFI_Template and link back
• Maintain “Why Closed” citations in appendices; keep CSV as authoritative (no schema edits)

References

• Grammar & Heuristics: The Infinity Method Grammar • Heuristic - The SEA Framework • The TOTE Framework • Heuristic - The Friction Lens
• Workflow: Safety Shower RFQ Workflow
• Standards index: Standards_Catalog

Episode 5 — Q-32794 (Tecnicas — Stade LNG) — Standards Refinements

Context

• Source set: Reference Examples/Q-32794 - Tecnicas - Stade LNG (example outcomes)
• Anchor RFQ: RFQ Files/105101560-CP.md — ATEX/HAC and spec references
• Episode focus: SW‑E5‑01..04 (precision citations; EP readiness; Missing_Source→RFI; annex coherence)

Accepted refinements (Run of Show, Sequencing, Standards)

• RFQ Workflow
  • Add CF01 test: “Referenced Spec Stub” — if a cited spec resolves to an empty stub (e.g., HEHTEF-000-L-ES-0021.md, HEHTEF-000-T-SS-0004.md), mark Missing_Source, draft an RFI, and create a Parked EP item.
  • Add CF01 test: “Bid‑phase ATEX minima present” — if language like “Minimum ATEX Protection will be confirmed during bid phase” is detected, generate an “ATEX minima by tag/zone/T‑class” RFI before CF03.
• Run of Show (Safety Shower MVP)
  • Pre‑Flight: list Safety Shower Evidence Pack starters (Status Parked until attached): EP‑EL‑001 (Electrical Spec PDF), EP‑ATEX‑001 (CE ATEX Declaration), EP‑ATEX‑002 (ATEX Type Exam), EP‑ATEX‑003 (JB Ex‑d/IP certificate), EP‑SPEC‑001 (spec extract).
  • CF01 Completeness & Targeted RFI: include canned prompts for (a) referenced spec stub; (b) ATEX minima by tag/zone/T‑class.
  • Evidence Pack Gate: ensure any Partially Compliant or bid‑phase dependent row references an EP Item_ID.
• Master Sequencing (MVP Sequencing)
  • 3) CF01.CompletenessAndRFI: “If referenced spec file is stub/empty, set Missing_Source, generate RFI, and add EP‑EL‑001 (Parked).”
  • 5a) CF02.SpecCrosswalk: require Section_Title + exact line ranges in Section/Lines; add RFI link note for bid‑phase ATEX minima.
  • 6. CF03.StatusAndHazardMatrix: add a “Voltage mismatch check” (230 Vac spec vs 240 Vac offer) and guidance to propose variant/deviation if needed.
• Standards
  • Citation_Style: add explicit example using Doc_No + Section_Title + line range, e.g., “HEHTEF‑000‑T‑RQ‑0006 (TEF 105101560‑CP), §5.3.3, lines 586–589”.
  • Spec_Crosswalk_Template: update example paths to Reference Examples/Q‑XXXX/...; note to include Section_Title within Section/Lines; reiterate Missing_Source→RFI.
  • Evidence_Pack_Checklist: pre‑seed common EP rows for Safety Showers (IDs above) as Parked items; require filename standards.
  • Prompt Packs (CF01–CF03):
    • CF01: insert “ATEX minima by tag” RFI snippet and “referenced spec stub” RFI snippet.
    • CF02: enforce Section_Title+line ranges; add “Offer vs Spec voltage” check.
    • CF03: hazards table to explicitly request JB protection concept evidence (Ex d vs Ex e) and IP minima.

Evidence from example (precise citations)

• ATEX/HAC requirement: Reference Examples/Q-32794 - Tecnicas - Stade LNG/RFQ Files/105101560-CP.md, §5.3.3 lines 586–589; §5.6.8 lines 1422–1454
• JB Ex‑d and bid‑phase minima: §5.3.3 lines 603, 605
• Power supply (spec): §5.3.3 lines 597–599; Offer (240 V): Q-32794-1 - Tank Showers.md lines 74–77

Rationale (SEA/TOTE/Friction)

• SEA: Streamline CF01 with early Missing_Source and ATEX minima tests; Enrich citations (Section_Title+lines) and EP standardization; Accelerate E5 by pre‑baked RFIs/EPs.
• TOTE: Add explicit Tests and Exit conditions for Missing_Source and bid‑phase dependencies.
• Friction: Repeated spec stubs, bid‑phase ATEX ambiguity, and voltage mismatch are predictable—codify them.

Episode reference

• Source episode: Trial Runs/Q-32794 (Stade LNG example) — Episode 5
• Outputs: CF02/output/Spec_Crosswalk_Q-32794.md, CF04/output/Evidence_Pack_Checklist_Q-32794.md, CF01/output/RFIs/*, CF04/output/Attachments_Manifest_Q-32794.md

Episode 5 — Process Adherence Findings (RFQ Workflow × Infinity Grammar)

Findings (continuous improvement)

• Value Pair + SEA: Add to the top of every Episode doc to anchor purpose and intent. Link to The Infinity Method Grammar and Heuristic - The SEA Framework.
• Spec Reference Register: Maintain a single table across episodes listing cited specs with Doc_No, Title, File_Path, Status (Complete/Stub), EP Item_ID, and RFI link. Surfaces Missing_Source early per Safety Shower RFQ Workflow.
• Hard TOTE Gates: For each decision gate (Evidence Pack, Cross‑walk, CF03, CF04), write explicit Test→Operate→Test→Exit blocks aligned to The TOTE Framework.
• ATEX/HAC Matrix by Tag: Track Tag • Zone • Gas Group • T‑Class • Protection Concept (JB/Heater/Other) • Evidence (EP IDs) to convert bid‑phase ambiguity into actionable asks.
• CSV Coupling Rubric: Micro‑checklist in every Episode doc — “High‑Risk rows traced to CSV IDs; Decision_Notes mirror EP Item_IDs; no schema changes.”
• Evidence Pack Starters: Pre‑seed EP‑EL‑001, EP‑ATEX‑001/002/003, EP‑SPEC‑001 per Evidence_Pack_Checklist.
• Citation Precision: Require Doc_No + Section_Title + line range; reinforce examples in Citation_Style and ensure Section/Lines in Spec_Crosswalk_Template captures the title.
• Prompt Hooks: Add canned RFI prompts in CF01 for (a) referenced spec stub via Targeted_RFI_Template and (b) ATEX minima by tag/zone/T‑class; CF02 add “Offer vs Spec voltage” check; CF03 hazards table explicitly asks for JB protection concept/IP evidence.

Applied updates

• Closure + Onramp updated:
  • [[Trial Runs/quality-check/Episode_5_Closure_Ritual]]: Added Value Pair/SEA headers, CSV coupling rubric, and reinforced TOTE gates
  • [[Trial Runs/quality-check/Episode_6_Onramp]]: Added Spec Reference Register and ATEX/HAC Matrix templates, mismatch register, kickoff script; cross‑links to Safety Shower MVP, MVP Sequencing, Standards_Catalog

Rationale

• Tightens adherence to Safety Shower RFQ Workflow through visible Tests, early Missing_Source handling, and evidence traceability aligned to CSV as SoT.

Episode 6 — Q-21699 (Saipem — COMP2) — Standards Refinements

Context

• Source set: Reference Examples/Q-21699 - Saipem COMP2 (manual outcomes present under Rev 1 Quote Sent/)
• Episode focus: SW‑E6‑01..04 (EP attach/mirror, cross‑walk precision, status/deviation, annex refresh)

Accepted refinements (Run of Show, Sequencing, Standards)

• Run of Show (Safety Shower MVP): add CF03 pre‑step to stage Evidence Pack items (Parked) and mirror EP Item_IDs before status/deviation.
• Master Sequencing (MVP Sequencing):
  • CF02: auto‑trigger RFI‑IP / RFI‑EMC when specs include ingress (IP66/IP67 per IEC 60529) or EMC (IEC 61000/IEC 61326/NAMUR) and offers lack explicit evidence.
  • CF02 Cross‑walk: require Section_Title + Page/Line_Range.
  • CF03: add Variant dependency check for FLP vs non‑FLP selection and Power supply alignment check; add preliminary EP staging.
• Templates & Standards:
  • Spec_Crosswalk_Template: split Section/Lines into Section_Title and Page/Line_Range.
  • Citation_Style: add Section_Title + Page/Line citation example.
  • Evidence_Pack_Checklist: EMC example row includes Missing_Source→RFI note.
  • Standards_Catalog: add link to new Spec_Reference_Register_Template; note early EP staging and variant dependency under Gaps.
  • New: Spec_Reference_Register_Template.

Evidence from example (precise citations)

• IP minima (spec): Reference Examples/Q-21699 - Saipem COMP2/RFQ Files/Instrumentation/200-51-IN-SPC-00021_00.md, lines 1721–1725.
• Hazard area/T‑Class and variant note (datasheet): Reference Examples/Q-21699 - Saipem COMP2/Rev 1 Quote Sent/Datasheets and CoCs.md, lines 212–218; 468–471.
• Flow and power (datasheet): .../Datasheets and CoCs.md, lines 224–227; 216–219.
• EMC/ATEX register referenced but not attached (quality pack): Reference Examples/Q-21699 - Saipem COMP2/Rev 1 Quote Sent/Quality Documents.md, lines 741–742; 751–752.

Rationale (SEA/TOTE/Friction)

• Streamline: early EP staging reduces CF03 back‑and‑forth; auto RFIs in CF02 cut delay.
• Enrich: cross‑walk precision improved; Spec Reference Register standardizes Missing_Source handling.
• Accelerate: variant/power checks make CF03 decisions faster; EP mirroring ensures gate readiness.

Episode reference

• Source episode: Trial Runs/Q-21699 — Episode 6 (Saipem COMP2)

Episode 7 — Q-21699 (Saipem — COMP2) — Generic Refinements

Context

• Objective: Incorporate pattern-based refinements without overfitting to a single example; enforce variant/power/evidence gates.

Accepted refinements (Run of Show, Sequencing, Standards, Workflow)

• Master Sequencing (Design & Build Workshop/MVP Documentation/MVP Sequencing.md):
  • CF02 Auto‑trigger (generic) for variant‑available phrasing, power terms, and referenced‑but‑missing declarations → pre‑populate targeted RFIs.
  • CF03 asserts strengthened: add variant_locked, power_decided, environmental_minima_met_with_evidence, regulatory_declarations_attached_or_RFI.
• Run of Show (Design & Build Workshop/MVP Documentation/Safety Shower MVP.md):
  • CF03 guardrails (generic) to block exit when Variant/Power/Environmental/Regulatory gates are unmet for High‑Risk rows.
• Citation Style (Design & Build Workshop/MVP Documentation/Standard Work/reference/Citation_Style.md):
  • Added generic examples for citing variant‑available notes and referenced‑but‑missing declarations.
• Evidence Pack Checklist (Design & Build Workshop/MVP Documentation/Standard Work/reference/Evidence_Pack_Checklist.md):
  • Added generic Certificate/Declaration/Register row guidance; clarified referenced‑only is not acceptable (attach or RFI).
• RFQ Workflow (Discovery Documentation/Safety Shower RFQ Workflow.md):
  • Added generic detection test in early scans (variants/power/evidence) and a CF03 pre‑exit gate test for Variant/Power/Environmental/Regulatory checks.

Grounding (example citations)

• Variant phrase and optioning present: Reference Examples/Q-21699 - Saipem COMP2/Rev 1 Quote Sent/Datasheets and CoCs.md, lines 212–218; 468–471; Q-21699_Technical Offer.md, lines 526–528.
• Power baseline vs offer and transformer feasibility: Spec .../Instrumentation/200-51-IN-SPC-00021_00.md, lines 2020–2049; Offer .../Datasheets and CoCs.md, lines 216–219; Transformer shown in Q-21699_Technical Offer.md, lines 3453–3463.
• Evidence referenced but not attached (register): Rev 1 Quote Sent/Quality Documents.md, lines 741–742; 751–752.

Rationale

• Generic, pattern‑based gates reduce overfit risk while preserving auditability and accelerating decisions across varied examples.

Episode reference

• Source episode: Trial Runs/Q-21699 — Episode 7 (Saipem COMP2)

Template updates (Episode 7)

• Updated Design & Build Workshop/MVP Documentation/Standard Work/templates/Spec_Crosswalk_Template.md examples to repo‑relative paths.

• Added Design & Build Workshop/MVP Documentation/Standard Work/templates/Hazards_Component_Matrix_Template.md.

• Added Design & Build Workshop/MVP Documentation/Standard Work/templates/Decision_Table_Template.md.

• Extended Design & Build Workshop/MVP Documentation/Standard Work/templates/Quality_Documents_Manifest_Template.md with EP Item_ID and Status columns.

• Extended Design & Build Workshop/MVP Documentation/Standard Work/templates/Datasheets_CoCs_Manifest_Template.md with EP Item_ID and Status columns.

• Extended Design & Build Workshop/MVP Documentation/Standard Work/templates/Targeted_RFI_Template.md with a referenced‑but‑missing declarations bullet.

• Extended Design & Build Workshop/MVP Documentation/Standard Work/templates/Metrics_Template.md with variant/power/evidence gate metrics.

• Standards index updated to include: Hazards_Component_Matrix_Template and Decision_Table_Template under Templates & Schemas.

Episode 8 — Q-21699 (Saipem — COMP2) — Decisions & Evidence

Context

• Objective: Close RFIs where possible; lock variant/power; finalize CPQ; refresh annexes.

Accepted refinements (Outputs)

• Hazards Matrix: Variant locked to FLP Ex d per spec §6.4 (200-51-IN-SPC-00021_00, 1771–1780). Statuses converted to Pending Evidence with explicit EP/RFI linkage.
• Decision Table: Power decision set to include step‑down transformer 240→230 Vac for 3 kW heater; notes cite spec 2020–2049 and offer lines 216–219.
• Cross‑walk: Added R‑HAZ‑002 row for Ex d default (lines 1771–1780) to drive component‑level protection concept.
• Evidence Pack: Added parked items — EP‑007 EMC Declaration; EP‑008 ATEX/IECEx Register; EP‑009 IP Certificates Pack — mirrored in manifest and RFIs.
• Handoff Summary: Refreshed to reflect locked variant, power decision, and parked EP items.
• CPQ Mapping: New file Trial Runs/Q-21699 - Saipem COMP2/CF03/output/CPQ_Mapping_Q-21699.md including Ex d transformer and Ex d ancillary enclosures linked to Req_IDs.
• Spec Reference Register: Materialized at Trial Runs/Q-21699 - Saipem COMP2/CF04/output/Spec_Reference_Register_Q-21699.md with EP and RFI linkage.

Rationale

• Enforces Variant/Power/Regulatory gates; improves traceability; readies CPQ pre‑entry list.

Episode 9 — Q-32976 (Tecnmont — SKIKDA) — Onramp Outputs

• SoT: Created Trial Runs/Q-32976/CF02/output/Compliance_Matrix_Extended.csv from template; seeded High‑Risk rows R‑0001..R‑0004 with precise citations; mirrored EP Item_IDs in Decision_Notes per Citation_Style.
• Cross‑walk: Added CF02/output/Spec_Crosswalk_Q-32976.md with Section_Title + Page/Line_Range.
• Hazards: Materialized CF03/output/Hazards_Component_Matrix_Q-32976.md; set weakest_link_flag true pending JB/signage evidence; variant_locked required.
• Decisions: Drafted CF03/output/Decision_Table_Q-32976.md; locked intent to FLP Ex d and 240V 1Ph pending confirmation; captured chiller power variants.
• CPQ: Produced CF03/output/CPQ_Mapping_Q-32976.md with subsystem grouping and Req_ID links.
• Annex: Created CF04/output/Evidence_Pack_Checklist_Q-32976.md, CF04/output/Attachments_Manifest_Q-32976.md, CF04/output/Spec_Reference_Register_Q-32976.md, and CF04/output/Technical_Handoff_Summary_Q-32976.md.
• Gates: Evidence Pack items staged as Parked; CF03 gates enforced (variant_locked, power_decided placeholders, hazards matrix present, weakest_link_flag true); regulatory declarations RFI prepared (EMC/ATEX) referencing Reference Documents/4439-YZ-PC-000000018_1.md lines 4579–4580; 5560–5562; 4627–4629.