ARC · PLAN AND COST REVIEWS

Vertex PCR FAQ

Quick answers on how to use ARC, from uploading your project documents to answering the PCR in Word.

Watch the demo videos

The web application, the Word assistant, and what to do when something isn’t working as expected.

An archival photograph of a suspension bridge with a barge passing beneath

Getting started

What reports does ARC work with?

You can use ARC whenever you are writing a Plan and Cost Review (PCR) on the Vertex PCR template. The Word document you download is your own PCR template, with your cover page, letter, Executive Summary, Project Review and attachments.

The Limited PCR template is coming soon!

Can a colleague or reviewer work on my report?

Yes. Anyone in your organization can open the Word document and use the assistant on it. They see the same suggestions and documents, and the assistant shows who authored the report.

Which sections does ARC write for a PCR?

ARC suggests answers to over 200 template questions, across these sections:

  • Executive Summary: 01. Project Description and 02. Project Team.
  • 01. Owner/Contractor Agreement Review: 01a to 01g, from the contract summary to the GC's license.
  • 03. Construction Schedule
  • 04. Geotechnical Review
  • 05. Hazards Review: environmental, flood zone, seismic and other hazards.
  • 06. Governmental Regulations: code, zoning, permits, ALTA survey and utilities.
  • 07. Owner/Architect Agreement Review and 08. Owner/Engineer Agreement(s) Review
  • 09. Loan Agreement Review

You write these sections yourself: Key Comments and Recommendations, the Cost and Schedule Analyzer, 02. Cost Review, 10. Drawings and Specifications Review, the Replacement Reserve Analysis and the attachments. Their documents are still in Inputs, so you can review them without leaving Word.

What should I upload for a PCR?

Upload every document you'd normally review. Each one feeds the sections that need it:

  • Owner/Contractor Agreement, its exhibits and change orders: Section 01.
  • Construction schedule: Section 03.
  • Geotechnical report, its addenda and reliance letters: Section 04.
  • Phase I ESA: 05a. Environmental Review. ESA questions are answered from the ESA only.
  • Flood determination or FIRM panel: 05b. Flood Zone.
  • Zoning report, permits, ALTA survey and utility will-serve letters: Section 06.
  • Owner/Architect and Owner/Engineer agreements: Sections 07 and 08.
  • Loan agreement: Section 09.
  • Developer's PCR questionnaire: answers across many sections.
  • Drawings and specifications: the project description, and available in Inputs for your own review.

If a document is missing, the questions that depend on it come back as Not identified. instead of a guess.

Web application

How to create a report

  1. Sign in to the web app and click Create report.
  2. Choose the report type: Plan and Cost Review.
  3. Add the site address if you have one. Start typing and click it when it appears. The rest autofills.
  4. Assign a project number. This becomes the project title, which is also the Word document's filename. You can delete it and write a custom one.
  5. Optionally add a building or property name, and the client.
  6. Upload your files, then click Upload & Generate Report.

My project doesn't have a street address yet

The address is optional for a PCR. Leave it blank, or enter only the city, state and country. Once you enter one of those three, all three are needed. You can add the full address later, when the project gets one.

How to add client information

Add the client in the report information step. Search for an existing client, or create a new one in place. Their details populate in the report automatically.

How to add multiple addresses

If the project covers more than one site or parcel, click Add another address in the report information step. There's no limit, and you can remove any address you no longer need. You can also come back and update addresses or site information at any point after the report is created.

What to know during document upload

  • Drag and drop, click to select files, or choose a whole folder.
  • Accepted: PDF, Word (.docx), Excel (.xlsx, .xlsm), CSV, text files and photos (JPG, PNG, HEIC, TIFF and more). Scanned PDFs are read too.
  • Not accepted: .doc, .xls, emails (.msg, .eml) and ZIP files. Save older Office files in the newer format, save emails as PDF, and extract ZIP files before you upload the folder.
  • Max file size is 150 MB. Anything larger is flagged and skipped.
  • Password-protected PDFs are flagged. Remove the password and upload them again.
  • Duplicates are flagged, and the same file is never uploaded twice.
  • There's no practical file limit, so upload the full document set.
  • The list on the upload screen shows every file, and the reason for any file that was skipped. Check it before you continue.

