Sheet CAUSA-001Rev. RAFIDIC Red Book 2017GCC · UAE

From delay event to cited EOT claim, in one session.

Five AI agents read your FIDIC contract, surface the evidence, build the dated chronology, draft the cited narrative, and quantify the claim. Every factual sentence is cited; every model call is hash-chained for audit.

Detail · TIME-TO-DRAFTHero event · EVENT-001
Status quo
12 hrs
Read · search · chronology · draft
With Causa Claims
8.2 s
Narrative draft · warm cache · cited
One agent, warm · full 5-agent claim ≈ 60×≈ 5,260× faster
Sheet 01 · How it works

One delay event in; a defensible, cited, quantified EOT claim out — through a fixed five-stage pipeline.

  1. IN
    Delay event
    Contract + 28-doc corpus + programme
  2. D-01
    Contract Reader
    Applicable Sub-Clauses + time-bar
  3. D-02
    Evidence Scout
    Ranked evidence + pull-quotes
  4. D-03
    Chronology
    TS-dated timeline
  5. D-04
    Narrative
    Cited 5-section claim
  6. D-05
    Quantum
    Hudson / Emden / Eichleay
  7. OUT
    Cited claim
    Hash-chained + replayable
Sheet 02 · The Five Agents

A deterministic pipeline.

One LLM call per agent per click. Predictable cost, predictable latency, predictable failure modes. No chains, no streaming JSON, no tool-calling loops — each agent output is validated against a Zod schema before it touches the UI.

D-01
Notice / Entitlement

Contract Reader

Surfaces every applicable Sub-Clause with a verbatim snippet and a notice / time-bar verdict. On the hero event: 5 cited clauses and a critical SC 20.2.4 84-day-deadline warning.

Model
Claude Sonnet 4.6
Latency / cost
~52 s cold · 0 ms cached
D-02
Documentary triage

Evidence Scout

Ranks the 28-document corpus and returns the top matches with verbatim pull-quotes and 0–100 relevance scores. Runs on GPT-4o — proof the agent contract is provider-agnostic, both providers in one hash chain.

Model
OpenAI GPT-4o
Latency / cost
~25 s · $0.05
D-03
Dated timeline

Chronology Builder

Builds a strictly-dated timeline from frontmatter dates parsed in TypeScript — the LLM never invents a date. It only labels and grades each of the 28 entries (critical · material · minor).

Model
Claude Haiku 4.5
Latency / cost
~30 s · $0.028
D-04
Cited claim section

Narrative Drafter

Writes the five-section EOT narrative. Every factual sentence carries a [DOC-XXX] / [CONTRACT-CL-X.X] / [PROG-XXX] citation; uncited claims are flagged [unverified] inline by the post-processor.

Model
Claude Opus 4.7
Latency / cost
~60–90s cold · 0 ms cached
D-05
Prolongation cost

Quantum Calculator

Quantifies prolongation cost — Hudson · Emden · Eichleay overhead + site + finance. The numbers run in TypeScript; the LLM only picks the recommended formula and writes the case-law rationale.

Model
Claude Sonnet 4.6
Latency / cost
~10s · $0.015
Sheet 03 · Trust Log

Every model call. Hash-chained.

An agent_calls row is written for every agent invocation, with a SHA-256 row hash linking back to the previous row. The lawyer or arbitrator can replay the exact input, output, model, latency, cost, citation count and uncited-flag count of every step — and verify the chain end-to-end.

  • Hashsha256(prev ‖ canonical row JSON)
  • RLStenant_id ∈ current_user_tenants()
  • RetentionPostgres · 7 yr archival in Phase 1
  • ReplayDeterministic, cached, click to view
agent_calls (excerpt)tenant: Mirzam Bridge Project
contract_readerclaude-sonnet-4-65$0.04989f4c8a1b3e7d2f56…
evidence_scoutgpt-4o · openai12$0.06002b71e0d3a8c945f2…
chronology_builderclaude-haiku-4-528$0.0369fa3c91d6e428b07d…
narrative_drafterclaude-opus-4-7116$0.99217c1a4f90b2e6d385…
quantum_calculatorclaude-sonnet-4-60$0.0281d5e8a37c1f409b62…
Sheet 04 · Demo Project

