← Home
Scope
Scope
Writing Agent
Hold a draft trade scope up against what has actually been issued before. It shows the items that are probably missing and how often they appeared, flags loose wording, asks the questions a sharp reviewer would, and exports the confirmed scope. A challenge tool, not an autopilot.
- Tool
- 006 / Tendering
- Role
- Designed + built
- Inputs
- Draft scope: Word, PDF, Excel
- Outputs
- Gap analysis, confirmed Word scope
01 The review
Trade & type ✓Draft uploaded ✓ReviewExport
Confirmed 24Possibly missing 3Flagged 2Questions 4
| Possibly missing | Seen in | |
|---|---|---|
| Temporary power during the works | 9 of 11 scopes | Add Not needed |
| Testing and commissioning records | 10 of 11 scopes | Add Not needed |
| Making good after cable runs | 7 of 11 scopes | Add Not needed |
Flagged wording
Line 14
“as required” is open-ended: required by whom, and to what standard?
Line 31
“allow for builder’s work” doesn’t say who supplies what
Work through it
AgentWho provides the interface to the fire panel, you or the fire contractor? Past scopes split on this.
YouThe fire contractor. Add that as an exclusion.
AgentAdded to exclusions. Two questions left on line 14.
Export confirmed scopeFlag a gap we missed
Illustrative sample data
02 What it does
A second pair of eyes with a long memory.
- ComparesYour draft is checked against past scopes for the same trade and project type, so the comparison is like for like.
- Surfaces gapsLikely-missing items come with how often they appeared, so a gap is evidence, not a hunch.
- Challenges wordingAmbiguous phrases are flagged and turned into clarifying questions to resolve before tender issue.
- Confirms and exportsNothing goes in the output until you confirm it. The result is a clean Word list ready for the tender pack.
- Says when it doesn’t knowWith fewer than three comparable scopes it tells you so and marks the result low confidence.
03 The library behind it
IngestLibrarySuggestionsFeedback
| Trade | Type | Items | Source | |
|---|---|---|---|---|
| Electrical | Fitout | 28 | Confirmed by the author at export | Promote Dismiss |
| Mechanical | Refurbishment | 34 | Confirmed by the author at export | Promote Dismiss |
| Joinery | New build | 19 | Uploaded by an admin | Review items |
Every scope that gets exported becomes a suggested addition · a person reviews it before it joins the library, so one bad scope can’t poison the gap detection
Illustrative sample data
04 How it’s built
All the intelligence lives in the library, so it gets better with every scope issued.
- ServiceA Node.js and Express service backed by Postgres, deployed to Railway, with two parts sharing one database: an admin ingestion tool and the author-facing agent.
- Reading filesText is extracted from Word, PDF and Excel files, and duplicates are caught by a content fingerprint so the same scope isn’t counted twice.
- Gap analysisThe AI compares the draft with a frequency map built from the library for that trade and type, then returns structured findings the interface can render.
- Sessions and exportReviews are saved so you can come back (for seven days), and the confirmed scope is generated as a Word file in code.
- Human in the loopNothing enters the library without a person confirming it. Authors can also flag a gap the agent missed.
StackNode.jsExpressPostgresReact 18Word, PDF and Excel parsingContent fingerprintingMultiple LLMsWord generationRailway