My document is larger than 150 MB

Split the PDF into parts and upload each part. For a drawing set, split it by discipline (architectural, structural, MEP, civil). For an ESA, split the report body from its appendices. ARC reads every part.

How to add more documents after you've exported the report

Open the report in the web app and drag and drop the new files in, exactly as you did the first time. The assistant picks up the new inputs automatically, so you don't need to download the report again. This works for a revised contract, an updated schedule or a new drawing set.

What does "New template available" mean?

We've improved the PCR template since you created this report. Click Update to regenerate the report on the new template.

Updating is permanent. The report's current suggestions are replaced, and you need to download the Word document again. Your previous download no longer works with the assistant. Update before you start writing, not halfway through a report.

Documents & sources

How ARC decides which documents answer each question

During upload, ARC identifies each document's type, for example Contract, Schedule, Geotechnical, Environmental or Loan agreement. Each question then reads only the document types that should answer it. The environmental questions read the ESA, the geotechnical questions read the geotechnical report, and so on.

This keeps answers to the right source. For example, an appraisal that mentions an ESA can't answer the ESA questions for it.

How to check what type ARC gave a document

Every document card shows its type, in the web app's Documents tab and in the assistant's Inputs tab. In the assistant, open a document to see its full details.

A document was identified as the wrong type

If, for example, your ESA shows as a general report, the questions that need it will come back as Not identified. You can't change a document's type yourself yet. Call or text us and we'll correct it for you.

Why does an answer say "Not identified."?

ARC didn't find a supported answer in the documents that question reads. Usually one of three things happened:

  • The document wasn't uploaded.
  • The document was identified as the wrong type. Check its type in Inputs.
  • The document doesn't say. For example, a draft contract with blank dates.

ARC never writes No. for missing information. No. means a document confirms the negative.

How to upload a contract package

Upload the Agreement (for example AIA A102), the General Conditions (A201), exhibits and change orders as separate files, with filenames that say what each one is. If ARC quotes the General Conditions where the Agreement governs, use Refine to point it to the Agreement, and tell us so we can fix it for every report.

ARC Assistant in Word

How to navigate the assistant

Open the Word document you downloaded from the web app, go to Add-ins, and open the assistant. Sign in if you aren't already. The assistant starts working immediately.

Two ways to move around:

  • Follow cursor (default). The assistant tracks whatever section you're typing in, down to the subsection, for example 01c. Contract Costs. Use this for most of the report.
  • The dropdown at the top. Jump to any section or subsection. The assistant jumps to the section you pick, but you still have to move your cursor there yourself.

At the bottom, Writing gives you suggestions and Inputs gives you the documents for the section you're in.

My assistant isn't following my cursor

Click Follow cursor. When it lights up blue, it's tracking you.

How to insert an answer over the template text

Select the template's placeholder or instruction text, then click Insert text. The answer replaces your selection and takes on that paragraph's font and spacing, so you don't need to delete the old text first or reformat the new text.

How to insert an answer into a table

Click into the first empty cell you want to fill, then click Insert text. The answer's rows fill the table from that cell onward. Text is added to each cell, not swapped in, so start from empty cells.

Writing support

What does Evidence support mean?

Each suggestion shows how well the documents back what it says:

  • High. A document directly states every claim.
  • Medium. Some claims are inferred or only partly supported. Check them against the sources.
  • Low. The evidence is weak or conflicting. Verify before you insert.
  • No evidence. No document supports the suggestion.

Use these to focus your review. Check every Medium and Low answer against its sources, and spot-check the High ones. A low score isn't a reason to throw the suggestion out. It's a signal to open the evidence and check it before inserting, or to refine the suggestion.

