When Shield detects an urgent threat to the owner's profit, it sends an immediate alert to the contracts team's channel. This one arrived on a Thursday afternoon, 6 days before the contractor's notice deadline expires.
A contractor claim is forming against the owner on Area 7 pipe rack foundations. The contractor hit unexpected rock during excavation and has sent an informal letter reserving their rights. They are building toward a formal claim for $42.3M in extra cost and schedule delay.
Why this is urgent: The contract gives the contractor 21 days to file a formal notice. If they file it correctly, they can claim. If they miss the deadline or file incorrectly, the owner is protected. The deadline is in 6 days.
Shield found 3 weaknesses in the contractor's position:
1. Their informal letter (C-1187) does NOT satisfy the formal notice requirement
2. Amendment 2 shortened the deadline from 28 to 21 days — the contractor may not know
3. The schedule delay they'll claim (54 days) is not yet substantiated in the P6 narrative
Defense brief ready for your review.
Every morning, Rania also receives a daily email summarizing all threats Shield detected and the owner's defense posture.
Hi Rania,
Shield reviewed 1,204 new documents this week. Here is the owner's claims defense status:
EV-047: Contractor is building a $42.3M claim for unexpected rock in Area 7. They sent an informal letter but have not filed a formal notice yet. Shield found 3 weaknesses in their position. Defense brief is ready for your approval.
The contractor's informal letter does not satisfy notice requirements. Amendment 2 shortened the deadline from 28 to 21 days. Their schedule impact is unsubstantiated. If they miss the deadline or file incorrectly, the owner owes nothing.
| Threat exposure | $42.3M (contractor claim forming) |
| Contractor deadline | 30 Aug 2026 (6 days) — if missed, claim is barred |
| Defense weaknesses found | 3 procedural flaws in contractor's position |
| Defense brief | Ready for your review and approval |
Also monitoring: compressor vendor delay (potential force majeure argument) and PA-19 unbooked costs (possible claim seed).
Contractor building a $42.3M claim against the owner
Excavation crews hit rock 2.3m higher than the ground survey predicted in Area 7. The contractor incurred extra drilling costs and schedule delays. They sent an informal letter reserving their rights and are preparing a formal claim for $42.3M against the owner. Shield assessed the contractor's position and found 3 weaknesses the owner can use to defend.
"...the Contractor shall give notice to the Owner within twenty-one (21) days of encountering physical conditions... failing which the Contractor shall not be entitled to additional cost or time."
"Excavation crews stopped at grid E7-E9. Rock encountered at approx. 2.1m, rig refusal on 3 piles. Awaiting instruction."
"Weathered rock horizon anticipated at 4.5m below grade across Areas 6-8 (boreholes BH-112 to BH-131)."
"...we advise of unforeseen ground conditions in Area 7 and reserve our rights... revised methodology under assessment."
Activities A7-2210 to A7-2265 delayed by 54 days. Pipe rack path went from 21 days of float to 12 days behind schedule.
"Contractor raised Area 7 ground conditions. Owner PM requested 'formal substantiation'. No event logged in change register as of 22 Aug."
Shield drafted a response letter to the contractor that acknowledges the site condition while protecting the owner's position. Every sentence links to its source document.
OWNER'S RESPONSE TO CONTRACTOR RESERVATION — AREA 7 GROUND CONDITIONS REF: JGX-OWN-0047 · DRAFT v1
We acknowledge receipt of your letter C-1187 dated 08 August 2026 C-1187 regarding ground conditions encountered in Area 7.
We note that your letter constitutes an informal reservation of rights and does not satisfy the formal notice requirements set out in Clause 4.12 of the EPC Agreement Clause 4.12 p.88, as amended by Amendment 2 Amd.2 §3.1, which requires formal notice within twenty-one (21) days of the event.
We further note that the schedule impact claimed in P6 Update 26 P6 U26 has not been substantiated in the schedule narrative as required by the contract. The 54-day delay to activities A7-2210 through A7-2265 remains undocumented.
This letter is without prejudice to the Owner's rights under the Agreement. We reserve all positions.
The agent cannot send this response. Evidence pack with 6 documents will be auto-attached to your files.
What happens when you approve:
1. Response letter sent to contractor 2. Evidence pack assembled and filed 3. Event logged in the change register 4. Financial and schedule impact analysis triggered 5. Defense brief prepared for the Monday stewardship meeting
Once Rania approves, the response is sent and Shield automatically kicks off three follow-up tasks. Each runs as a separate agent on the NovaOS platform. Nothing goes out without a person signing off at the end.
◆ Shield APPROVED
Response approved by Rania Khalid. Letter sent to contractor.
📄 Evidence Compilation AUTO
Pulls together the 6 source documents into one evidence file. Links each document to the audit trail so everything is traceable.
📈 Financial & Supply Chain Impact AUTO
Checks what the owner is about to spend money on and flags anything that should be paused or rescheduled because of the claim.
📅 Schedule Validation AUTO
Checks whether the contractor's claimed 54-day delay actually matches what the schedule data shows. Prepares questions for the owner to challenge it.
👥 PMO Director Review HUMAN GATE
Summary of the owner's defense position for the Monday leadership meeting. Generated live from the record each time, then discarded.
Output 1: Defense record
Response letter sent to the contractor. 6 supporting documents bundled together. Event logged in the project register with a full trail of who did what and when.
Output 2: Save money before it's spent
The owner was about to order $1.8M of steel for Area 7. Since the foundations are delayed, that order can wait. Piling rig rescheduled 2 weeks out until the new method is confirmed.
Output 3: Stewardship brief
One-page summary of the owner's defense for the PMO Director. Generated live each time from the record, then discarded. Not a permanent dashboard.
Case study artifacts & the skills that produced them
Every artifact was produced using PM OS, a reusable operating system for product work. Each skill follows a consistent process: gather context, generate a first draft, review from multiple perspectives, iterate.
Product Discovery
- Full Discovery Research — 48 sources, 7 sections
- Discovery Report (Plain English) — full report without jargon
- Validation Quotes by Opportunity — sourced quotes mapped to personas and JTBD
Analysis
- Competitive Analysis — SuperHive, Nodes & Links, full landscape
/competitor-analysis - Impact Sizing — driver tree, three scenarios ($30-80M value, $10-12M ARR)
/impact-sizing - Sub-Agent Review Synthesis — 5-reviewer stress test, 12 findings
/ralph-wiggum/prd-review-panel
Product Specs
- Product PRD — hypothesis, behavior contract, rollout plan, eval framework
/prd-draft - AI Engineering PRD — DAG pipeline, governance kernel, eval suites
/prd-draft --ai - Strategy & Roadmap — thesis, wedge decision, 3-horizon plan
/write-prod-strategy
Prototypes
- Interactive prototype — this demo (Shield Demo tab)
/prototype - Agentic system design — condensed in the System Design tab
/prototype - Eval Harness & Governance Kernel — runnable code with synthetic data
Context
- Orbitron Context Synthesis — product lineup, founder philosophy, platform implications
PM OS — the system behind this case study
PM OS is a reusable operating system for product management work. 41 AI-assisted skills covering the full PM lifecycle, from discovery through launch. Here are the ones used for this case study:
/prd-draftProduct PRD with hypothesis, behavior contract, rollout plan/impact-sizing4-step framework: usage funnel, impact calc, assumptions, takeaways/competitor-analysisCompetitive landscape mapping with positioning/ralph-wiggumDevil's advocate review — catches what you don't want to hear/prd-review-panelMulti-perspective review: engineer, designer, exec, legal, customer/prototypeInteractive prototypes generated from PRD specs/write-prod-strategyStrategy thesis, wedge decision, multi-horizon roadmapOther available skills not used here: /daily-plan /meeting-notes /user-interview /experiment-decision /launch-checklist /feature-metrics /journey-map and 34 more.
All artifacts, research, PRDs, eval harness, synthetic data, and prototype source code.
DAG architecture overview
Shield is a directed acyclic graph (DAG) pipeline. Each node has a defined input, output, and quality gate. LLM where language understanding is the problem. Code where being wrong is unrecoverable. Humans approve every external action.
1. Ingest
Parse & index
code2. Detect
Find threats
LLM3. Map contract
Find clauses
LLM4. Deadlines
Date math
code5. Evidence
Build chain
LLM6. Draft
Write response
LLM7. Human gate
Approve
humanLLM Judgment tasks
Threat detection, clause interpretation, evidence linking, response drafting. Pattern matching across unstructured text.
Code Deterministic tasks
Document parsing, deadline computation, citation verification. Rules engines and date math. Auditable and reproducible.
Human Decision tasks
Defense strategy, response approval, claim valuation. The agent surfaces evidence and drafts; the human owns the decision.
Pipeline walkthrough
Steps 1-2: Ingest + Detect
DR-1042: "Piling rig PR-07 refusal at 2.1 m" GBR 5.3.4: "Rippable material to 6.5 m"
LLM pairs baseline with field observations. Rock at 2.1m vs 6.5m baseline. Change register: no record covers Area 7. Contractor has grounds for a claim.
THREAT: EV-047 | confidence: 96% basis: rock at 2.1m vs 6.5m baseline in_change_register: false
Steps 3-4: Map contract + Deadlines
GC 4.12(b): "notice within 28 days..." Amendment 2: replaced with "21 days"
LLM retrieves clauses, applies amendments. Code computes: 04 Aug + 21d = 25 Aug. Owner response: 01 Sep (6 days left).
contractor_bar: 21d (not 28 -- caught!) contractor_deadline: EXPIRED 25 Aug owner_response: 01 Sep (6 days)
Steps 5-6: Evidence + Draft
C-1187: "We reserve our rights..." No particulars, no records attached.
LLM scores documents for/against owner. C-1187 is bare reservation, doesn't satisfy notice. Code verifies every citation. LLM drafts response.
EP-047: 6 items verified C-1187 insufficient as notice (DEFENSE) Amd 2: 21d bar (may be expired) DRAFT: JGX-OWN-0047 (every sentence cited)
Quality gates
Every node has a testable quality gate. The eval suite runs on a golden set of confirmed events.
LLM Threat detection recall
Missing a real threat is unacceptable. False alarms are tolerable early and reduced over time through the self-improving loop.
Code Citation accuracy
Every citation must resolve to an actual document, section, and page.
Code Deadline accuracy
Date math is code, never LLM. Zero tolerance for errors.
LLM Hallucination in drafts
Every sentence must trace to a source. Citation verifier + human review = double barrier.
LLM Defense position accuracy
"Owner advantage" vs "supports contractor" tagging must match expert assessment.
Human Draft approval rate
If the team rewrites most drafts, the agent isn't learning their style. Edit diffs feed the loop.
Self-improving loop
Gets smarter on your project, without your data leaving.
Agent flags threat
Detection + evidence + draft
Human reviews
Approve, edit, or dismiss
Decision logged
Labeled example in audit trail
Agent retunes
Thresholds, templates, golden set
Dismissals reduce noise
When the team dismisses a false alarm, Shield raises its threshold for that pattern. Fewer irrelevant flags over time.
Edits sharpen drafts
When the team rewrites a response before sending, the edit diff is captured. Draft quality improves to match how the team writes.
Approvals confirm what matters
Confirmed events grow the golden eval set. No update ships unless it passes on all confirmed events. The test suite gets harder over time.
End-to-end recap
| Step | Input | Output | Who | Eval gate |
|---|---|---|---|---|
| 1. Ingest | 6 raw files, 5 systems | Indexed record with provenance | Code | Parse coverage 100% |
| 2. Detect | Baseline + field reports | EV-047 threat, 96% confidence | LLM | Recall 100% |
| 3. Map contract | GC 4.12 + Amendment 2 | 21-day bar (not 28), clause refs | LLM | Expert agreement ≥80% |
| 4. Deadlines | Date anchors | Contractor bar expired, 6 days left | Code | Accuracy = 100% |
| 5. Evidence | Chronology + letters | EP-047: 6 docs, 3 defense advantages | LLM + Code | Citation accuracy ≥99.5% |
| 6. Draft | EP-047 + defense positions | Owner response letter, every sentence cited | LLM | 0 hallucinations, 70% approval |
| 7. Human gate | Draft + evidence | Approved response, audit trail, 5 actions | Human | Named approver required |