Create Site Visit Report
Write a field observation report with photos
Once installed, type /create-site-visit-report in Claude Code to run it.
Install just this one
Run in your terminal — needs Node
npx archtmpl@latest --command create-site-visit-report --globalFirst time? The whole install, step by step
- Open Claude Code — the terminal version or the desktop app, either one.
- In a terminal, paste the line above and press Enter. In the app, paste it into the chat and ask Claude to run it.
- Restart Claude Code. That's the whole install.
One paste — no Node, installs just this command
Set up plugins for me: run `claude plugin marketplace add https://archaiflow.com/plugins/marketplace.json` and then `claude plugin install create-site-visit-report@archaiflow`Paste into the Code tab (not Chat or Cowork) and approve when Claude asks. The third-party marketplace it mentions is this site. Windows may ask to install Git once.
What this command does
Create Site Visit Report
Document an architect's site visit per AIA B101 §3.6.2 — observations of work in progress, conformance with contract documents, photos, and any issues raised. Output is Markdown that renders to Word (.docx) so photos embed and the AOR can sign.
Input you need
Before drafting, gather:
- Project name and project number.
- Date of visit in
Month DD, YYYY. - Time on site (arrival → departure, with zone).
- Weather — temperature (°F), conditions, precipitation, wind.
- Author — AOR representative on site (name, role, firm).
- Other attendees — Owner, CM, GC, subs, consultants (name, firm).
- Areas observed — specific locations / floors / scopes (e.g.,
Level 3 east wing — drywall and MEP rough). - Observations — what was seen. For each: location, description, photo references (optional), conformance status (
Conforming/Non-conforming/Observation only), spec/drawing reference if applicable. - Action items — issues raised, owner, due date.
- Photos — file paths or descriptions; will embed in Word output.
If any of the above is missing or ambiguous, ask the user before drafting. Do not invent observations, dimensions, or attendees.
Output structure
# Site Visit Report
**Project:** [Name] (Project No. [######])
**Date:** [Month DD, YYYY]
**Time on site:** [HH:MM AM/PM ET → HH:MM AM/PM ET]
**Weather:** [°F, conditions]
**Visit by:** [AOR rep name, role, firm]
**Per:** AIA B101 §3.6.2
---
## Attendees
| Name | Firm | Role |
|------|------|------|
| ... | ... | ... |
## Areas Observed
- [Level / scope / location 1]
- [Level / scope / location 2]
---
## Observations
### Obs. 1 — [Location]
**Description:** [what was seen]
**Conformance:** [Conforming / Non-conforming / Observation only]
**Reference:** [drawing / spec section, or `—`]
**Photo:** [filename or description, or `—`]
### Obs. 2 — [Location]
...
---
## Action Items
| # | Item | Owner | Due | Status |
|---|------|-------|-----|--------|
| 1 | ... | Name, Firm | YYYY-MM-DD | Open |
---
## Authorization Limit (AIA B101 §3.6.2.1)
The architect's site visits do not constitute exhaustive or continuous on-site inspection. Observations are limited to general conformance with the contract documents. The architect is not responsible for the contractor's means, methods, sequences, procedures, or for safety precautions in connection with the work.
---
**Signed:** [AOR PIC]
**Date:** [Month DD, YYYY]
NA AEC conventions
- English only. No Hangul.
- Imperial-first units (
ft,in,sf,°F); metric in parens only. - Dates use
Month DD, YYYYin cover; ISOYYYY-MM-DDacceptable in tables. - Time zones explicit (
ET / CT / MT / PT). - Roles —
AOR,Owner,CM,GC,MEP Engineer,SE, sub-trades by trade name (Drywaller,Steel erector). NeverDirectoras a project role. - AIA reference —
AIA B101 §3.6.2(site visits),§3.6.2.1(limitation of architect's responsibility). - AHJs — name specifically when observations implicate code interpretation (
NYC DOB,LADBS,DSA,FDNY). - Floor labels —
Level 3/L3/3rd floor. Never3F. - Conformance terms — use
Conforming,Non-conforming,Observation onlyliterally; do not paraphrase.
Constraints
- Do not fabricate observations, dimensions, or attendees. If the user provides a one-line summary, surface gaps as questions rather than embellishing.
- The B101 §3.6.2.1 authorization-limit boilerplate must remain verbatim — it is the contractual scope of the architect's site presence and removing it expands liability.
- Photos: in Markdown, reference by filename or description; in Word output,
aec-doc-genembeds the image if a path is provided. - Word output requires the
aec-doc-gencompanion skill. If unavailable, output Markdown and instruct the user. - Non-conforming observations should reference the specific drawing or spec being violated, or be downgraded to
Observation only.
Workflow
- Echo back: project, visit date, areas observed count, observations count, non-conforming count. One line.
- If any required input is missing, list the gap and stop.
- Otherwise, produce the full report Markdown.
- If Word output was asked for, hand the Markdown to the
aec-doc-genskill and ask it for.docx, passing any photo paths so they are embedded rather than named. - After the draft, list items flagged for follow-up (TBD owners, photo references missing, non-conforming items without spec citation).