Project Mirzam — Rail Bridge UAE

Mirzam Bridge Contractor JV · NTP 01 Mar 2025

A synthetic four-span composite rail bridge over a main highway corridor, authored from industry MENA delay typology research. The hero event is a textbook concurrent delay — an undisclosed 33 kV utility cable + a piling rig hydraulic failure — with Notice issued on Day 26 of the 28-day SC 20.2.1 window.

28
Documents
6
Clauses
4
Events
1
Hero event
27
Days EOT sought
Day 26 / 28
Notice issued
Sheet 05 · Methodology

Grounded in the standard the GCC actually uses.

FIDIC

Red Book 2nd ed (2017) — Sub-Clauses 8.4 Advance Warning, 8.5 EOT, 8.6 Delays Caused by Authorities, 18.4 Exceptional Events, 20.2.1 Notice of Claim, 20.2.4 Fully Detailed Claim.

SCL

Delay & Disruption Protocol 2nd ed (Feb 2017) — Time Impact Analysis (MIP 3.7), As-Planned vs As-Built Windows (MIP 3.3), Collapsed As-Built, Impacted As-Planned, Core Principle 10 on concurrency.

AACE

International RP 29R-03 Forensic Schedule Analysis; RP 90R-22 Schedule Quality Index. Cross-validation of programme integrity.

GCC

Industry MENA delay root-cause typology research · UAE Civil Code (good faith, abuse of right) · DIFC arbitration seat practice.

Sheet 07 · Beyond the Demo

The roadmap, already prototyped.

Three capabilities the hackathon deliberately scoped out are live in the Lab — real, not mocked: AI document ingestion, a programme / XER parser, and semantic retrieval on real OpenAI embeddings + pgvector. Sign in to try them on the demo project.

T-201

Document Ingestion

Paste or upload a raw document — a real LLM pass extracts the structured fields a claim needs (type, date, parties, title, event links).

OpenAI GPT-4o-mini
T-202

Programme / XER Parser

The parsed baseline activity network with critical path, plus a decoder for a pasted P6 XER export's TASK table.

TypeScript
T-204

Vector Retrieval

Semantic search over the corpus on real OpenAI embeddings + pgvector cosine — the retrieval layer that scales past full-context.

pgvector + embeddings
Sheet 06 · FAQ

Questions a QS or counsel asks first.

Is this legal advice?

No. Causa Claims produces a cited first draft to accelerate the Contractor's team. A qualified QS and construction counsel review and sign off before anything is submitted.

How do I trust the citations?

Every factual sentence must cite a [DOC-XXX], [CONTRACT-CL-X.X] or [PROG-XXX] source. A post-processor validates each citation against the real source-ID set and flags any uncited factual sentence as [unverified] — so a hallucinated claim is visually loud, not hidden.

Does the AI invent dates or numbers?

No. Chronology dates are parsed from document frontmatter in TypeScript, and the Quantum formulae (Hudson / Emden / Eichleay) run in TypeScript. The model only writes prose and picks among typed options — it never computes a number.

Which contracts does it support?

The demo runs on FIDIC Red Book 2017. The methodology library and clause set extend to Yellow / Silver and the 1999 suite in Phase 1.

Can I use my own project documents?

The hackathon demo uses a fixed synthetic project. Bring-your-own-data — document upload, P6/XER programme import and corpus-scale retrieval — is the first Phase-1 milestone.

What happens to my data?

Every tenant is isolated by Postgres row-level security. Each agent call is written to a SHA-256 hash-chained audit row a lawyer or arbitrator can replay end-to-end; tampering with any field breaks the chain.

How is this different from ChatGPT or a general legal-AI tool?

It is FIDIC-aware, enforces a hard citation contract, computes quantum deterministically in code, and produces an arbitration-grade audit trail — none of which a general drafting tool does.

See a 27-day EOT claim assembled in one session.

Sign in as the Contractor's PM, QS or Counsel and run all five agents on the hero event — Notice issued on Day 26 of 28.

Try the demo
Causa Claims · FIDIC EOT drafting in minutes