Contract Instruction Agent

The Contract Instruction Agent drafts contract instructions, site instructions and principal agent, project manager or engineer instructions in the correct form for your contract. It checks that the issuer has the authority to give the instruction, whether it changes the works and counts as a variation or compensation event, and estimates the likely cost and time impact. Every instruction is logged in a numbered register that the quantity surveyor uses for valuations and the final account.

Ideal forPrincipal agents

The difference

From 1-2 hours per instruction to 15-20 minutes

Principal agents issue instructions the same day with the cost and time picture attached, and the quantity surveyor starts each valuation from a clean register.

Done by hand

1-2 hours per instruction

With the Vanine agent

15-20 minutes

Time returned to your team

80%

Indicative figures. We measure your own baseline in the first fortnight so the numbers you see are yours.

Instructions that hold up contractually

Informal instructions given verbally or on WhatsApp are a common source of disputes. Issuing them in the correct form, by the right person, protects both employer and contractor.

No surprise variations

Knowing early that an instruction changes scope, cost or time lets the client approve the budget impact before work proceeds, rather than discovering it in the final account.

A complete register for the final account

Every instruction numbered, dated and linked to its cost estimate makes valuations, cost reports and final account negotiations faster and less contested.

Capabilities

Instructions in the right contract form, checked for authority, cost and time.

Built for principal agents, project managers, engineers and quantity surveyors at South African consulting practices and client organisations administering JBCC, NEC, GCC 2015 and FIDIC contracts.

Correct contract form

Drafts instructions with the terminology and clause references of your contract: JBCC contract instructions from the principal agent, NEC project manager instructions, or engineer's instructions under GCC 2015 and FIDIC.

Authority check

Checks the instruction against the authority in the contract data and appointments, and flags instructions from someone without authority or above a client approval limit.

Variation and compensation event test

Assesses whether the instruction changes the works, making it a variation under JBCC, GCC 2015 or FIDIC or a compensation event under NEC, and flags the notice and quotation steps that follow.

Cost and time estimate

Prepares an indicative cost impact from BoQ rates or the activity schedule and an initial view of the programme impact, for the quantity surveyor and planner to confirm.

Instruction register

Numbers and logs every instruction with date, issuer, description, contract reference, status, and estimated and agreed values.

Site instruction confirmation

Picks up verbal or informal instructions recorded in minutes, emails and site messages and prepares them as formal instructions for confirmation, so nothing is left undocumented.

How it works

From your systems to a result you sign off

The principal agent, project manager or engineer reviews and signs every instruction, and the quantity surveyor values any variation. Budget approval for scope changes stays with the client.

SharePointOutlookTeamsExcelWordAdobe
Any system you use
Connects

Connect the places your contract instructions already live.

The contract, contract data and appointments, the BoQ or activity schedule, the programme, and instruction requests from minutes, email, Aconex or Procore. Already use something else? We connect that too.

  • OpenAI Frontier
  • Your own AI platform or models
  • Microsoft 365 (Teams, SharePoint, Outlook, Excel)
  • Copilot Studio
  • Aconex
  • Procore
  • Candy and WinQS
  • DocuSign or Adobe Sign
Works in

Runs on request in Teams, Copilot Studio or OpenAI Frontier, or on your own AI platform, using the models your organisation approves.

Correct contract form
Authority check
Variation and compensation event test
Cost and time estimate
Instruction register
Site instruction confirmation
Delivers to

A draft instruction in Word on your contract form or letterhead, an updated instruction register in Excel and a cost and time note for the quantity surveyor.

Step by step

  1. 01

    A change is requested by the team or an informal instruction is picked up from minutes.

  2. 02

    The agent drafts the instruction in the correct contract form and checks the issuer's authority.

  3. 03

    It tests whether the instruction is a variation or compensation event and flags the notice steps.

  4. 04

    It estimates the cost and time impact and logs the instruction in the register.

  5. 05

    The principal agent or project manager reviews and signs the instruction, with client approval where needed.

  6. 06

    The signed instruction is issued and the quantity surveyor values it for the next payment certificate.

Deployment

Runs inside the tools your team already uses

The same agent and the same cited output, delivered three ways: through the AI assistant you have rolled out, on a model you host yourself, or inside your own software.

Model Context Protocol

In the frontier assistant you already pay for

We publish the agent as an MCP server. Add it as a connector and your team calls it from the chat they use every day, with no new tool to learn.

Adopting frontier AI across your teams
Called from ClaudeMCP connected

"Can this person issue the instruction?"

Toolcontract_instruction.check_authority
contract
JBCC PBA
instruction
CI 047
ReturnedAuthorised, limit appliesEvery finding linked to its source document
Self-hosted

On a model you host yourself

Run the agent on open-weight models in your data centre or private cloud. Your contract instructions never leave your network, which keeps POPIA and data residency straightforward.

  • Llama
  • Mistral
  • Ollama
  • or any OpenAI-compatible endpoint
Sovereign AI on your infrastructure
Bespoke systems

Inside your own software

Trigger a run from your own workflows, and push the finished output into your ERP, GRC or reporting systems. We build the integration with your team.

  • REST API
  • Webhooks
  • Batch jobs
  • Embeddable review panel
Custom integrations from our software factory
Governance

Governed the same way, every route

Whichever way your team reaches the agent, identity, permissions and audit stay with your existing controls.

  • Single sign-on through Entra ID, Okta or Google Workspace
  • Reads only the documents each user is already allowed to open
  • Every tool call written to an audit log you can export
How your data is handled

DATA SECURITY & PRIVACY

Your contract instructions stay yours.

The agent runs inside your tenancy, reads only what each task needs, and never trains on your contract instructions. Every step is logged so your auditors can see exactly what it touched.

Built for regulated work.

+
WHAT THE AGENT KEEPSONLY THE OUTPUTENCRYPTED AT REST0 BIT AES0% DELETABLE0 TRAINING RUNS

YOUR CONTRACT INSTRUCTIONS NEVER LEAVE YOUR ENVIRONMENT

Precision AI for Institutional Workflows

Build once.Deploy across teams.Improve over time.