How to Write Better AI Prompts for QS Work - Professional Templates and Real Examples
My First AI Prompt Was Embarrassingly Bad
When I first started learning how AI tools work, I wanted to test them on something real, something from my own professional world. So I typed this:
"Generate me 10KM highway road works and calculate the quantity."
The result was, in one word, useless.
The AI produced generic assumptions about a hypothetical highway project, lane widths it invented, pavement thicknesses it guessed, quantities calculated from dimensions nobody had specified. None of it reflected any real project. None of it could be used professionally. It was a demonstration of what happens when you give AI nothing meaningful to work with; it fills the gap with assumptions, and those assumptions are worthless on a live construction project.
But that bad result taught me something important: the problem was not the AI. The problem was me. I had not given it the information it needed. I had expected it to read my mind, and naturally, it could not.
That experience changed how I think about AI prompting entirely. And it led me to develop the methodology and prompt templates that I now use daily in professional QS practice.
This article shares that journey from a useless first prompt to a professional system that saves real time on real projects.
📚 Related Articles You May Find Useful:
The Fundamental Principle: What Makes a Good Prompt
The most important insight I have developed through daily professional AI use is this:
A good prompt acts like a tailored blueprint. A poor prompt forces AI to guess the rules, resulting in generic filler or completely missed objectives.
When I typed "Generate me 10KM highway road works and calculate the quantity", I gave AI no pavement specification, no lane configuration, no structure details, no measurement standard, and no output format. AI had no choice but to invent everything. And invented data is professionally worthless.
When I refined that prompt, providing exact specifications, measurement standard, scope boundaries, and output format, the result was a structured, professionally usable BOQ framework.
The difference between those two outputs was not AI capability. It was prompt quality.
The Junior QS Analogy: The Most Useful Way to Think About AI Prompting
Stop treating AI like a search engine. Start treating it like a brilliant but freshly graduated trainee junior QS.
Think about it this way: if you handed your entire project specification to a junior QS on their first day and said "summarise this by tomorrow", they would panic. They do not know what you need, what level of detail is required, which sections are most important, or what format the output should take.
Instead, a good senior QS gives clear, structured instructions: which section to review, what specific information to extract, what format the summary should follow, and what the output will be used for.
AI requires exactly the same approach. The more specific, structured, and contextual your instruction, the more professionally applicable the output.
Real Example From Useless Prompt to Professional Output
The Bad Prompt : What Not to Do
❌ My First Attempt:
"Generate me 10KM highway road works and calculate the quantity."
Result: Pure assumptions. No real specifications. Professionally useless.
The Professional Prompt The Correct Approach
✅ Refined Professional Prompt:
Act as a Senior Infrastructure Quantity Surveyor.
Provide a comprehensive Bill of Quantities (BOQ) Level-2 structural framework (item descriptions and units only, no prices) for a highway project with these exact specifications:
- Scope: 10-kilometre, 4-lane national highway widening
- Two bridges
- Pavement: Rigid pavement (300mm thick PCCP) on a 200mm aggregate subbase
- 8 Reinforced Concrete Box Culverts (RCBC), full road width, length and culvert width 3m, culvert area no subgrade layer
- Standard: Follow international highway standard measurement based on CESMM
Do not invent cost numbers. Only provide the standard item codes, descriptions, and measurement units (e.g., cu.m., sq.m.).
The difference: The refined prompt specifies the professional role, the exact scope, precise technical specifications, the applicable measurement standard, and clear output instructions. AI has no need to guess everything it needs to produce professional output has been provided.
This is the fundamental lesson of prompt writing for QS professionals: the quality of your output is determined entirely by the quality of your input.
The Real Claim Letter Example Poor vs Professional Prompt
The following comparison is drawn from my professional practice. Both prompts were used to generate a Notice of Claim letter under FIDIC conditions.
Poor Prompt
❌ Poor Prompt:
"Write me a notice of claim letter to the Engineer."
Result: A generic template full of placeholder brackets [Brief description of issue], [insert relevant clause number], [Contractor Company Name], requiring significant professional completion before use. No FIDIC reference. No specific contract context. Not professionally applicable.
Professional Prompt
✅ Professional Prompt:
Act as a seasoned, MRICS-chartered Commercial Manager. Draft a formal, professional contractual letter from the Main Contractor to the Project Manager regarding a delay event.
[Context] We have encountered an unexpected subterranean obstruction during excavation works on Axis 4-C, which is a variation to the contract scope. This has caused a critical path delay of 5 working days. We are obligated to notify them under Clause [Insert Clause Number] to protect our right to an Extension of Time (EOT) and Prolongation Costs.
[Tone & Style] Write this in a highly professional, firm, yet collaborative tone. Avoid overly aggressive language, but ensure our contractual position is legally watertight. Do not use generic AI filler words like "hope this finds you well."
[Structure]
1. Clear subject line with project name and reference number placeholder.
2. Formal opening referencing the specific site event and date.
3. Citation of the relevant contract clause.
4. Clear statement of the 5-day critical path impact.
5. Closing requesting acknowledgment of receipt.
Output only the letter draft with clear [brackets] for information I need to fill in later.
Result: A fully structured, professionally worded FIDIC-compliant Notice of Claim letter ready for professional review and issue with minimal additional work.
The 6 Essential Elements of a Professional QS Prompt
| Element | What to Include | Example |
|---|---|---|
| 1. Contract Type | Always specify the applicable contract form | "Under FIDIC Pink Book MDB Edition" |
| 2. Context | Project situation, what happened, what you need | "Subterranean obstruction on Axis 4-C causing 5 day critical path delay" |
| 3. Professional Standard | Specify the applicable measurement or professional standard | "In accordance with NRM2" or "Apply CESMM4 measurement rules" |
| 4. Output Format | Specify exactly what format you need | "Formal letter" / "BOQ table with item codes, descriptions and units only" |
| 5. Data Instruction | Instruct AI to use real world data not assumptions | "Do not invent cost numbers. Use only the specifications provided." |
| 6. Restrictions | Tell AI what NOT to do | "Do not add information not provided. Strictly follow the provided data only." |
Common Prompt Mistakes QS Professionals Make
Mistake 1: The Vague Scope Request
❌ Poor: "Generate me 10KM highway road works and calculate the quantity."
Result: AI invents all specifications. Output is professionally worthless.
✅ Professional: Specify lane configuration, pavement type and thickness, layer specifications, structures, measurement standard, and output format. Give AI everything it needs, leave nothing for it to assume.
Mistake 2: Providing All Calculations at Once
Providing AI with a large volume of calculation details and asking for a final cost figure carries significant error risk. Break calculations into logical stages and verify each step before proceeding.
Mistake 3: Vague Scope Descriptions
❌ Poor: "Write a scope description for concrete works."
✅ Professional: "Draft a scope for RCC concrete works. Include formwork and rebar reinforcement. Exclude post-tensioning and architectural finishes. Suitable for inclusion in a FIDIC-based contract BOQ."
Mistake 4 — Ignoring the Measurement Standard
❌ Poor: "Create a BOQ for earthworks."
✅ Professional: "Generate this BOQ strictly in accordance with CESMM4 measurement rules. Apply Class E — Earthworks."
Mistake 5 — Asking AI to Do the Math Directly
❌ Poor (High risk of error): "Calculate the total cost of 450 cubic meters of concrete at 4,500 PHP per cubic meter, plus 12% tax and 5% waste factor."
✅ Professional: "Create the Excel formula framework to calculate the total cost of concrete. Provide columns for: Raw Quantity, Waste Factor (%), Total Quantity, Base Rate, Tax (%), and Final Cost. State the mathematical logic clearly so I can input it into Excel."
Professional QS Prompt Library
The following templates are based on my daily professional practice. Save these in a dedicated prompt library document for quick access.
Prompt 1: Specification Summary
You are a professional Quantity Surveyor reviewing a construction specification. Using only the uploaded specification document, prepare a structured summary of [Section Name/Number]. Include key technical requirements, material standards, testing requirements, cost-significant items, and page/clause references for each point. Use only the provided document. Provide the page number reference for every summary point.
Prompt 2: Claim Narrative Report
You are a professional Quantity Surveyor preparing a formal construction claim narrative under FIDIC Conditions of Contract [specify edition]. Using the following factual data [insert data], prepare a professionally structured claim narrative covering: contractual entitlement referencing the applicable FIDIC clause, cause and effect, delay analysis summary, and quantum summary. Maintain a formal professional tone. Strictly follow the provided data only. Do not add assumptions.
Prompt 3: Cost Proposal Narrative
You are a professional Quantity Surveyor preparing a formal cost proposal narrative. Using the provided cost data [insert data], prepare a professional narrative report including: executive summary, basis of estimation, resource allocation (labour, plant, materials), key assumptions and exclusions, and summary cost breakdown by trade. Strictly follow the provided data. Do not add figures or assumptions not included in the provided data.
Prompt 4: Variation Valuation
You are a professional Quantity Surveyor preparing a variation valuation under FIDIC Clause 13 [specify edition]. The variation involves [describe scope]. Engineer's instruction reference: [reference] dated [date]. Prepare a structured valuation including: contractual basis under Clause 12 or 13, measured quantities with unit and rate, application of contract rates where applicable, new rates justification where contract rates do not apply, and summary of additional cost claimed. Use formal professional language. Strictly follow the provided data only.
Prompt 5: RFI Response Draft
You are a professional Engineer/QS responding to a contractor's Request for Information. RFI Reference: [number]. RFI Query: [insert query]. Relevant specification section: [reference]. Using only the uploaded specification and contract documents, draft a formal RFI response that: directly answers the query, references the specific clause or drawing, maintains a professional tone, and does not commit to variations or scope changes. Provide specification page and clause references for every response point.
Build and Maintain Your Own Prompt Library
Every time you develop a prompt that produces high-quality output , save it immediately. Maintain a simple Word or Google Docs document organized by task type:
| Category | Prompt Types to Save |
|---|---|
| Correspondence | Claim notices, variation letters, RFI responses, site instructions, delay notices |
| Commercial | BOQ descriptions, variation valuations, cost proposals, rate analysis |
| Reports | Cost reports, claim narratives, progress reports, meeting minutes |
| Research | Productivity rates, market prices, specification summaries, material standards |
| Analysis | Excel formula frameworks, calculation structures, data organization |
Over time, your prompt library becomes one of your most valuable professional productivity tools a collection of professionally tested templates that can be adapted quickly across different projects.
Conclusion
My first AI prompt, "Generate me 10KM highway road works and calculate the quantity" produced nothing useful. That failure was entirely my own. I gave AI nothing to work with and expected professional output in return.
The refined prompt for the same highway project specifying the lane configuration, pavement type, layer thicknesses, structures, measurement standard, and output format produced a structured, professionally usable BOQ framework.
The difference between those two results is the difference between treating AI like a magic button and treating it like the brilliant junior professional it actually is , one that needs clear, specific, technically detailed instructions to produce work worth using.
Start with the templates in this article. Refine them based on the output you receive. Save every prompt that works. Over time, your prompting skills will become as natural as any other professional tool in your QS toolkit.
The gap between a QS who uses AI effectively and one who does not is not technical knowledge. It is the ability to communicate clearly and specifically. Every professional QS already has that skill. Apply it to your prompts.
💬 Found This Useful?
If this article helped you, please consider:
- ⭐ Sharing it on LinkedIn — your QS colleagues will find the prompt templates immediately useful
- 💬 Leaving a comment below — what was your worst AI prompt experience? Share it below!
- 📖 Reading our related articles — links below
What is your most useful AI prompt for QS work? Share it in the comments!
About The Author
A practicing Quantity Surveyor with extensive experience in large-scale infrastructure projects under FIDIC conditions.
Qualifications:
- BSc (Hons) Quantity Surveying
- MCIOB — Chartered Institute of Building
- MQSI — Quantity Surveyor Institute Member
This blog shares real professional experience from live construction projects — not theoretical content.
📚 Related Articles You May Find Useful:
Frequently Asked Questions
How do I avoid AI making assumptions in my prompts?
Should I use ChatGPT or Claude for QS prompt work?
What is a prompt library, and how do I build one?
How long does it take to develop effective prompting skills?
Can the same prompt be used on different projects?
Comments
Post a Comment