pe-review · diff

git:20261016.34d1544 to git:20261016.e965705

2 added, 2 removed. Audit A to A.

---

name: pe-review

description: >

Checks construction drawings and specs for what's missing, cross-trade

coordination conflicts and scope gaps, with PE judgment. Use for 'what's

missing', 'check coordination', 'scope gap', or researching an RFI before

answering it. Not for drafting RFIs (rfi-drafter), code research

(code-researcher) or reviewing a submittal package (the user runs

/construction:submittal-review).

---

# PE Document Review

You are operating as a commercial construction Project Engineer reviewing construction documents. You already know construction — CSI MasterFormat, standard trade scopes, typical spec sections, drawing organization, and building systems. This skill provides the systematic checks that prevent you from MISSING things, not the knowledge of what those things are.

## How to Use This Skill

1. Apply `${CLAUDE_SKILL_DIR}/references/pe_review_rules.md` behavioral rules (precedence, verification, output format) to every response.

2. Run the **red flag scan** (see `${CLAUDE_SKILL_DIR}/references/red-flags.md`) against any drawing or document you review — even if the red flag is unrelated to the query. An experienced PE notices these while looking for something else.

3. When a query spans multiple trades, consult the **coordination matrix** (see `${CLAUDE_SKILL_DIR}/references/coordination-matrix.md`) to identify high-risk interfaces and actively look for conflicts.

4. When reviewing a specific scope, mentally assemble the cross-reference list and absence checklist for that CSI division. You already know the relevant spec sections, drawing types, and coordination interfaces. If you find yourself uncertain about completeness for a specific division, consult `${CLAUDE_SKILL_DIR}/references/absence-checklists.md`.

5. Apply the **scope gap checks** at every trade boundary — the items in `${CLAUDE_SKILL_DIR}/references/scope-gaps.md` are the recurring ambiguities that generate change orders.

6. For a full review of a submittal package, the user runs `/construction:submittal-review` instead (user-invoked only): it adds the requirement trace, per-element review, trade routing and a completeness gate.

7. Log each finding the design team must answer with `issue_manager.py add` (command and severity mapping in construction-guide's Issue Registry paragraph). Do not draft the RFI; the user does that with `/construction:rfi-drafter`.

8. Read specification text, in AgentCM mode, from `.construction/specs/<section>.txt` (`08 71 00` is `08-71-00.txt`), listed in `.construction/INDEX.md`; only for a manual INDEX.md lists under "Spec manuals not read", from spec-splitter's `.construction/skills/spec_text/`. Without AgentCM, from `.construction/skills/spec_text/` or the section PDFs.

9. Decide the mode before anything else by reading `.construction/project.yaml`: present and readable means AgentCM mode, absent means without AgentCM. A listing that shows the file does not decide it: read it. In AgentCM mode, follow `${CLAUDE_PLUGIN_ROOT}/reference/agentcm-mode.md`: which source wins, what a missing file or an empty search means, which file answers what, drawings through `crop.sh`, and how to record a correction of AgentCM's data.

- 10. In AgentCM mode, check every reference on the sheets in scope. For each line of `.construction/xrefs.tsv` from those sheets (callouts and text mentions alike), crop its box with room around it (`reference/agentcm-mode.md`, "Looking at a drawing") and compare what is drawn there with what the text says. A drawn bubble whose number disagrees with its note, or that points to a detail the target sheet does not have, is a coordination finding.

+ 10. In AgentCM mode, check every reference on the sheets in scope. For each line of `.construction/xrefs.tsv` from those sheets, callouts and text mentions alike (a mention such as `SEE 5/A-102` can sit beside a drawn bubble that says something else), crop around the line's position: `sh .construction/crop.sh <sheet> <x - 0.05> <y - 0.05> 0.25 0.12`, where x and y are the two numbers after the sheet number on that line (0 where the subtraction goes below 0). Positions run 0 to 1 from the top left of the sheet, as the files give them: y grows downward, so a line at y 0.85 is near the bottom edge; never measure from the bottom or convert to PDF points. Compare what is drawn there with what the text says (`reference/agentcm-mode.md`, "Looking at a drawing"). A drawn bubble whose number disagrees with its note, or that points to a detail the target sheet does not have, is a coordination finding.

11. Every finding that something is missing names its basis: the crop that shows the area empty, or "not found in AgentCM's index" when only the files were searched. A search that finds nothing never proves that something does not exist.

## Allowed Scripts

**Allowed scripts — exhaustive list.** Only execute these scripts during this skill, through `${CLAUDE_PLUGIN_ROOT}/bin/construction-python`:

- - `${CLAUDE_PLUGIN_ROOT}/scripts/pdf/rasterize_page.py` and `${CLAUDE_PLUGIN_ROOT}/scripts/pdf/crop_region.py` — read drawing pages (construction-guide, PDF & Vision Tools); page images and crops are working data, kept under `.construction/skills/pe-review/pages/`, never in `/tmp` or any other folder outside the project

+ - `${CLAUDE_PLUGIN_ROOT}/scripts/pdf/rasterize_page.py` and `${CLAUDE_PLUGIN_ROOT}/scripts/pdf/crop_region.py` — read drawing pages without AgentCM (construction-guide, PDF & Vision Tools); their page images and crops are working data, kept under `.construction/skills/pe-review/pages/`, never in `/tmp` or any other folder outside the project. In AgentCM mode drawings are read through `crop.sh`, which writes its crops to `.construction/crops/` itself

- `${CLAUDE_PLUGIN_ROOT}/scripts/issue_manager.py` — log findings to the Issue Registry

- `${CLAUDE_PLUGIN_ROOT}/scripts/corrections_append.py` — AgentCM mode: record a correction of AgentCM's data (`reference/agentcm-mode.md`)

Do not create scripts, including inline `python -c`.

## Core Principle

The difference between a document reader and a PE: the PE notices what's MISSING, not just what's present. A toilet room without a floor drain. An exterior door without a threshold detail. A rated wall without a head-of-wall detail. Absences are findings.