Tips to refining a suggestion

  • Refine with a preset: Shorter, More formal or Add detail.
  • Describe a change and submit it: "use the date of the schedule, not the start date," or "the bonds are only required at the owner's option, check the questionnaire."
  • Check the box beside a paragraph, list item or table when you only want part of a suggestion.
  • Version history keeps every version. Restore an earlier one if a refine made it worse.
  • Insert text drops it into the document, or copy it and paste as normal.

Then edit in Word like any other text.

How to find the evidence behind an answer

Click any source under a suggestion. The document opens at the cited page, with the quoted text highlighted. Each source also shows the fact it contributed.

If the source you expect isn't there, start with Refine and ask ARC to find the evidence that backs the claim. If that isn't enough, go to Inputs and browse the section's documents, or switch to All sections.

ARC keeps making the same mistake across questions

Refine only changes the suggestion you're on. There's no report-wide correction yet. If you see the same mistake on several questions, for example quoting the General Conditions where the Agreement governs, tell us. Use thumbs down with Wrong sources, or call or text us. We fix the PCR template, and the fix applies to every report after it.

How to give feedback on a suggestion

Use thumbs up or thumbs down on any suggestion. On thumbs down, pick the reason (Inaccurate, Missing info, Wrong sources or Wording) and add a note. Send & refine sends the feedback and rewrites the suggestion. We review every piece of feedback.

Documents in Word

How to look at my inputs

Go to the Inputs tab at the bottom. It shows the documents for the section you're currently in, ranked by relevance. Switch between Show documents and Show photos, and open any document to read it full-size.

How does the sorting of inputs work

By default, inputs are ranked by relevance to your current section, which the system sorts during upload. What you see first is what we've determined matters most for what you're writing.

You can also:

  • Sort newest to oldest, oldest to newest, or alphabetically
  • Filter by document type, for example Contract or Schedule
  • Search by keyword

Under All sections, relevance ranking doesn't apply, so only date and alphabetical sorting are available.

How to find a document if it's not showing up in the assistant

Input selection isn't perfect. Two ways to find something:

  1. Search it. In 04. Geotechnical Review and the reliance letter isn't surfacing? Search "reliance" and everything matching comes up.
  2. Browse everything. Switch to All sections to scroll through every document you uploaded, or filter by type.

How to switch to All sections

In the Inputs tab, open the section dropdown at the top and choose All sections. Clear the search bar if you have a term in it, or you'll still be filtered by it. From there, choose Show documents or Show photos and scroll through everything on the report.

How to add site observation photos

Upload your site photos with the rest of your documents. In Word, place your cursor in Attachment G, or select a picture placeholder there, then insert a photo from Show photos in Inputs. A selected placeholder is replaced by the photo.

Troubleshooting

My assistant isn't loading or is blank

  • Close the assistant and reopen it. Click the x in the top right corner.
  • Reload it. Click the i icon in the top right corner and hit Reload.

I can't upload a document

  • Check the file list on the upload screen. Every skipped file shows the reason.
  • Files above 150 MB aren't accepted. Split the PDF into parts.
  • .doc, .xls, email and ZIP files aren't accepted. See What to know during document upload.
  • Remove the password from protected PDFs.

My report is stuck in generation

  • Reports can take 5+ minutes to process, especially if there are a lot of inputs or large files. The export button shows progress: first Processing inputs, then Generating sections.
  • If it hasn't been five minutes yet, wait.
  • Refresh the page.
  • If the report shows Failed, regenerate it. Click the three dots in the top right corner of the report details page and select Regenerate Report.
  • If you are still experiencing issues, contact an ARC team member for support.

The assistant says my report was regenerated

The report was updated to a new template, so this Word document no longer connects to it. Click the link in the banner to download the latest version, then continue in the new document.

HERE TO HELP

Blocked on a report?

If the demo videos and this FAQ don’t answer your question, call or text us.

Someone from our team will answer between 8 am and 9 pm (EST).

Matthew McLellan

Co-Founder, CEO

647 567 6231

Marc Fielding

Co-Founder, COO

416 302 6533

Alexa Wight

Director of Operations

647 205 0904