Overview
The drawing-control skill is the central nervous system for managing construction drawings in Foreman OS. It tracks every revision, incorporates Architect/Engineer directives (ASIs), flags superseded sheets, and ensures the field works from the current set. Drawing management directly impacts quality, safety, cost, and schedule — this skill prevents costly rework by controlling the flow of information from the A/E to the field.
Core Responsibilities
- Revision Tracking: Maintain complete drawing log with revision history, dates, and change descriptions
- ASI Processing: Automatically update affected sheets when directives are received; flag superseded revisions
- Current Set Verification: Generate discipline-based reports of the latest drawing revision for every sheet
- Field Audit: Compare physical field sets against digital log; alert on out-of-date usage
- Distribution Control: Track which team members received which revision and when
- Change Summary: Extract revision cloud data and summarize deltas between revisions
- Integration Pipeline: Feed current drawing data to RFI prep, daily reports, submittals, and look-ahead planning
1. Drawing Log Data Model
The drawing-control skill stores all drawing metadata in a JSON schema. This provides a single source of truth for the project's drawing package.
JSON Schema
{
"project_id": "string (e.g., MOSC-825021)",
"project_name": "string",
"drawing_log_version": "1.0.0",
"last_updated": "ISO 8601 timestamp",
"updated_by": "string (user name)",
"drawings": [
{
"drawing_id": "string (unique, e.g., A-101-001)",
"sheet_number": "string (e.g., A-101)",
"title": "string",
"discipline": "string (Arch | Struct | Civil | Mech | Elec | Plumb | Fire | General)",
"current_revision": "string (e.g., Rev 2)",
"revision_date": "ISO 8601 date",
"revision_history": [
{
"revision": "string (e.g., Rev 0, Rev 1, Rev 2)",
"date": "ISO 8601 date",
"received_from": "string (e.g., Smith Architects, LLC)",
"description": "string (change summary)",
"asi_number": "string or null (e.g., ASI-001)",
"revision_clouds": {
"summary": "string (brief description of changed areas)",
"grid_locations": ["string (e.g., Grid 3/B-C, Zone North)"],
"change_type": "string (minor | moderate | major)"
}
}
],
"date_received": "ISO 8601 date",
"date_distributed": "ISO 8601 date",
"distribution_list": [
{
"recipient": "string (person or firm name)",
"role": "string (Super | PM | Foreman | Sub | Vendor | Other)",
"date_sent": "ISO 8601 date",
"method": "string (email | printed | file_share | in_person)",
"confirmed_receipt": "boolean",
"receipt_date": "ISO 8601 date or null"
}
],
"superseded_revisions": [
{
"revision": "string",
"marked_void_date": "ISO 8601 date",
"reason": "string (e.g., ASI-001 superseded, newer revision issued)"
}
],
"status": "string (current | superseded | void | archived)",
"file_reference": "string (path to drawing file, e.g., '/drawings/A-101-Rev2.pdf')",
"file_size_mb": "number",
"total_sheets": "number (if multi-sheet drawing)",
"notes": "string (any additional context)",
"linked_submittals": ["string (submittal numbers referencing this drawing)"],
"linked_rfi": ["string (RFI numbers referencing this drawing)"]
}
],
"summary": {
"total_drawings": "number",
"total_sheets": "number",
"disciplines": {
"Arch": "number",
"Struct": "number",
"Civil": "number",
"Mech": "number",
"Elec": "number",
"Plumb": "number",
"Fire": "number",
"General": "number"
},
"revisions_in_circulation": "number",
"void_sheets": "number"
}
}
2. ASI Processing Workflow
When the Architect or Engineer issues a Supplemental Instruction (ASI), the drawing-control skill manages the intake, revision updates, and distribution.
ASI Receipt & Processing Steps
- Receive ASI → Capture ASI number, date received, engineer/architect name
- Identify Affected Sheets → Parse ASI document to extract sheet numbers impacted
- Update Revision Numbers → Increment revision (Rev 0 → Rev 1, etc.) for each affected sheet
- Mark Superseded → Flag previous revisions as superseded with ASI reference
- Extract Change Summary → If revision clouds are present, summarize deltas
- Cross-Reference ASI Log → Update project-config.json ASI table with drawing link
- Generate Distribution Notice → List which sheets changed and who needs new copies
- Queue Automatic Re-distribution → Trigger notifications to field team
ASI Tracking Table Template
| ASI # | Date Received | Issued By | Sheets Affected | Description | Status | Distribution Complete | Notes |
|-------|---------------|-----------|-----------------|-------------|--------|------------------------|-------|
| ASI-001 | 2026-01-15 | Smith Architects | A-101, A-102, A-103 | Floor plan revisions for door swing conflicts | Distributed | 2026-01-16 | All field copies updated |
| ASI-002 | 2026-02-05 | Yeiser Structural | S-201, S-202 | Anchor bolt layout modifications | Distributed | 2026-02-06 | Confirmed with steel sub |
| ASI-003 | 2026-02-18 | Davis HVAC | M-101, M-102 | Equipment substitution | Pending | - | Awaiting drawings from vendor |
ASI-to-Revision Mapping
When an ASI requires drawing revisions, the mapping below ensures consistency:
{
"asi_number": "ASI-001",
"date_received": "2026-01-15",
"drawings_affected": [
{
"sheet_number": "A-101",
"previous_revision": "Rev 0",
"new_revision": "Rev 1",
"description": "Door swing and furniture layout corrections"
},
{
"sheet_number": "A-102",
"previous_revision": "Rev 0",
"new_revision": "Rev 1",
"description": "Door swing and furniture layout corrections"
}
],
"distribution_initiated": "2026-01-16",
"distribution_complete": true
}
3. Current Set Verification
The drawing-control skill generates on-demand reports showing the latest revision of every sheet in the project.
Current Set Report (By Discipline)
Command: /drawings status
Sample output:
╔════════════════════════════════════════════════════════════════════════════╗
║ CURRENT DRAWING SET — 2026-02-19 ║
╚════════════════════════════════════════════════════════════════════════════╝
ARCHITECTURAL (7 sheets)
A-101 Floor Plan Rev 1 2026-01-15 Distributed ✓
A-102 Reflected Ceiling Plan Rev 0 2025-12-10 Distributed ✓
A-103 Door & Hardware Schedule Rev 1 2026-01-15 Distributed ✓
A-201 Exterior Elevations - North/South Rev 0 2025-12-10 Distributed ✓
A-202 Exterior Elevations - East/West Rev 0 2025-12-10 Distributed ✓
A-301 Sections & Details (1 of 2) Rev 0 2025-12-10 Distributed ✓
A-302 Sections & Details (2 of 2) Rev 0 2025-12-10 Distributed ✓
STRUCTURAL (6 sheets)
S-001 Foundation Plan & Details Rev 0 2025-12-10 Distributed ✓
S-101 Framing Plan - Level 1 Rev 0 2025-12-10 Distributed ✓
S-201 Anchor Bolt Schedule Rev 1 2026-02-06 Distributed ✓
S-202 Connection Details Rev 1 2026-02-06 Distributed ✓
S-301 Roof Framing Plan Rev 0 2025-12-10 Distributed ✓
S-302 Roof Details Rev 0 2025-12-10 Distributed ✓
CIVIL (5 sheets)
C-001 Site Plan & Utilities Rev 0 2026-01-20 Distributed ✓
C-101 Grading & Drainage Plan Rev 0 2026-01-20 Distributed ✓
C-102 Utility Plans - Water/Sewer Rev 0 2026-01-20 Distributed ✓
C-201 Stormwater & Detention Rev 0 2026-01-20 Distributed ✓
C-301 Landscape & Hardscape Rev 0 2026-01-20 Distributed ✓
MECHANICAL (4 sheets)
M-001 HVAC System Diagram Rev 0 2025-12-10 Distributed ✓
M-101 HVAC Plans - Level 1 Rev 0 2025-12-10 Distributed ✓
M-102 Equipment Schedule & Details Rev 0 2025-12-10 Distributed ✓
M-103 Ductwork Details Rev 0 2025-12-10 Distributed ✓
PLUMBING (3 sheets)
P-001 Plumbing System Diagram Rev 0 2025-12-10 Distributed ✓
P-101 Plumbing Plans - Level 1 Rev 0 2025-12-10 Distributed ✓
P-102 Fixture Schedule & Details Rev 0 2025-12-10 Distributed ✓
ELECTRICAL (4 sheets)
E-001 Power & Lighting Diagram Rev 0 2025-12-10 Distributed ✓
E-101 Power Plans - Level 1 Rev 0 2025-12-10 Distributed ✓
E-102 Lighting Plans - Level 1 Rev 0 2025-12-10 Distributed ✓
E-103 Panel Schedules & Details Rev 0 2025-12-10 Distributed ✓
FIRE PROTECTION (2 sheets)
FP-001 Fire Alarm & Detection Plan Rev 0 2025-12-10 Distributed ✓
FP-102 Fire Protection Details Rev 0 2025-12-10 Distributed ✓
GENERAL (1 sheet)
G-001 Title Sheet & General Notes Rev 0 2025-12-10 Distributed ✓
SUMMARY
Total Drawings: 32 sheets
Revisions: Rev 0: 26 sheets | Rev 1: 6 sheets
Distribution: 100% complete
Void/Superseded: 0 sheets
Last Update: 2026-02-06 (ASI-002 revisions)
Field Set Audit
Command: /drawings audit
This command compares field documentation (daily reports, RFI submittals, payment apps) against the current drawing log and alerts on any references to superseded revisions.
Field Set Audit Results — 2026-02-19
✓ Scan completed: 7 daily reports, 3 RFIs, 2 submittals analyzed
⚠ 1 ISSUE FOUND:
Daily Report (2026-02-18) references S-202 Rev 0
ALERT: Current revision is S-202 Rev 1 (issued 2026-02-06 per ASI-002)
Action: Notify crew to use latest revision from trailer/SharePoint
Issued to: Walker Construction
4. Revision Cloud Summary
When new drawing revisions are received, the drawing-control skill extracts and summarizes revision cloud data (if available in PDFs).
Revision Delta Extraction
{
"drawing_id": "A-101-001",
"sheet_number": "A-101",
"comparison": {
"from_revision": "Rev 0",
"to_revision": "Rev 1",
"change_date": "2026-01-15",
"change_summary": "Door swing corrections in Patient Rooms A-101, A-102. Furniture layout adjusted to ADA path of travel. Casework dimensions verified per Stidham quote.",
"revision_clouds": [
{
"location": "Grid 3/B-C (Patient Room 101)",
"description": "Door swing corrected from inward to outward swing; casework depth reduced 6 inches",
"change_type": "major"
},
{
"location": "Grid 4/C-D (Patient Room 102)",
"description": "Door swing reversed; ADA clearance verified",
"change_type": "moderate"
},
{
"location": "Grid 2/A-B (Corridor)",
"description": "Furniture layout clarification; no dimension changes",
"change_type": "minor"
}
],
"affected_systems": ["Doors", "Casework", "Layout"],
"impact_assessment": "Affects EKD (drywall/framing) and Stidham (casework) scope. Review with subs before framing."
}
}
5. Drawing Distribution Log
The drawing-control skill tracks who received which revision and when, providing accountability and re-distribution triggers.
Distribution Log Entry
{
"sheet_number": "A-101",
"revision": "Rev 1",
"distribution_round": 1,
"date_distributed": "2026-01-16",
"distribution_list": [
{
"recipient": "W Principles (Super - Miles Goodman)",
"role": "Super",
"method": "email",
"date_sent": "2026-01-16",
"email": "miles.goodman@wprinciples.com",
"confirmed_receipt": true,
"receipt_date": "2026-01-16"
},
{
"recipient": "Andrew Eberle (PM)",
"role": "PM",
"method": "email",
"date_sent": "2026-01-16",
"email": "andrew.eberle@wprinciples.com",
"confirmed_receipt": true,
"receipt_date": "2026-01-16"
},
{
"recipient": "EKD (Drywall/CFS Sub - Foreman)",
"role": "Sub",
"method": "email",
"date_sent": "2026-01-16",
"email": "foreman@ekd-drywall.com",
"confirmed_receipt": false,
"receipt_date": null
},
{
"recipient": "Stidham Cabinets (Casework Sub)",
"role": "Sub",
"method": "email",
"date_sent": "2026-01-16",
"email": "office@stidhamcabinets.com",
"confirmed_receipt": true,
"receipt_date": "2026-01-17"
}
],
"re_distribution_required": false,
"notes": "ASI-001 revision; follow-up call made to EKD on 2026-01-17 to confirm receipt."
}
Automatic Re-distribution Triggers
The skill automatically initiates re-distribution when:
- New revision issued for a sheet already in circulation
- ASI affects multiple sheets in one directive
- Field reports reference superseded revision
- Submittal review flagged a drawing as outdated
6. As-Built Drawing Integration
When processing as-built or record drawings, the drawing-control skill connects revision tracking data to the closeout documentation pipeline. As-built markups must be reconciled against the current revision of every sheet before project closeout can be certified.
As-Built Data Source
Read plans-spatial.json → as_built_overlay
Per-Sheet As-Built Tracking
Track as-built markup status per sheet in drawing-log.json → as_built_status[]. For each drawing sheet, record the following fields:
| Field | Type | Description |
|---|---|---|
as_built_markup |
string | Status: none, in-progress, or complete |
deviations_count |
number | Total deviations from the issued-for-construction drawing |
markup_by |
string | Name of person who marked up the as-built |
markup_date |
ISO 8601 date | Date the as-built markup was completed |
reviewed_by |
string | Name of person who reviewed the as-built markup |
review_date |
ISO 8601 date | Date the review was completed |
Revision Cross-Reference
Cross-reference as-built deviations against the current revision of each sheet — deviations should reference the latest revision number. If a sheet has been revised via ASI since the last as-built markup, the markup must be re-verified against the new revision before it can be marked complete.
Deviation Cause Linkage
Link deviation causes to upstream change documentation:
- RFI-directed changes →
rfi-log.json(deviations that resulted from RFI responses or field clarifications) - CO-directed changes →
change-order-log.json(deviations that resulted from approved change orders)
This linkage ensures every as-built deviation is traceable to its authorization source.
Closeout Completeness Check
Flag sheets where as-built markup is still none or in-progress as closeout-incomplete. These sheets must be resolved before the drawing package can be submitted for final owner acceptance. The /drawings status report should include an as-built completeness column during the closeout phase.
Reference
For detailed as-built data extraction rules, see document-intelligence/references/as-built-extraction.md.
Extended reference: Detailed examples, templates, scoring rubrics, and best practices are in
references/skill-detail.md.