1. Home
  2. Help
  3. Engines
  4. Punch List Drafter
Field · Engine

Punch List Drafter

Punch List Drafter is the engine that turns a closeout walk into structured punch items. From the walk's voice recording and photos it drafts each item with a title, location, trade, priority, target close date, photo evidence and a quote from the walk, and checks for duplicates against the open list before anything is logged.

Engine Phase: During construction Runtime: 20-40 seconds Pro+

What does the Punch List Drafter do?

Punch List Drafter takes the raw output of a closeout walk — a voice recording and the photos taken along the way — and produces structured punch items ready to log. Each extracted item gets a title, location, trade assignment, priority, target close date, the photo(s) attached as evidence, and a quote from the walk where it was discussed.

The engine runs trigram-similarity dedupe against existing open items on the project before logging anything new. Walking the same Level 3 East twice in three days no longer creates duplicate punch items — when the engine recognizes that "loose carpet seam at Room 305" matches an existing open item, it skips the new one and lists it as a duplicate.

When should I use the Punch List Drafter?

Use Punch List Drafter for the pre-substantial-completion walk, to turn an owner's or architect's call-outs into structured items without retyping, and after rework to capture the remaining items and merge them with the existing list.

Drafted items are saved when the run finishes

Every drafted item is saved in the Punch List tracker as an open item, assigned to whoever ran the draft, with the company picked from your vendor directory by trade and a due date set from the target close days. An item that is a near-certain duplicate of an open one is skipped and listed. There is no separate filing step.

What do I upload to the Punch List Drafter?

Two inputs: the voice recording from the walk (browser capture or upload) and the photos taken on the walk (uploaded with location tags). The engine cross-references the voice timeline with the photo timestamps to attach the right photos to each item.

Optional: a floor plan with room numbers (sharpens location attribution), the existing open punch list (forces dedupe explicitly), and the walking-party attendee list (improves attribution if the engine cites who called out an item).

How do I run the Punch List Drafter?

To run Punch List Drafter, open it, upload the walk audio and the photos, run the draft, review the drafted items and the duplicates, and open them in the Punch List tracker. The run saves the items; there is no filing step.

  1. Open the engine

    Sidebar → Engines → Punch List Drafter.

  2. Upload the walk audio

    Browser-recorded or uploaded file. MP3 / M4A / WAV preferred.

  3. Upload the photos

    Drop the photos taken during the walk into project_media if not already there. Location tags + timestamps help the engine align them with the audio timeline.

  4. Run draft

    20–40 seconds.

  5. Review the drafted items

    Each row shows title, location, trade, priority, target close date, photo evidence, and the quote from the walk.

  6. Check the duplicates

    Items that match an existing open item are marked. A near-certain duplicate is skipped and not saved; a possible duplicate is saved and marked so you can compare it.

  7. Open the saved items

    The items were saved in the Punch List tracker when the run finished. Click Open in Punch List to see them, and change or reassign them there.

How do I read the Punch List Drafter results?

The result is a list of drafted items with a trade assignment, photo evidence and a quote from the walk for each, plus a dedupe report and a walk summary.

Drafted item list

One row per identified deficiency. Title, location, trade, priority, target close, photo evidence, walk quote.

Trade assignment

Engine infers the responsible trade from the item description (e.g., "loose carpet seam" → flooring sub). Override if needed.

Photo evidence

Each item links to the photo(s) taken on the walk that depict it. Click to preview.

Walk quote

The verbatim line from the audio where the item was called out. Anchored to the audio moment for verification.

Dedupe report

Drafted items that match existing open items, marked on the item card. A near-certain duplicate is skipped and not saved; a possible duplicate is saved and marked.

Walk summary

One-paragraph overview of the walk: who was present, areas covered, total items found, severity breakdown.

Every control, explained

Run draft

Consumes one run. 20–40 seconds.

Open in Punch List

Opens the Punch List tracker, where the drafted items were already saved when the run finished. Change or reassign them there.

Re-run

Runs the draft again. It consumes another run.

Export PDF

Walk-report PDF with the drafted items. Useful when the walking party wants a copy.

Sources