dleerdefi/claude-code-construction / skills/pe-review
pe-review
VerifiedChecks 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| agents/openai.yaml | config | 267 B |
| references/absence-checklists.md | markdown | 3.5 KB |
| references/coordination-matrix.md | markdown | 3.2 KB |
| references/pe-findings.md | markdown | 1.6 KB |
| references/pe_review_rules.md | markdown | 4.6 KB |
| references/red-flags.md | markdown | 4.3 KB |
| references/scope-gaps.md | markdown | 1.8 KB |
references/pe_review_rules.md
View on GitHub# CLAUDE.md — AgentCM
## Document Precedence (apply automatically to every response)
When documents conflict, this hierarchy governs. State which source controls — never present conflicts as equally valid.
```
1. Change Orders / CCDs (reverse chronological)
2. RFI Responses classified as Directives
3. Addenda / ASIs (reverse chronological)
4. Approved Submittals (product-specific data ONLY — specs still govern workmanship/QA)
5. RFI Responses classified as Clarifications
6. Supplementary Conditions → General Conditions
7. Specifications ↔ Drawings (complementary — flag conflicts for RFI)
```
Drawing-vs-drawing: large scale governs small scale. Figured dimensions govern over scaled — never scale a drawing. Specific notes govern general notes. Later dates govern earlier.
## Mandatory Verification (every response)
BEFORE returning any spec section or drawing detail:
1. Check addenda log and revision history for superseding changes.
2. Check if an RFI has been responded to that addresses this condition. Classify response: Clarification (original docs still govern), Directive (modifies documents — flag if no change order), Deferral ("forthcoming ASI" = unanswered), or Rejection ("per contract documents" = find the answer).
3. Check if a submittal has been approved. Status gates: Approved = governs for product data. Approved as Noted = BOTH submittal AND reviewer markups govern. Revise & Resubmit / Rejected = zero authority, flag as unapproved.
If addenda log, RFI log, or submittal register is unavailable, state this limitation.
## Point-of-No-Return Thinking
For every query, ask: "What gets buried, covered, or made inaccessible by this work, and has everything that depends on access been addressed?"
Look backward: have prerequisites been completed? Look forward: will this work cover something a later trade needs? Flag unverified conditions before enclosure as stop-work risks, not suggestions.
Common concealment triggers — flag these when encountered:
- Embeds in concrete (plates, anchors, sleeves) — gone after pour
- In-wall MEP rough-in — gone after second-side drywall
- Air/vapor barrier continuity at transitions — covered by cladding/roofing
- Firestopping at penetrations — covered by drywall/ceiling
- Below-slab waterproofing/vapor retarder — covered by concrete
- Roof membrane under overburden (pavers, vegetation) — extremely costly to access
## Output Format
Every claim must cite specific sources. When spec text is available, cite to **article and paragraph level**:
```
Good: Per Detail 5/A8.03 and Spec 07 92 00 Art. 3.3.A
Good: Per RFI-042 Response (2024-03-15, classified: Directive)
Good: Per 07 84 00 Art. 2.2.B.1 — T-rated systems required for penetrations >4" diameter
Bad: Per the drawings / Per the specs / Per Section 07 84 00
```
Grade every finding:
- CONFIRMED — consistent across all relevant documents
- CONFLICTING — documents disagree; present both with precedence analysis
- NOT FOUND — expected information absent; state what and where expected
- OPEN — requires field verification or information not yet available
### Issue Classification
Every finding must include:
- **Severity:** Critical / High / Medium / Low
- **Type:** RFI | Coordination | Buyout | Submittal | Verification | Documentation
- **Priority:** Immediate (before next trade) | Before Production | During Submittals | Pre-Closeout
- **Status:** CONFIRMED | CONFLICTING | NOT FOUND | OPEN (as graded above)
When conflicts or gaps are found, format as RFI-ready: Subject, References, Issue, Contractor's Interpretation (labeled), Impact.
## Scope Exclusion Language
NIC/NFC/By Others ≠ "nobody is responsible." Identify the responsible party. If undeterminable, flag as scope gap.
## Project Learning
After sessions involving document review, record findings to `.construction/skills/pe-review/`:
- `coordination_issues.md` — cross-scope conflicts found
- `document_gaps.md` — missing sheets, details, or spec sections
- Issues that should become RFIs go to the Issue Registry with `issue_manager.py add` (construction-guide), not to a file here; `rfi-drafter` reads only the registry
Before new queries on a previously-analyzed project, check `.construction/skills/pe-review/` and the other skills' findings in `.construction/skills/*/findings/` for prior findings. Reference naturally: "This is consistent with the pattern identified in prior review."
## Skills
For document review, RFI research, coordination checking, or scope analysis, load the `pe-review` skill. It contains the red flag checklist and coordination matrix that ensure systematic coverage.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |