Drawing Control Skill — Foreman OS

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

1. Receive ASI → Capture ASI number, date received, engineer/architect name
2. Identify Affected Sheets → Parse ASI document to extract sheet numbers impacted
3. Update Revision Numbers → Increment revision (Rev 0 → Rev 1, etc.) for each affected sheet
4. Mark Superseded → Flag previous revisions as superseded with ASI reference
5. Extract Change Summary → If revision clouds are present, summarize deltas
6. Cross-Reference ASI Log → Update project-config.json ASI table with drawing link
7. Generate Distribution Notice → List which sheets changed and who needs new copies
8. 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": "[email protected]",
      "confirmed_receipt": true,
      "receipt_date": "2026-01-16"
    },
    {
      "recipient": "Andrew Eberle (PM)",
      "role": "PM",
      "method": "email",
      "date_sent": "2026-01-16",
      "email": "[email protected]",
      "confirmed_receipt": true,
      "receipt_date": "2026-01-16"
    },
    {
      "recipient": "EKD (Drywall/CFS Sub - Foreman)",
      "role": "Sub",
      "method": "email",
      "date_sent": "2026-01-16",
      "email": "[email protected]",
      "confirmed_receipt": false,
      "receipt_date": null
    },
    {
      "recipient": "Stidham Cabinets (Casework Sub)",
      "role": "Sub",
      "method": "email",
      "date_sent": "2026-01-16",
      "email": "[email protected]",
      "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:

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.