Concepts / Contract Issue Identification

Contract Issue Identification

The demo session ran a contract analysis script on five real inbound contracts, producing a memo for each that the deputy GC read.

  • Programming

Why a Live Demo Comes Before Trust

Before a team trusts an automated contract review tool, someone has to watch it work on real material and judge the result. This article follows one such moment: a demo session in which a contract analysis script was run in front of a deputy general counsel (deputy GC). The session is a useful case study because it shows the whole loop, from a live contract going in, to a memo coming out, to human feedback being turned into something the team can keep and reuse.

The setting was simple. The session took place on a Friday afternoon in the deputy GC's office. She used her own laptop, and the keyboard stayed in her hands the whole time. The contracts were not sample documents. They were five real inbound contracts that had been pulled from her email that same morning. Working with live material is what separates a demo from a test: the questions being asked are the ones the business actually cares about.

Following One Contract Through the Session

The core interaction is a single action repeated for each contract. A contract is dragged into the script. The script then runs, which took fourteen seconds on the contract in this session, and it produces a memo. The memo is the artifact the reviewer reads. The script's job, in other words, is to turn a raw contract into a readable document that a lawyer can check against her own judgment.

Load contractDragged into the scriptRun scriptTook fourteen secondsProduce memoReadable documentDeputy GC reads memoChecks against her judgmentVerbal responseVerdict, plus reason ifnegativeRecord feedbackKept for reusecontract inmemo outmemo openedjudgment spokenfeedback written
In what order do the steps run, and which step hands off to which? The script sits between the contract and the reader; the reader's response comes after the memo exists.

Notice the order. The reader's response is a separate step that happens after the memo exists, not while the script is running. The script does not decide what the reviewer concludes; it supplies the material for that conclusion. Once the memo was open, the deputy GC read it and gave a short verbal response on each of the five contracts. For most contracts the answer was simply yes. For two, she named a specific problem.

How a Flag Becomes an Eval Case

It helps to think of each contract as moving through a small set of states. It starts with no known issue, moves to an issue being flagged when the reader identifies one, and then can move on to becoming a stored eval case. A label is the answer the case is checked against. In this session, both flagged contracts were added as eval cases before the demo ended.

No known issueStarting stateIssue flaggedReader identifies a problemLabel attachedHuman-supplied answerStored eval caseReusable after the meetingreader flagsanswer recordedsaved
Where does a flagged issue travel after the reader identifies it, and what is added along the way before it is saved as an eval case?

The label on case #44 is worth dwelling on. Here the answer came from a human reviewer, the deputy GC, rather than from the script. That is why the session is useful as a source of evaluation material: the human judgment is written down in a form that can be reused, instead of living only in the memory of the meeting. The corrected risk grade served as the label for the indemnity case.

Worked example

Tracing the indemnity issue to case #44

The script produced a memo for a contract with an indemnity clause. The deputy GC judged the risk grade to be wrong. What happens to that judgment?

  1. 1
    Script output

    The memo contains a risk grade on the indemnity that the reader does not accept.

  2. 2
    Issue flagged

    The reader identifies the misgraded indemnity risk within the ninety-second window after engaging with the memo.

  3. 3
    Corrected grade recorded

    The corrected risk grade is written down as the answer the case is checked against.

  4. 4
    Eval case stored

    The flagged issue, with its corrected grade as label, is saved as case #44 before the demo ends.

Result

The human judgment survives the meeting as a reusable test case, not just a remembered comment.

Two Different Kinds of Issue

The two flagged contracts were not the same kind of problem. Seeing them side by side makes the difference clearer than describing either one alone. One problem was a missed clause: the script did not surface an auto-renewal clause in section 12 of one contract. The other was a judgment problem: the script assigned a risk grade on an indemnity that the reader judged to be wrong. The first is a gap in what the memo contains; the second is a disagreement about what the memo says.

Missed auto-renewalclauseSection 12 of one contractMisgraded indemnityriskRisk grade judged wrongNamed locationReader pointed to section12Corrected risk gradeUsed as the case labelfeedbackfeedback
How do the two issue types differ, and what different feedback did each one lead to?
FeatureMissed auto-renewal clauseMisgraded indemnity risk
Where the problem sitsSection 12 of one contractRisk grade on an indemnity in another contract
What went wrongA clause was not caughtA grade was judged to be wrong
Feedback givenA specific location named by the readerA corrected risk grade
Use in the eval setFlagged and added as an eval caseCorrected grade served as the label for case #44

The two flagged issues differ in kind and in the feedback each produced.

What Five Contracts Can and Cannot Show

Of the five contracts, two had issues, and both were flagged within ninety seconds. The speed matters less as a benchmark than as a sign of how the review was structured: the flagging happened immediately after the reader engaged with the memo, while the contract and its memo were still fresh. Ninety seconds covers the reading and the decision, not the script's fourteen-second run on its own.

Five contracts is a small sample, so the demo is best read as a source of specific, reusable feedback rather than a complete performance measure. It can show that the script produced readable memos on real inbound material, that a reviewer could find two concrete problems, and that those problems could be turned into stored cases. It cannot show how often the script misses issues across a full contract portfolio, nor how it performs on contract types that did not appear in this session. Answering those questions would require a larger or different evaluation.

  • Common mistake

    Treating the ninety-second figure as the script's speed

    Why it fails

    The window covers reading and deciding; the script itself took fourteen seconds on the contract in this session.

    Do this instead

    Report the script's run time and the review time as separate measurements.

  • Common mistake

    Reading five contracts as a measure of overall accuracy

    Why it fails

    Five is a small sample, and the demo tells you about these specific contracts only.

    Do this instead

    Use the demo to collect specific, reusable cases, then plan a larger evaluation for performance claims.

  • Common mistake

    Assuming the script decides what counts as correct

    Why it fails

    In this session the label came from the human reviewer, not from the script.

    Do this instead

    Record the human judgment as the label so the eval case checks the tool against it.

Predicting the Order of the Session

What do you think happens?

For one contract, which happens first: the deputy GC gives her verbal response, or the script produces the memo?

  • The verbal response comes first

  • The script produces the memo first

Reveal answer
Answer:

The script produces the memo first.

The script runs on the contract and produces a memo; the reader reads that memo and then gives her verbal response. The reader's response is a separate step after the memo exists.

MEDIUM

Using only the demo session, explain in two or three sentences how a contract issue flagged by the reader ends up as a stored eval case. Name the step where the human judgment is recorded and say why that record matters.

Hints
  • Start from the reader's verbal response and follow it forward.
  • Think about what the label on case #44 was taken from.

Key Takeaways

  • The demo ran a contract analysis script on five real inbound contracts; the script turned each contract into a memo, and the deputy GC read each memo and gave a verbal response.
  • Two contracts had issues, both flagged within ninety seconds: a missed auto-renewal clause in section 12 and a misgraded indemnity risk.
  • Both flagged issues were added as eval cases before the demo ended, with the corrected risk grade serving as the label for the indemnity case.
  • A five-contract demo is best used to gather specific, reusable feedback; it cannot by itself measure the script's overall performance.