Nexus Engineering Logo
Nexus Engineering Systems • Coordination • Clarity
Nexus Engineering Logo
Nexus Engineering Systems • Coordination • Clarity

Intent Is a Deliverable

In international delivery environments, the most expensive QA/QC failures are rarely technical. They are interpretive.

Markup comments carry intent, constraints, and acceptance criteria. When that intent does not survive handoffs, projects drift quietly. Everyone believes they understood, and the cost only reveals itself later as rework.

I now treat this as a delivery rule: If intent is not preserved, the deliverable is incomplete.

To reduce that risk, I implemented a simple closure loop designed for real teams under deadline pressure. It does not depend on perfect communication or long SOPs. It depends on visibility, ownership, and proof.

The Core Problem: Information Synthesis

When data arrives with comments, the risk is rarely technical. The risk is human attention.

A markup sheet is visually noisy: room names, dimensions, codes, symbols. The few lines that matter can disappear inside the clutter. While an expert can instantly filter this, a team member facing language barriers or tight deadlines may struggle to prioritize critical notes within a complex visual environment.

I learned a simple rule: If the solution requires the production team to open a heavy document to find their tasks, the system will fail.

We designed a workflow for the masses, not for “ideal” teams. A workflow where:

  • Nobody has to scan full drawings to find their work.
  • Nobody has to “hunt” for intent.
  • Nothing is “closed” without visual proof.

The “Comments Queue” Method

What it solves

  • Missed “Approved with Comments” items.
  • Hidden drift between client intent and team execution.
  • Over-reliance on “tribal knowledge” or a single fluent coordinator.
  • Weak closure (people saying “done” without evidence).

The Setup

Use the tools the team already opens daily: Teams or Google Chat. Create one dedicated project space: #comments-queue.

The Only Rule: If data has comments, it must become a short task message with proof. No task message, no closure.

The 3-Message Workflow

1) POST (Coordinator)

Every comment cloud becomes one thread. Format:

[Project] | [Drawing No/Rev] | [Sheet] | [Cloud-ID] (Paste screenshot snip of the comment area) Instruction: (One line, translated if necessary)
Owner: @Name (e.g. based on workset ownership or zone) Risk: GREEN / YELLOW / RED

Note: If the instruction is unclear or the sentence is longer than 10 words, default to RED. This protects the coordinator from “guessing” complex language.

2) DONE (Implementer)

The owner replies in the same thread:

✅ Done (Paste proof screenshot of the updated model/detail/view)

3) CLOSE (Checker)

Coordinator verifies and replies:

Closed ✅

The RED Rule (The Fluency Gate)

While GREEN items (general notes/approvals) and YELLOW items (tagging/naming) are straightforward, a comment is RED if it contains any of the following “High-Risk” markers:

  • Numbers/Units: mm, cm, m, degrees, %.
  • Specific Directions: relocate, move, shift, align, centre.
  • Compliance: as per CAD, as per detail, code, Civil Defense.
  • Constraints: must, ensure, do not, clearance, access.
  • Ambiguity: Punctuation marks like ? or !.

RED items require one extra step: The coordinator must tag a fluent reviewer for a final “OK” before closing.

Why this works

  • Visible Queue: It turns “hidden effort” into a transparent list.
  • Accountability: The owner tag and proof snip are public.
  • Minimalism: It reduces interpretation to one line, not paragraphs.
  • Audit Trail: “Approved with Comments” no longer means “Approved and Forgotten.”

Leveraging AI: The “BIM-Aware” Prompt

To speed this up, we use LLMs to act as the first-pass filter.

The Prompt:

Act as a BIM Coordinator. Translate the following client markup comment into [Target Language] as a one-line execution instruction for a Revit Modeler.

  1. RISK EVALUATION:

  • RED: If it involves dimensions, slope, coordinates, clearances, “as per”, or “relocate”.

  • YELLOW: If it involves tagging, naming, or parameters.

  • GREEN: General notes/Approvals.

  1. PRESERVATION: Keep all numerical values, units, and references (e.g., “Sheet A-101”) exactly as written.
  2. FORMAT: One-line instruction + Risk Level + Type of Proof Required (e.g., 3D Section Box).

The Endgame: The Nexus Coordination Agent

The most reliable way to scale this is automation. I am currently prototyping a custom AI agent to remove the “Coordinator Bottleneck.”

The agent reads the PDF markup via OCR, maps the sheet number to the Revit view, generates the instruction using our logic, and auto-routes the task to the #comments-queue by tagging the Workset owner.

Status: Alpha testing. The goal isn’t just to work faster—it’s to ensure that intent survives the machine.

Download Comments Queue Framework (PDF) →